On-Prem Installation

This task outlines the steps for installing the AMDC in an air-gapped environment.

Prepare the Installation Files

  1. Download Packages:
    • Download the AMDC Installer package from the public link that Siemens provides.

  2. Transfer Files:
    • Copy both the Installer package and the Assets package to the air-gapped machine.

      scp /home/$USER/Downloads/amdconprem-2024.2.tar.gz user@remote-host:/data/

      scp /home/$USER/Downloads/20250925112654-airgap-bundle.tar.gz user@remote-host:/data/

    • Copy the SSL Certificate files (the full certificate chain and the private key) to the air-gapped machine.

      certificate: scp /home/$USER/Downloads/fullchain.pem user@remote-host:/data/

      private key: scp /home/$USER/Downloads/privkey.pem user@remote-host:/data/

Access the Air-Gapped Machine

  1. Connect to the air-gapped machine using SSH.

    For example: ssh user@remote-host

  2. Ensure your current user has sudo permissions or is the root user.

Run the Installer Script

Navigate to the directory containing the installer script and execute it.
  1. Start Installer and Unpack Assets: The installer automatically unpacks the Assets package and installs installation prerequisites.
  2. Accept the End-User License Agreement (EULA):
    • When prompted, press y or Enter to display the EULA.
    • Read the EULA. To proceed, press Enter.
      Note: Press n to abort the installation.

Unpacking the Archives

To prepare for an installation, you must first unpack the installer script and move the asset package into the correct directory.

Follow these steps using Bash:
  • Become a root user by running the following command: sudo su
  • Change to the directory where you copied the installation archives (the installer script and the asset package): cd /<data>
    Note: Replace /data with your actual directory path if different.
  • Unpack the main installer script archive: tar -xvf amdconprem-2024.2.tar.gz

    This command creates a new directory named onprem-amdc-installer.

  • Copy the air-gap asset package into the newly created installer directory. The installer checks this location for the asset archive at start-up. mv /<data>/20250925112654-airgap-bundle.tar.gz /data/onprem-amdc-installer

Start the Installation

  1. Navigate to the installation directory: cd onprem-amdc-installer
  2. Start the installation by executing the installer script: ./install.sh The installer unpacks the asset package and starts with installing the prerequisites.
  3. Enter y to continue the installtion. The End User License Agreement (EULA) is displayed.
  4. Scroll to read through and press Enter to accept it.

Configure Installation Options

Follow the prompts and enter the required details. Read and press Enter to accept the default value.

  1. To install and configure, press Enter to select the default: AMDC Platform.
  2. To create an air-gapped environment, press Enter to select: On-Premises.
  3. To create a new infrastructure for air-gapped environment. Press Enter to select: Yes.
    Note: This is required for a new deployment.
  4. Specify the path for K3s status and configuration data. For example, /data/state
  5. Specify the path for K3s persistent volume data. For example, /data/storage
  6. For the Kubernetes Namespace, press Enter to select the default: amdc.
  7. Enter the full domain name, the Fully Qualified Domain Name (FQDN) for AMDC (For example, amdc21.aonetest21.az.altairone.com)
    Note: This must be the FQDN you prepared in the prerequisites.
  8. Specify the path to the fullchain.pem file for SSL Certificate Location. For example, /data/fullchain.pem
  9. Specify the path to the privkey.pem file for SSL Private Key Location For example, /data/privkey.pem
  10. To select default path /data/state for Default Storage Class, press Enter.
  11. To accept the default /data/storage for ArangoDB Storage Path, press Enter.
  12. For ArangoDB Authentication, press Enter to select: Local authentication.
  13. For the AMDC Administrator Username, press Enter to select the default: admin.
  14. For the File Storage Backend, press Enter to select the default: SeaweedFS.
  15. For SeaweedFS Storage Path, press Enter to accept the default: /data/storage
    Note: Ensure the path matches the K3s Persistent Volume path.
  16. Press Enter to choose n. No external Load Balancer will be used.
  17. Press Enter to continue with the default values for the user name, admin and email address admin@altairone.com
  18. For Multi Factor Authentication,
  19. Enter the address for your Altair License Server Address. For example, 6200@10.0.0.8

  20. The installer starts the AMDC installation by requesting the credentials for registration.

    Next, it installs the following components:

    • Vertical Pod Autoscaler (VPA)

    • Cert Manager

    • local-path-provisioner

    • Kube Prometheus Stack

    • OpenTelemetry

    • Kubernetes ArangoDB Operator

Administrator Credentials

Once the installation is complete, execute the following commands to retrieve the administrator credentials.

  • For username: kubectl get secrets kratos-init-credentials --template={{".data.username"}} -n appc | base64 -d #

    For password: kubectl get secrets kratos-init-credentials --template={{".data.password"}} -n appc | base64 -d

  • The terminal provides the username and password.

Deployment Sequence

The installer now proceeds with the deployment in the following sequence:
  1. AMDC installation, starts with registration credentials.
  2. The installer installs the following core Kubernetes components:
    • Vertical Pod Auto scaler (VPA)
    • Cert Manager
    • local-path-provisioner
    • Kube Prometheus Stack
    • Open Telemetry
    • Kubernetes ArangoDB Operator
  3. The installer installs all AMDC Services and Grafana Loki.