Upgrade an Airgap Server from 2.1 to 2.2

This section describes how to upgrade an Airgap server from version 2.1 to 2.2.

Prerequisite

If you are upgrading the Airgap server in an Internet-restricted environment, ensure that the Airgap server has temporary internet access or create a new Airgap server temporarily in an internet-accessible environment.

Procedure

Upgrade the Airgap Server using one of the following methods:

• Upgrade the Airgap Server in an Internet-accessible environment.

  1. Download the VMware-Telco-Cloud-Automation-airgap-files-[release]-[build].tar.gz file from the VMware Downloads page and extract it to the /root/ folder.

  2. Create a copy of the setup-user-inputs.yml file as user-inputs.yml.

     #cd /root/airgap/scripts/vars/
     #cp setup-user-inputs.yml user-inputs.yml

  3. Update the following parameters in the user-inputs.yml file. For more information, see the Telco Cloud Automation documentation. A sample configuration of parameters is as follows:

     #1. General Configurations
     products:
       - name: "tca"
         versions: "2.2.0-"
     
     server_fqdn: <user Airgap FQDN name>
     root: /root/airgap/
     
     #2. Additional Disk Configurations
     single_disk: False
     
     #3. Server Certificate Configurations 
     #False: customer bring certificate
     #True: Playbook will generate a private root CA
     auto_generate: False
     
     server_cert_path: /root/certs/FQDN.cert
     server_cert_key_path: /root/certs/FQDN.key
     ca_cert_path: /root/certs/ca.crt

  4. Prepare the Airgap server and download all the required repositories:

     #cd /root/airgap/
     #scripts/bin/run.sh sync

     Depending on the number of repositories you download from the Internet, this command takes 3-6 hours to run.

• Upgrade the Airgap Server in an Internet-restricted environment.

  1. Prepare the incremental Upgrade Images Bundle from the new Airgap Server.

     1. Deploy and configure a new Photon OS VM as the new Airgap server. For instructions, see Deploy and Configure an Airgap Server VM.

     2. Download the VMware-Telco-Cloud-Automation-airgap-files-[release]-[build].tar.gz file from the VMware Downloads page and extract it to the /root/ folder.

     3. Create a copy of the setup-user-inputs.yml file as user-inputs.yml.

        #cd /root/airgap/scripts/vars/
        #cp setup-user-inputs.yml user-inputs.yml

     4. Update the following parameters in the user-inputs.yml file. For more information, see the Telco Cloud Automation documentation. A sample configuration of parameters is as follows:

        • #1. General Configurations
          products:
            - name: "tca"
              versions: "2.2.0"
              name: "photon"
              baseline: "2.1.0"
          server_fqdn: <user Airgap FQDN name>
          root: /root/airgap/
          
          #2. Additional Disk Configurations
          single_disk: False
          
          #3. Server Certificate Configurations 
          #False: customer bring certificate
          #True: Playbook will generate a private root CA
          auto_generate: True
          
          cert_ca_common_name: telco.com
          cert_country_name: UScert_state_name: CAcert_county: SantaClara
          cert_organization: telcocert_bu: SEBU

     5. Prepare the Airgap server and download all the required repositories:

        • #cd /root/airgap/
          #scripts/bin/run.sh export

     Based on the internet speed, the export command generates the airgap-export-bundle-YYYYMMDDHHMMSS.tar.gz file within 2-3 hours in the /photon-reps/export-bundle/ folder.

  2. Import the Telco Cloud Automation 2.2 tar file into the Telco Cloud Automation 2.1 Airgap server.

     1. Rename the existing Airgap 2.1 folder in the /root/ folder.

     2. Download the VMware-Telco-Cloud-Automation-airgap-files-[release]-[build].tar.gz file from the VMware Downloads page and extract it to the /root/ folder.

     3. Create a copy of the setup-user-inputs.yml file as user-inputs.yml.

        #cd /root/airgap/scripts/vars/
        #cp setup-user-inputs.yml user-inputs.yml

     4. Update the following parameters in the user-inputs.yml file. For more information, see the Telco Cloud Automation documentation. A sample configuration of parameters is as follows:

        • #1. General Configurations
          products:
            - name: "tca"
              versions: "2.2.0"
              name: "photon"
              baseline: "2.1.0"
          server_fqdn: <user Airgap FQDN name>
          root: /root/airgap/
          
          #2. Additional Disk Configurations. Based on disk requirement update the below parameters. 
          
          single_disk: False
          
          secondary_disk_name: /dev/sdb
          photon_disk_size: 300
          harbor_disk_size: 120
          docker_disk_size: 180
          
          #3. Server Certificate Configurations 
          #False: customer bring certificate
          #True: Playbook will generate a private root CA
          auto_generate: False
          
          server_cert_path: /root/certs/FQDN.cert
          server_cert_key_path: /root/certs/FQDN.key
          ca_cert_path: /root/certs/ca.crt

     5. Copy the airgap-export-bundle-YYYYMMDDHHMMSS.tar.gz file from the internet-accessible Airgap server to the internet-restricted Airgap server's 2.1 /photon-reps/ folder.

     6. (Optional) Before copying the exported tar file from the /photon-reps/ folder, resize the disk if the free disk space is less than 110 GB. This command takes approximately 1 min to run.

        • #scripts/bin/run.sh resize

     7. Import the exported bundle into the internet-restricted Airgap server 2.1. This command takes approximately 10 mins to run.

        • #docker login <user Airgap FQDN name>
          #cd /root/airgap/
          #scripts/bin/run.sh import