Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In some situations, the Smartfacts server has no access to the internet. In this case, it is not possible to download the needed software and images. This article describes which options we have to install Smartfacts in such scenarios.

...

Expand
titleProvide container images with a proxy container registry

Provide container images with a proxy container registry

Please contact your administrators to add the Smartfacts registry https://repo.mid.de to the proxy registry.

Add login data to the proxy registry

To connect to your proxy registry you must insert the login information of the proxy registry in your values.yaml file.

To do so, replace the placeholder in the following text and insert it into a file “registrylogin.txt” on the Smartfacts server.

Code Block
{
  "auths":
  {
    "<proxy registry name>" :
    {
      "username":"<username>",
      "password":"<password>"
    }
  }
}
  • Replace the placehoder <proxy registry name> with the name of your proxy registry without a protocoll (e.g. write “repo.yourcompany.com”, not “https://repo.yourcompany.com”)

  • Replace the value of the fields “username” an “password” with the credentials for your proxy registry

  • Save the file with filename “registrylogin.txt”

  • convert the login info to base64

    Code Block
    cat registrylogin.txt | base64 -w0 > registrylogin.base64
  • In the file “values.yaml” add a new line below the line starting with “instance” with the content

    Code Block
      repologin: "<content of file registrylogin.base64>"
    • Replace the placehoder “<content of file registrylogin.txt>“ with the content of the file “registrylogin.base64”

    • Make sure that the indentation at the begin of the line is exact the same as in the line above

  • delet the files “registrylogin.txt” and “registrylogin.base64”

Expand
titleProvide container images without a container registry

Provide container images without a container registry

In this scenario you will download the container images manually and copy it to the server.

  • Enter the web page for downloading the container images. The link of the web page contains the chart version. It has the following format:
    https://cp.mid.de/releases/smartfacts-air-gapped/smartfacts_air_gapped_<HELM_CHART_VERSION>.html

    • Make shure to replace <HELM_CHART_VERSION> with the version of the helm chart you have downloaded. You should now see the download page.

  • Download all files to your client PC

  • create a new directory ~/download/smartfacts on the Smartfacts server

  • copy the downloaded files to ~/download/smartfacts on the Smartfacts server

  • Download the script for loading the images from https://cp.mid.de/releases/smartfacts-air-gapped/loadimages.sh and copy it to ~/download/smartfacts on the Smartfacts server

Load the container images into k3s

On the Smartfacts server

  • Change into the directory ~/download/smartfacts

  • make the script “loadimages.sh” executeable and execute it

    Code Block
    chmod u+x loadimages.sh
    ./loadimages.sh

The script will check if all files are present and correct. If this is the case it will load the container images from the files.

You can view the loaded images with the following command.

Code Block
sudo k3s crictl images

Install Smartfacts

Execute the Installation

...