Installation of HSA KIT running from within a dockerized container machine on a server, fully confined within the internal network.

For further installation options, see HSA KIT Deployment.

intro

VM Requirements

  • Docker Version 20.10.5 or later.
  • amd64 architecture
requirements

Installation

  1. Download and/or create the following files to the target machine running docker:
    1. The docker-compose.yml configuration file.
    2. The .env file containing environment settings for the container, most importantly the license key and folder configurations.
  2. Load the HSA KIT Image either
    • From a local file using the command docker image load -i <IMAGE.TAR> OR
    • From AWS Elastic Container Registry (ECR). Previous access must be given by us.
  3. Prepare all directories as described in the docker-compose.yml file.
  4. After preparing the file structure, modify the .env file to match your folder
    designations

    1. Edit the “source” value of the database, data, logs, logs_python, projects, and slides bind folder
      accordingly.
    2. Relative paths are possible.
  5. Should you want to use a specific version (=tag) of HSA KIT, make sure the right tag is selected by the image source: HSA_KIT_VERSION=<TAG>
    1. For always using the latest-loaded version, set the tag to HSA_KIT_VERSION=latest
  6. Ensure that the path to the .env file is in the same folder as your docker-compose.yml.

The env.list file must still be configured, however, to obtain a key, we must first start and
access HSA KIT

  1. Open the .env file in a text-editor of your choice.
  2. Insert the license key calculated from your hardware-id seen on the licensing page into the
    key “HSA_LICENSE_KEY”.
  3. Should you wish to only allow access from certain URLS, configure the environment variable HSA_ALLOWED_ORIGINS as an array of allowed origins. The origins should be separated by commas only, no spaces or brackets.
  4. Save and exit the .env file.
  5. Restart the dockerized HSA KIT.
installation

Running HSA KIT

After a successfull set up of the dockerized HSA KIT, it can be run as follows

  1. Navigate to the folder with all required files, as set up previously.
  2. Run the command docker-compose up -d
    1. For advanced options, see also the official docker-compose documentation on running containers.
  3. As soon as the startup has completed (Command line is available again), you can
    access the website on <http://<your> servers address>
run

Update HSA KIT

You must have access to the command line for docker as well as the folders where the HSA KIT is saved.

The new hsa-kit.tar docker image must be present and accessible on the server, as described above OR pull the latest image from the ECR.

Navigate to the folder with all required files, as set up previously.

  1. Load the new docker image.
  2. Stop the docker container as described before
  3. If a new tag shall be used, update the tag in the docker-compose.yml
  4. Start the docker container as described before.
  5. All other settings will be transferred to the new version.
  6. Optional: Clean up the older image by running the command “docker image prune” and confirming.
update

Continue Reading

continue-reading