Upgrade SDS

To ensure your SDS-based database connection continues to function correctly, you must upgrade the SDS agent when you upgrade your MCE environment version. Because the SDS agent is deployed on premises, it is your responsibility to keep your SDS version aligned with your MCE version. To update the SDS, see the following.

Linux Installer
Linux Container
Windows Container

Uninstall SDS Agent

Stop the SDS Agent service, backup the configuration data, and remove the existing installation to preserve your settings for the upgraded version.

Go to your SDS installation directory and stop the service using the following command:

Replace /opt/mstr with your actual SDS installation directory. The commands should complete in under one minute.
Copy
```
cd /opt/mstr
sudo ./dgs-sds-service.sh stop
```
Create a backup directory and copy the configuration files using the following command:

Replace /opt/sds-backup with your preferred backup location.
Copy
```
sudo mkdir /opt/sds-backup
sudo cp -r dgsagent/config dgsagent/data /opt/sds-backup/
```
Uninstall the service and remove the installation files using the following commands. The commands should complete in under one minute.
Copy
```
sudo ./dgs-sds-service.sh uninstall
sudo rm -r /opt/mstr
```

Install the Updated SDS Agent

Download the latest SDS installer, deploy it on your Linux machine, and restore your backed-up configuration data.

Go to the Strategy Download Site and select Federated Data Connectors from the drop-down menu.
Go to Strategy Secure Data Service and click Linux.
Copy the installer to your target Linux machine where the SDS Agent will be deployed.
Extract and install the new SDS agent using the following commands. The commands should complete in under five minutes.
Copy
```
cd /opt
sudo unzip secure-data-service-linux.zip -d /opt

cd /opt/mstr
sudo ./dgs-sds-service.sh install
```
Copy your backed-up configuration and data to the new installation using the following command:
Copy
```
sudo cp -r /opt/sds-backup/config /opt/sds-backup/data /opt/mstr/dgsagent/
```
Start the upgraded SDS agent service using the following commands. The commands should complete in under one minute.
Copy
```
sudo ./dgs-sds-service.sh start
```

Verify Installation

Test your upgraded SDS installation by performing the following verification steps:

To verify the SDS agent is running, run the following command:
Copy
```
sudo ./dgs-sds-service.sh status
```
Access the SDS agent user interface by visiting http://<sds-agent-host>:8080/ or https://<sds-agent-host>:8443/.
Log in using your Strategy credentials and verify the SDS agent is connected to your MCE environment, identified by the link icon under the environment name.
Open Workstation and edit your SDS-based database connection.
Click Test to verify the connection is successful.
After confirming your SDS installation is working correctly, optionally use the following command to remove the backup directory:
Copy
```
sudo rm -r /opt/sds-backup
```

Uninstall SDS Agent

Stop the SDS agent container and backup your configuration settings to preserve customizations during the upgrade process.

Go to your SDS installation directory and stop the container using the following commands.

Replace /home/admin/secure-data-service with your actual SDS installation directory. The commands should complete in under one minute.
Copy
```
cd /home/admin/secure-data-service
./dgs-sds-container.sh stop
```
If you customized the docker-compose.yml file, create a backup of your changes using the following commands.

Replace /home/admin/sds-backup with your preferred backup location.
Copy
```
mkdir -p /home/admin/sds-backup
cp /home/admin/secure-data-service/docker-compose.yml /home/admin/sds-backup
```
Remove the current installation directory using the following command:
Copy
```
rm -r /home/admin/secure-data-service
```

Install the Updated SDS Agent

Download the latest SDS installer, deploy it on your Linux machine, and restore your backed-up configuration data.

Go to the Strategy Download Site and select Federated Data Connectors from the drop-down menu.
Go to Strategy Secure Data Service and click Container.
Copy the container .zip package to your target Linux machine and extract it to the installation directory using the following commands. The commands should complete in under five minutes.
Copy
```
mkdir -p /home/admin/secure-data-service
unzip secure-data-service-container.zip -d /home/admin/secure-data-service
```
Review the new docker-compose.yml file and compare it with your backed-up version. Apply your customizations, such as port number modifications, to the new configuration file. See the following example port configuration:
Copy
```
    ports:
      - "55555:55555"
      - "26214-26313:26214-26313"
      - "8080:8080"
      - "8443:8443"
```
Navigate to the installation directory and start the container using the following commands. The commands should complete in under one minute.
Copy
```
cd /home/admin/secure-data-service
./dgs-sds-container.sh start
```

Verify Installation

Test your upgraded SDS installation by performing the following verification steps:

To verify the SDS agent is running, run the following command:
Copy
```
./dgs-sds-container.sh status
```
Access the SDS agent user interface by visiting http://<sds-agent-host>:8080/ or https://<sds-agent-host>:8443/.
Log in using your Strategy credentials and verify the SDS agent is connected to your MCE environment, identified by the link icon under the environment name.
Open Workstation and edit your SDS-based database connection.
Click Test to verify the connection is successful.
After confirming your SDS installation is working correctly, optionally use the following command to remove the backup directory:
Copy
```
sudo rm -r /opt/sds-backup
```

Uninstall SDS Agent

Stop the SDS agent container and backup your configuration settings to preserve customizations during the upgrade process.

Go to your SDS installation directory, such as the C:\SDS\ folder, and stop the container using the following command. The command should complete in under one minute.
Copy
```
.\dgs-sds-container.ps1 stop
```
If you customized the docker-compose.yml file, create a backup of your changes using the following commands.

Replace C:\SDS_Backup with your preferred backup location.
Copy
```
mkdir C:\SDS_Backup
copy C:\SDS\docker-compose.yml C:\SDS_Backup\docker-compose.yml
```
Remove the current installation directory using the following command:
Copy
```
rmdir /s C:\SDS
```

Install Updated SDS Agent

Download the latest SDS container package and deploy it on your Windows machine with your preserved configuration settings.

Go to the Strategy Download Site and select Federated Data Connectors from the drop-down menu.
Go to Strategy Secure Data Service and click Container.
Copy the container .zip package to your target machine and extract it to the installation directory (for example, C:\SDS). This should complete in under five minutes.
Review the new docker-compose.yml file in the installation directory and compare it with your backed-up version. Apply your customizations, such as port number modifications, to the new configuration file. See the following example port configuration:
Copy
```
    ports:
      - "55555:55555"
      - "26214-26313:26214-26313"
      - "8080:8080"
      - "8443:8443"
```
Navigate to the installation directory and start the container using the following commands. The commands should complete in under one minute.
Copy
```
cd C:\SDS
.\dgs-sds-container.ps1 start
```

Verify Installation

Test your upgraded SDS installation by performing the following verification steps:

To verify the SDS agent is running, run the following command:
Copy
```
.\dgs-sds-container.ps1 status
```
Access the SDS agent user interface by visiting http://<sds-agent-host>:8080/ or https://<sds-agent-host>:8443/.
Log in using your Strategy credentials and verify the SDS agent is connected to your MCE environment, identified by the link icon under the environment name.
Open Workstation and edit your SDS-based database connection.
Click Test to verify the connection is successful.
After confirming your SDS installation is working correctly, optionally use the following command to remove the backup directory:
Copy
```
.\dgs-sds-container.ps1 status
```