This page provides instructions for manually upgrading a FlexDeploy docker install to use newer version of FlexDeploy Docker image. You will need to download appropriate version of FlexDeploy Tomcat distribution for database scripts and plugins.
Info |
---|
If you aren’t It is only recommended to use the manual instructions if you are using Kubernetes or have a very unique configuration more complicated configuration. For most people we recommend using the automated installer. |
Note |
---|
Beginning with FlexDeploy 6.0.0.6 the mount point from the container side has changed to /dockervolume. Previously it was /home/oracle now it is /dockervolume. This will only affect the run command, make sure you use /dockervolume. |
Step 1. Stop the container
Stop the Docker container using name. docker stop <name>.
Infonote |
---|
If you are using Kubernetes you’ll need to translate these any docker commands into the equivalent Kubernetes. |
...
Step 2. Backup the FlexDeploy schemas and Artifact Repository.
Insert excerpt | ||||||||
---|---|---|---|---|---|---|---|---|
|
File System backup
It is recommended that a backup of the container volume mounted to /home/oracledockervolume
be created in case a back out is needed.
...
Step 3. Upgrade the FlexDeploy schemas
See details in Upgrading FlexDeploy Schemas.
...
Step 4. Copy plugins from download zip for auto upload.
FlexDeploy download zip contains plugin jar files. You just need to copy plugin jars from download zip to plugins folder in your installation (details explained below), and all plugins will be automatically uploaded and activated on server startup.
Plugin files to copy are in the unzipped Tomcat Complete file.
Copy the plugins into the <Mounted Volume>/Plugins directory.
...
Step 5 . Pull and start new docker image for FlexDeploy.
Note |
---|
If using Kubernetes you will instead need to modify your manifest to use the newer version, and to add any new required environment variables. |
...
User same values as used for previous version of FlexDeploy when starting new version of image, other than the version. Here is a refresher of what the values are:
p
- in this example 8000 is the port which FlexDeploy will be accessed on mapping to port 8080 in the containerFLEX_DB_URL
- jdbc URL for accessing the database. See below for syntaxFD_ADMIN_PWD
- Password for the fdadmin user in
...
the
...
database
...
INFLUX_DB_USER
- Username for the built in influxdb. Not used in version 6.0.0.6 and later.INFLUX_DB_PASSWORD
- Password for the built in influxdb. Username and password are only used upon first initialization. After that token is used to connect to the database. Not used in version 6.0.0.6 and later.INFLUX_DB_TOKEN
- Token used to connect to the built in influxdb. Not used in version 6.0.0.6 and later.TZ
- Time zone for the container. Given example is America/Chicago.dbtype
- if you are using postgres or oracle database.v
- This will set where your application, repository, vsm and logs folders will go on the docker host. Everything before the colon is on the local machine, after is inside the container. Leave that as /
...
dockervolume
Last is the image which will be flexdeploy/fd_tcat: and the version you want to run.
Info |
---|
the Beginning with FlexDeploy 6.0.0.6 INFLUX_DB_USER, INFLUX_DB_PASSWORD, and INFLUX_DB_TOKEN environment variables are newly required as of FlexDeploy 6.0no longer required. They will be defaulted, or generated. Prior to that you will need to include them. |
Note |
---|
If using version 6.0.0.0 through 6.0.0.5 mount the volume using /home/oracle instead of /dockervolume |
Code Block |
---|
docker run --name flexdeploy -p 8000:8080 -e FLEX_DB_URL="jdbc:oracle:thin:@URL:PORT:xe" -e FD_ADMIN_PWD=DATABASEPASSWORD -e TZ=America/Chicago -e dbtype=oracle|postgres -e INFLUX_DB_USER=flexdeploy -e INFLUX_DB_PASSWORD=INFLUXDBPASSWORD -e INFLUX_DB_TOKEN=INFLXUDBTOKENHERE -v /scratch/DockerVolume/flexdeploy:/home/oracledockervolume flexdeploy/fd_tcat:VERSION |
Tip |
---|
Example JDBC URL (FLEX_DB_URL)
|
...
Step 6. Launch FlexDeploy in your browser
http://<hostname>:<port>/flexdeploy
...