v5

Installation

Installing COSMOS

The following sections describe how to get COSMOS installed on various operating systems.

Installing COSMOS on Host Machines

  1. Install Docker
  2. Download the latest COSMOS 5 from the Github releases
  3. Extract the archive somewhere on your host computer
  4. The COSMOS 5 containers are designed to work and be built in the presence of an SSL Decryption device. To support this a cacert.pem file can be placed at the base of the COSMOS 5 project that includes any certificates needed by your organization.
  5. Run cosmos-control.bat start (Windows), or cosmos-control.sh start (linux/Mac)
    • Note cosmos-control.bat takes multiple arguments. Run with no arguments for help.
    • If you see an error indicating docker daemon is not running ensure Docker is installed and running.
  6. COSMOS 5 will be built and when ready should be running (~15 mins for first run, ~2 for subsequent)
  7. Connect a web browser to http://localhost:2900
  8. Continue to Getting Started
SSL Issues

Increasingly organizations are using some sort of SSL decryptor device which can cause curl and other command line tools like git to have SSL certificate problems. If installation fails with messages that involve "certificate", "SSL", "self-signed", or "secure" this is the problem. IT typically sets up browsers to work correctly but not command line applications. Note that the file extension might not be .pem, it could be .pem, crt, .ca-bundle, .cer, .p7b, .p7s, or potentially something else.

The workaround is to get a proper local certificate file from your IT department that can be used by tools like curl (for example mine is at C:\Shared\Ball.pem). Doesn't matter just somewhere with no spaces.

Then set the following environment variables to that path (ie. C:\Shared\Ball.pem)

SSL_CERT_FILE
CURL_CA_BUNDLE
REQUESTS_CA_BUNDLE

Here are some directions on environment variables in Windows: Windows Environment Variables
You will need to create new ones with the names above and set their value to the full path to the certificate file.

After these changes the installer should work. At Ball please contact cosmos@ballaerospace.com for assistance.