01-prep.md

---
title: "Installation Prep"
teaching: 0
exercises: 15
questions:
- "Question here"
objectives:
- "List the objectives"
keypoints:
- "List the key takeaways for the episode"
workshopOverviewName: "COmanage Workshop: Managing Identities & Collaborations"
workshopOverviewURL: "https://github.internet2.edu/lpaglione/COmg-trainingOverview/blob/master/README.md"
lessonOverviewName: "CO201 - Installing COmanage Using Docker Images"
lessonOverviewURL: "../index.md"
previousEpisodeName:
previousEpisodeURL:
nextEpisodeName: "2. Setting up variables" 
nextEpisodeURL: "/_episodes/02-setupVariables.md"
---

# 1. Installation Prep

![Interactive system activity](/assets/img/hands-on-keyboard.png)

For this lesson, we will be installing COmanage from a Docker image onto a virtual machine that we have set up for this training. What you set up here will be available to you for 2 weeks after the workshop.

## VM & user assignments

We have prepared a [Workshop Reference Document](/files/handouts/CO201-01_WorkshopReferenceDocument.pdf) that you can use to record important information that you will need throughout the workshop. It contains two sections:

### SECTION A. Virtual Machine

This section allows you to record the number of the virtual machine that you have been assigned. 

* On line **2. Your VM**, record this number in the blank line. For example, if your number is '1', your VM will be `registry1-private`.
* On line **3. Your COmanage site**, also record the number on the blank line. For example, if your number is 1, your COmanage site (when up and running) will be found at https://registry1.comanage.incommontraining.training

### SECTION B. Your Persona

During this training you will be working with three different 'persona': a CMP (platform) Administrator, a CO Administrator, and a Regular User. Don't worry at the moment what these terms mean. Pinned to the Workshop Slack Channel (#comanage-temple) is a file that lists many users that will be available for signing into COmanage. Record the three users that correspond to your VM number, including their givenName, sn (surname), uid (unique identifier), and mail (email address).

You will also derive the ePPN for each user, which will be `givenName.sn`

## Passwords!

Also on this Document is the password that we will be using for the workshop. This password will be used for every instance where a password is needed.

## Sign into your virtual machine

You will be using SSH to sign into your virtual machine. If you run into challenges during this process, please put a yellow post-it note on your computer so that we can see that you need help. 

1. SSH to the [AWS bastion host](https://aws.amazon.com/blogs/security/tag/bastion-host/) by typing the following command:

``` console
$ ssh training@ssh.comanage.incommon.training
```

You will use the training session password when requested. As a reminder, you can find the password on the Workshop Reference Document.

2. Once on the bastion host, SSH into the virtual machine that you will be using for the workshop. Refer to the Workshop Reference Document to see the name of your virtual host. You will replace the letter 'N' in the command below, with the number for your virtual machine.

``` console
$ ssh registryN-private
```

> When you are ready to move on, put the blue post-it note on your computer so that we can make sure to not move forward before everyone is ready.

## Take a look at Docker

3. The docker files are already available to you, so you can run a few docker commands to check them. 

First we'll see what docker nodes are available:

``` console
[training@registry1-private ~]$ docker node ls
ID                            HOSTNAME                                       STATUS              AVAILABILITY        MANAGER STATUS      ENGINE VERSION
8tuwrbfdci97tfn9nqoinic0o *   registry1-private.comanage.incommon.training   Ready               Active              Leader              19.03.4
```

You can also see the list of containers that are available by running the docker ps command. (NOTE, there shouldn't be any Docker containers because we haven't set them up yet. This command will confirm that this is true.)

``` console
[training@registry1-private ~]$ docker ps
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
```

_**NOTE**: You can also use `sudo` without a password, but you probably will not need it in this session. For example,_

``` console
[training@registry1-private ~]$ sudo /usr/bin/whoami
root
```

> When you are ready to move on, put the blue post-it note on your computer so that we can make sure to not move forward before everyone is ready.

---

NEXT SECTION: [2. Setting up variables](/_episodes/02-setupVariables.md)

---

LESSON OVERVIEW: [CO201 - Installing COmanage Using Docker Image](../index.md)

WORKSHOP OVERVIEW: [COmanage Workshop: Managing Identities & Collaborations](https://github.internet2.edu/lpaglione/COmg-trainingOverview/blob/master/README.md)