Installing Updates

Updating Phrase On-Premise

Updating Phrase On-Premise

Phrase On-Premise updates are available as encrypted Docker images via download.

Update steps

1. Backup your Phrase MySQL database

If you aren’t regularly backing up your database, make sure you create a backup of the MySQL database before you install an update. Our updates are designed to be seamless and should not harm stored data.

1.1. Important: Download all Locales if you're using Native Emoji Support:

This step is only required, if you're updating to Phrase On-Premise 3.6.1 or higher and use Native Emoji Support:

Download all Locales with "convert emoji" option enabled ("simple json" format is preferred) before starting with the update process.

2. Sign in to your Docker host

3. Follow the installation steps to decrypt the Docker image and import it into the Docker host
This is the same process as in the installation, just use the $RELEASE_URL of the update and use a new tag when importing the Docker image into Docker.


4. Stop any running Phrase enterprise container

$ docker stop $CONTAINER_ID

You can easily figure out the currently running container’s $CONTAINER_ID using the docker ps-command. Look for the container locally binding on the Phrase port 8080.


5. Use the same command as in the installation, but with the <version> of the latest release you want to use.

Note: We strongly advise against downgrades!

 $ docker run -p 8080:8080 -i -t --env-file phraseapp.env \
   -v $HOME/phraseapp.lic:/app/phraseapp-enterprise.lic \
   phraseapp/on-premise:<version> # (e.g. phraseapp/on-premise:3.6.1)

 
6. After a couple of minutes, go to your web browser and check the Phrase status page for the currently running Revision. It should be the one from the update.

Point your browser to the address $BASE_URL/_status or on OS X with Chrome:

$ open -a "/Applications/Google Chrome.app" $BASE_URL/_status

Phrase On-Premise will execute all necessary data migrations automatically. This might take a couple of minutes depending on the amount of data stored within Phrase On-Premise. After the update, the Phrase On-Premise interface will be available through port 8080 of the newly launched Docker container.

7. Update Translations if Native Emoji Support was enabled before:

If you were using Native Emoji Support, now would be the time to import (update) the translations that you have previously downloaded (Step 1.1). Update all Locale files, and use "Update Translations" option.