Upgrading CTERA Content Services

The procedure to upgrade an existing CTERA Content Services installation is the same for all platforms and requires the following:

• Internet access.
  New releases include upgrades to the docker images used by CTERA Content Services.
• Ports
  Make sure that the required ports are open, as described in Inbound Port Requirements and Outbound Port Requirements.

CTERA Content Services VM can be configured as:

• The default, deployment with both the control plane, the ingestor, and the data plane, the collector end embedding model, deployed on the same VM.
• A separate Ingestor VM and Collector and Embedding model VM.

The upgrade required depends on the configuration.

To upgrade CTERA Content Services when all the components run on the same VM:

1. Contact CTERA Support to get the latest CTERA Content Services zip file.
2. Upload the zip file to the CTERA Content Services VM:
   1. For ESXi deployments, upload the zip file to the /data directory.
   2. For all other platforms, upload the zip file to the /home/usr directory.
3. Enter into the new version directory and unzip the zip file
4. In the unzipped directory, the directory for the new version, run the following command: docker compose pull
5. Wait for all the images to download.
6. Go to the old version directory and run the following command: docker compose down
7. Go to the new version directory and run the following command: docker compose -f docker-compose.yaml -f docker-compose.gpu.yaml up -d
8. Restart the CTERA Content Services VM.

To upgrade CTERA Content Services when the components run on separate VMs:

1. Upload the zip file to the CTERA Content Services VM:
   1. For ESXi deployments, upload the zip file to the /data directory.
   2. For all other platforms, upload the zip file to the /home/usr directory.
2. Enter into the new version directory and unzip the zip file
3. In the unzipped directory, the directory for the new version, run the following command: docker compose pull
4. Wait for all the images to download.
5. Go to the old version directory and run the following command: docker compose down
6. Go to the new version directory and run the following command: docker compose -f docker-compose.yaml up -d
7. Restart the CTERA Content Services VM.
8. Upload the zip file to the Collector VM:
   1. For ESXi deployments, upload the zip file to the /data directory.
   2. For all other platforms, upload the zip file to the /home/usr directory.
9. Enter into the new version directory and unzip the zip file
10. In the unzipped directory, the directory for the new version, run the following command: docker compose pull
11. Wait for all the images to download.
12. Go to the old version directory and run the following command: docker compose down
13. Go to the new version directory and run the following command: docker compose -f docker-compose.gpu.yaml up -d
14. Restart the Collector VM.