Updating a Self-Hosted Instance
Legacy Documentation
You're viewing legacy documentation for API Fortress (deployed via an on-premises container). To view documentation for the new SaaS version of API Fortress — now known as Sauce Labs API Testing and Monitoring (with Sauce Connect tunnels) — see API Testing on the Sauce Labs Cloud.
Updating an On Premises instance of API Fortress is done as follows:
-
Back up the databases. (Optional, but recommended)
- If you're storing the API Fortress data on a persistent volume in a cloud system, you can take a snapshot of the disk.
- You can archive the data directories defined in the docker-compose.yml file.
- You can dump the databases as described here: Backing up Your Data
-
Stop the containers
- From the 'core' directory, issue a
docker-compose stop
command and wait for the operation to complete. This command stops the currently-running Docker containers.
- From the 'core' directory, issue a
-
Pull the updated containers
- From the 'core' directory, issue a
docker-compose pull
command and wait for the operation to complete. This command pulls updated images from the API Fortress Docker repository.
- From the 'core' directory, issue a
-
Restart the containers
- From the 'core' directory, issue a
./start_all.sh
command to restart the containers and wait for the operation to complete. This script restarts the containers in the proper order.
- From the 'core' directory, issue a
Once the preceding steps are completed, the On Premises version of API Fortress will be fully updated.
Please note to update the instance you only need to stop and restart the "core" container. However, it is recommended that you verify the downloader is still up and running. To do so run the following command to see if the downloader is up:
sudo docker ps
If the downloader is not listed in the response, please navigate to the "downloader" directory and issue the following command:
sudo docker-compose up -d