Versions Compared

Old Version 17

changes.mady.by.user Rene Beckert

Saved on

compared with

New Version 18

changes.mady.by.user Rene Beckert

Saved on

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.

...

  • Change to your user's home directory on the server and create a new text file values.yaml with the following content:

    Code Block
    global:
  domain: "<your-domain>"
  smartfactsVersionOverride: "<downloaded common version>" #Syntax example: "2022.11.3" or "2022.12"
  commonVersionOverride: "<downloaded common version>"
  genoslcVersionOverride: "<downloaded common version>"
  instance: "smartfacts-poc"
  registry: "library"
  cert:
    crtFullChain: "<FULL-CHAIN-CERT-BASE64>"
    key: "<CERT-KEY-BASE64>"
  ingress:
    enabled: true
mailservice:
  enabled: false
genoslc:
  enabled: false

  • Replace the value of the domain property with your domain name.

  • Replace the value of the properties “smartfactsVersionOverride”, “commonVersionOverride“ and “genoslcVersionOverride“ with the exact versions of the downloaded images.images. You will see these versions by visiting the page https://cp.mid.de/releases/smartfacts-air-gapped/smartfacts_air_gapped_<HELM_CHART_VERSION>.html, where <HELM_CHART_VERSION> is the exact version of the Helm chart downloaded.
    If for example the helm chart version 3.12.14 is downloaded you will find the versions to insert here:

  • Image Added

    Replace the placeholder of the crtFullChain property with the content of the file chain.crt.base64.

  • Replace the placeholder of the key property with the content of the key.base64 file.

  • Save the values.yaml file.

...

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
    chown 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.

...