COmanage VM Documentation

Release notes for version 1.0

A few words on VirtualBox

• If you are not familiar with VirtualBox, you can read the documentation and download the software from Oracle's web site.
• Once VirtualBox is installed and running, you import the .ovm distribution image using the File / Import Appliance function.
• The default network connection for the Virtual Machines is NAT. This will work well for the case of logging in and examing the VM and containers. To connect to services hosted by the VM from the outside, you'll likely want to switch the network to bridged mode. This will give the VM an IP address from your network's DHCP server and provide you with the ability to access services from a browser. Remember, if you are on a public network, the VM will be exposed to the world and we publish the password on this web site.  When you complete the process below, you'll be able to see the COmanage login web page.

Initial Testing Process

A quick test of the environment includes the following steps:

1. Download the COmanage-1.0.ova file (or the most recent version) from the distribution site.
2. Import the image into virtual box.
3. Potentially change the network setting from NAT to Bridged - see above comments on VirtualBox.
4. Start the virtual machine.
5. Login to the VM:  LoginId: comanage   password: comanage
6. Create a self-signed certificate for use in the test.  Fill in appropriate answers for Country and City.  Be sure to keep track of the domain name that you put into the CN field.
   1. openssl req -x509 -nodes -days 365 -sha256  -newkey rsa:2048 -keyout coman.key -out coman.crt
7. Copy the certificate files to the appropriate locations for the installer
   1. cp coman.key coman.crt /home/comanage/ssl/httpd
   2. cp coman.crt /home/comanage/ssl/httpd/incommon_chain.pem
8. Run the configuration script:  bin/configure.sh
   1. As you answer the questions, make sure that the FQDN you specify now matches the CN value used when you created the certificate.
   2. You can safely put in fake answers to the email questions as that feature will not work as part of this simple test.
9. Start comanage: bin/comanage.sh
   1. You will see the final build/configuration process.
   2. When this command returns, the Docker version of COmanage will be up and running.
10. Verify that two containers are running via the command: docker ps
11. If you enabled bridge mode described above
    1. Obtain the IP address of your vm.  Run:  ip addr and look for and address from your campus network
    2. With a web browser, connect to: https://ip_addr/registry/
    3. Ignore the SSL warnings.
    4. You should connect to a login page.  Do not expect the login function to actually work, that requires InCommon integration and this quick test does not perform any InCommon integration.

Full Testing Process