Installing on offline servers from a Linux system

Pull the containers from the Docker hub to a Linux® system with internet access, and then install on offline servers. With the following steps, you can deploy Telco Network Cloud Manager - Performance within your secure network.

About this task

To install Telco Network Cloud Manager - Performance in an air-gap environment, you need at least one server to access internet. Rest of the servers in your cluster need not have internet access.

Procedure

  1. Download the Telco Network Cloud Manager - Performance installation media from IBM® Passport Advantage to a server that has internet access.
    For example, Server A.
  2. Copy the image to a location of your choice.

    For example, /installers/core. It is referred to as <DIST_DIR>.

  3. Use the following command to extract the media:
    tar -zxvf tncp-1.4.6.tar.gz
    Or use the following command:
    gunzip -c tncp-1.4.6.tar.gz | tar -xvf -
    

    See Downloading the installation media for files and folders available in the media.

  4. Run the offline.sh script by using the following commands:
    
    cd <DIST_DIR>/etc/tools
    ./offline.sh
    
    Note: This step requires access to internet.

    All the docker images are downloaded from the Docker hub and saved as tncp-1.4.6-images.tar file in <DIST_DIR>/etc/tools location.

    The output is as follows:
    Downloading ceph/ceph:v15...
    Downloading docker.io/persistentsystems/basecamp-analytics:2.4.1.0-229-4b69a3f4@sha256:56d2b5161122ff38da41ea4759d917369c0d3f698b3827ee9f0c1cd9c2fcbdbb...
    Downloading docker.io/persistentsystems/basecamp-app:2.4.1.0-229-4b69a3f4@sha256:23bd8873a491dc5b64e6dc4878e6c6090ac15c7dbfbc9cb5d8243662b7e407be...
    Downloading docker.io/persistentsystems/basecamp-cassandra:3.11.10.1@sha256:ec6467e23ff284307b94774503f99bbace70fd52a0c08ee795bc41eebd4f6dfb...
    Downloading docker.io/persistentsystems/basecamp-dashboard:2.4.1.0-229-4b69a3f4@sha256:f4d26bf9e51fbd3ec0afe0ae9cfc18c1322181ce39247addf2a83fea6cb5ce82...
    Downloading docker.io/persistentsystems/basecamp-dns-collector:2.4.1.0-149-7ffee825@sha256:a746914e6a426abf1f6d7f8a979743ea51864f63fbd8c14f0137111fa7feb4ce...
    Downloading docker.io/persistentsystems/basecamp-file-collector:2.4.1.0-149-7ffee825@sha256:0954780afcc5216d43800a0532e89a0723460634b60d5ed51472b2bba41c902d...
    Downloading docker.io/persistentsystems/basecamp-flow-analytics:2.4.1.0-149-7ffee825@sha256:681c2d15f35e2617af66d23f2cd09e17bb9ddf9598fc900c03e1d211c02265ee...
    Downloading docker.io/persistentsystems/basecamp-flow-collector:2.4.1.0-149-7ffee825@sha256:bead2861019722a19cb41a79385e7b6b58f79612617eb395e645746a5653b818...
    Downloading docker.io/persistentsystems/basecamp-inventory:2.4.1.0-229-4b69a3f4@sha256:e0634efd0472bceb9d5273e0733325c2bc029915407d944c835460602c7a13bf...
    Downloading docker.io/persistentsystems/basecamp-kafka:3.3.3.2@sha256:0773f47ee55815ecc4cb6120cd8d24e37918ab3cffe06fee87d67b1531af9c43...
    Downloading docker.io/persistentsystems/basecamp-ldap:1.0.7@sha256:d5e8abb2654a3566371bff7419319207731d6878c1f670d630a1bfdd10901a2f...
    Downloading docker.io/persistentsystems/basecamp-nfs:1.0.12@sha256:a3b8cb9976db74d571de3e18f30b9b1b2567c47bb0a40232c93b34825e9ec211...
    Downloading docker.io/persistentsystems/basecamp-nifi:1.10.0.13@sha256:b9ffa5c3434111df0fb608bd1092c5e49fc2aada6afb8994f1f1eeed585c54aa...
    Downloading docker.io/persistentsystems/basecamp-postgres:11.2@sha256:fc0e7467a393d80ba39295f724190d3eb24e4ccc22bb191cd987b08f2b5c3400...
    Downloading docker.io/persistentsystems/basecamp-snmp-collector:2.4.1.0-149-7ffee825@sha256:b6a76ce79566c3c351883f5bb726c5ea7db7b86d339d193aa1bdd8fe4191978e...
    Downloading docker.io/persistentsystems/basecamp-snmp-discovery:2.4.1.0-149-7ffee825@sha256:277f503840ed04e035c1b94c95c4ed797f1a89ce05efc385b84ab6a346a4c71d...
    Downloading docker.io/persistentsystems/basecamp-threshold:2.4.1.0-229-4b69a3f4@sha256:6d1f243643a3cc0c836eee2e9450394c3ced4460718fd4ca519c5dd8cfce8904...
    Downloading docker.io/persistentsystems/basecamp-timeseries:2.4.1.0-229-4b69a3f4@sha256:f0f2abb4c655e4223728b0c7a2301b494223b838a8b3424599047c8ef04716b0...
    Downloading docker.io/persistentsystems/basecamp-ui:2.4.1.0-229-4b69a3f4@sha256:f370dc1c2ce80801f2ab6d1aeba4be9662e2a2691c99e68407716ea5778ee759...
    Downloading docker.io/persistentsystems/basecamp-zookeeper:5.5.0.2@sha256:9aa7cbcf5440baa832bc048796b78366efdd4337b808bdcdc7af9a31457c7cbd...
    Downloading docker.io/persistentsystems/diamond-db:2.0.0.21@sha256:0d280334e8584c04d9e41881f6cf08799647614fdb7732ebfce819631460b036...
    Downloading docker.io/persistentsystems/tncp-operator:1.4.2-127-1c82047c@sha256:c70c4a0a3f775bc4ab66d09b77296ca894929b774af0c11ed23331c9b3dbea86...
    Downloading rook/ceph:v1.4.2...
    Download complete.
    
  5. Copy the tncp-1.4.6-images.tar to the master node.
  6. Copy the tncp-1.4.6-images.tar file to all worker nodes to a location of your choice.

    For example, /tmp/images.

    You can use the following command:
    cp <DIST_DIR>/etc/tools/tncp-1.4.6-images.tar root@workernode:/tmp/images/
  7. Run the prerequisite script.
  8. In all worker nodes, extract the tncp-1.4.6-images.tar.
  9. In all worker nodes, run the install.sh file that is available in the tncp-1.4.6-images.tar file. It loads the .tar files to the Docker repository. Run the following commands:
    
    cd /tmp/images 
    ./install.sh
  10. Check that Docker images are successfully loaded with the following command:
    docker images
    $ sudo docker images
    REPOSITORY                                  TAG                    IMAGE ID            CREATED             SIZE
    k8s.gcr.io/kube-apiserver                   v1.21.3                3d174f00aa39        5 weeks ago         126MB
    k8s.gcr.io/kube-scheduler                   v1.21.3                6be0dc1302e3        5 weeks ago         50.6MB
    k8s.gcr.io/kube-controller-manager          v1.21.3                bc2bb319a703        5 weeks ago         120MB
    k8s.gcr.io/kube-proxy                       v1.21.3                adb2816ea823        5 weeks ago         103MB
    persistentsystems/tncp-operator             1.4.2-127-1c82047c     5caa4058cd1d        2 months ago        578MB
    persistentsystems/basecamp-snmp-discovery   2.4.1.0-149-7ffee825   3172fc9f1ee5        2 months ago        781MB
    persistentsystems/basecamp-file-collector   2.4.1.0-149-7ffee825   cbfb53e7fd21        2 months ago        658MB
    persistentsystems/basecamp-dns-collector    2.4.1.0-149-7ffee825   d1d3dfeaa1e2        2 months ago        591MB
    persistentsystems/basecamp-flow-collector   2.4.1.0-149-7ffee825   b264bc0fda27        2 months ago        731MB
    persistentsystems/basecamp-flow-analytics   2.4.1.0-149-7ffee825   f65dad247806        2 months ago        715MB
    persistentsystems/basecamp-snmp-collector   2.4.1.0-149-7ffee825   2810eb0aee84        2 months ago        691MB
    persistentsystems/basecamp-analytics        2.4.1.0-229-4b69a3f4   bf524d7dacbd        2 months ago        740MB
    persistentsystems/basecamp-threshold        2.4.1.0-229-4b69a3f4   ef4bf482712f        2 months ago        1.44GB
    persistentsystems/basecamp-dashboard        2.4.1.0-229-4b69a3f4   cde9958ca669        2 months ago        2.06GB
    persistentsystems/basecamp-ui               2.4.1.0-229-4b69a3f4   b67b3020584d        2 months ago        776MB
    persistentsystems/basecamp-app              2.4.1.0-229-4b69a3f4   56ef1d320758        2 months ago        628MB
    persistentsystems/basecamp-inventory        2.4.1.0-229-4b69a3f4   2a9119d84d5e        2 months ago        627MB
    persistentsystems/basecamp-timeseries       2.4.1.0-229-4b69a3f4   2149cd9fbdf2        2 months ago        583MB
    persistentsystems/basecamp-nifi             1.10.0.13              06dfed4ce772        2 months ago        2.81GB
    persistentsystems/basecamp-ldap             1.0.7                  f705b2dd8981        2 months ago        152MB
    ceph/ceph                                   v15                    2cf504fded39        3 months ago        1.03GB
    persistentsystems/basecamp-cassandra        3.11.10.1              da2ea102ee46        3 months ago        402MB
    persistentsystems/diamond-db                2.0.0.21               eb2ab8e06c99        3 months ago        793MB
    persistentsystems/basecamp-kafka            3.3.3.2                a80ed78d8a9b        3 months ago        596MB
    persistentsystems/basecamp-zookeeper        5.5.0.2                f3eb3ce5eae2        3 months ago        694MB
    persistentsystems/basecamp-postgres         11.2                   5f305eb9cb03        3 months ago        282MB
    k8s.gcr.io/pause                            3.4.1                  0f8457a4c2ec        7 months ago        683kB
    persistentsystems/basecamp-nfs              1.0.12                 ed5a69915b41        8 months ago        103MB
    k8s.gcr.io/coredns/coredns                  v1.8.0                 296a6d5035e2        10 months ago       42.5MB
    rook/ceph                                   v1.4.2                 24ec62bb5700        12 months ago       1.07GB
    k8s.gcr.io/etcd                             3.4.13-0               0369cf4303ff        12 months ago       253MB
    calico/node                                 v3.11.3                4f4edb11a2f4        15 months ago       261MB
    calico/pod2daemon-flexvol                   v3.11.3                8a7b52b94812        15 months ago       112MB
    calico/cni                                  v3.11.3                0f4b3848f931        15 months ago       222MB
    calico/kube-controllers                     v3.11.3                5a18f5dbc200        15 months ago       52.5MB
    kubernetesui/dashboard                      v2.0.0-rc5             fe0df1b24096        18 months ago       126MB
    kubernetesui/metrics-scraper                v1.0.3                 3327f0dbcb4a        19 months ago       40.1MB
     
  11. Copy the Telco Network Cloud Manager - Performance installation media, tncp-1.4.6.tar.gz file from Server A to the master node in your cluster.
    Copy the file to a location of your choice.

    For example, /installers/core. It is referred to as <DIST_DIR2>.

  12. Use the following command to extract the media:
    tar -zxvf tncp-1.4.6.tar.gz
    Or use the following command:
    gunzip -c tncp-1.4.6.tar.gz | tar -xvf -
    

    See Downloading the installation media for files and folders available in the media.

  13. Run the following commands on the master node to install Telco Network Cloud Manager - Performance as root user or use sudo:
    
    cd <DIST_DIR2>
    ./install.sh --offline=true
     
    <DIST_DIR2> is the directory where you extracted the copied installation media.
    Note: It assumes that your storage class is NFS.
  14. After the installation is complete, use the following command to check the Pod status in the master node:
    kubectl get pods
    You can see the following output:
    #kubectl get pods
    NAME                  READY   STATUS    RESTARTS       AGE
    analytics-batch-0     1/1     Running   6 (44h ago)    5d6h
    analytics-stream-0    1/1     Running   0              5d6h
    app-0                 1/1     Running   10             5d9h
    cassandra-0           1/1     Running   0              5d9h
    dashboard-0           1/1     Running   2              4d11h
    diamond-db-0          1/1     Running   3 (5d9h ago)   5d9h
    diamond-db-export-0   1/1     Running   0              5d9h
    diamond-db-read-0     1/1     Running   1              5d9h
    dns-collector-0       1/1     Running   0              5d6h
    file-collector-0      1/1     Running   0              5d6h
    flow-analytics-0      1/1     Running   1              5d6h
    flow-collector-0      1/1     Running   2 (44h ago)    5d6h
    inventory-0           2/2     Running   2              5d5h
    kafka-0               1/1     Running   22 (44h ago)   5d9h
    nifi-0                1/1     Running   1              5d6h
    ping-collector-0      1/1     Running   0              3m49s
    postgres-0            2/2     Running   0              5d9h
    postgres-th-0         1/1     Running   0              5d9h
    security-0            1/1     Running   0              5d9h
    snmp-collector-0      1/1     Running   0              5d6h
    snmp-discovery-0      1/1     Running   0              5d6h
    threshold-0           1/1     Running   1 (44h ago)    5d6h
    timeseries-0          1/1     Running   7 (5d8h ago)   5d9h
    ui-0                  1/1     Running   1 (43h ago)    4d11h
    zookeeper-0           1/1     Running   1              5d9h