title | teaching | exercises | questions | objectives | keypoints | workshopOverviewName | workshopOverviewURL | lessonOverviewName | lessonOverviewURL | previousEpisodeName | previousEpisodeURL | nextEpisodeName | nextEpisodeURL | |||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Installation Prep |
0 |
15 |
|
|
|
COmanage Workshop: Managing Identities & Collaborations |
CO201 - Installing COmanage Using Docker Images |
../index.md |
2. Setting up variables |
/_episodes/02-setupVariables.md |
1. Installation Prep
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 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.
- SSH to the AWS bastion host by typing the following command:
$ 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.
- 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.
$ 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
- 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:
[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.)
[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,
[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
LESSON OVERVIEW: CO201 - Installing COmanage Using Docker Image
WORKSHOP OVERVIEW: COmanage Workshop: Managing Identities & Collaborations