Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The FlexDeploy distribution contains the following components:

...

In this example, JAVA_HOME is /u01/java/jdk1.8.0_281 but it can be anything you want. If default java is not version 8, then we will need to adjust for it during Step 7 later. 

...

Step 2. Prepare software

Extract the zip file in the desired location (referred to as "FLEXDEPLOY_HOME" in this document). See FlexDeploy can be downloaded from the Flexagon Support Site. You will download specific version of FlexDeploy, download file is named Tomcat_Complete-X.X.X.X.zip, where X.X.X.X represents four digit version number.

Extract the zip file in the desired location (referred to as "FLEXDEPLOY_HOME" in this document). See example below, where zip was extracted in /u01/flexdeploy folder.

...

Code Block
unzip <ojdbc8 download locaton>/ojdbc8-full.zip

cd <FLEXDEPLOY$FLEXDEPLOY_HOME>HOME/apache-tomcat-flexdeploy/lib
rm ojdbc*.jar
cd ..
mkdir -p libext
cd libext
cp <jdbc driver extract location>/ojdbc-full/*.jar .

...

Code Block
unzip <ojdbc8 download locaton>\ojdbc8-full.zip

cd <FLEXDEPLOY%FLEXDEPLOY_HOME>HOME%\apache-tomcat-flexdeploy\lib
del /f ojdbc*.jar
cd ..
mkdir libext
cd ..\libext
copy <jdbc driver extract location>\ojdbc-full\*.jar .

...

Code Block
languagebash
chmod +x <FLEXDEPLOY$FLEXDEPLOY_HOME>HOME/apache-tomcat-flexdeploy/bin/*.sh
chmod +x <FLEXDEPLOY$FLEXDEPLOY_HOME>HOME/*.sh

...

Step 9. Adjust for non-default server side directories

...

Code Block
languagebash
tar xf <tar file directory>/influxdb2-2.2.0-linux-amd64.tar.gz  --strip-components 1 -C <FLEXDEPLOY$FLEXDEPLOY_HOME>HOME/influxdb
tar xf <tar file directory>/influxdb2-client-2.2.1-linux-amd64.tar.gz  --strip-components 1 -C <FLEXDEPLOY$FLEXDEPLOY_HOME>HOME/influxdb

Adjust the influx database configuration file. <FLEXDEPLOY_HOME>/influxdb/config/config.yaml

Linux

Code Block
languagebash
cd <FLEXDEPLOY$FLEXDEPLOY_HOME>HOME
mkdir -p application/vsm
cd influxdb/config
vi config.yaml

...

Windows

Code Block
languagebash
cd <FLEXDEPLOY%FLEXDEPLOY_HOME>HOME%
mkdir application/\vsm
cd influxdb/\config
edit config.yaml

Change the following locations: You must put absolute path as no environment variables are allowed in this file.

Linux

  • bolt-path: from <FLEXDEPLOY_HOME>/influxdb/data/influxd.bolt to <FLEXDEPLOY_HOME>/application/vsm/data/influxd.bolt

  • engine-path: from <FLEXDEPLOY_HOME>/influxdb/data/engine to <FLEXDEPLOY_HOME>/application/vsm/data/engine

  • sqlite-path: <FLEXDEPLOY_HOME>/influxdb/data/influxd.sqlite to <FLEXDEPLOY_HOME>/application/vsm/data/influxd.sqlite

...

  • bolt-path: from <FLEXDEPLOY_HOME>\influxdb\data\influxd.bolt to <FLEXDEPLOY_HOME>\application\vsm\data\influxd.bolt

  • engine-path: from <FLEXDEPLOY_HOME>\influxdb\data\engine to <FLEXDEPLOY_HOME>\application\vsm\data\engine

  • sqlite-path: <FLEXDEPLOY_HOME>\influxdb\data\enginesqlite-path: <FLEXDEPLOY_HOME>\influxdb\data\influxd.sqlite to <FLEXDEPLOY_HOME>\application\vsm\data\influxd.sqlite\influxd.sqlite to <FLEXDEPLOY_HOME>\application\vsm\data\influxd.sqlite

Setup the config file for FlexDeploy to connect to influxdb.

Create the file <FLEXDEPLOY_HOME>/influxdb/config/fdinflux.config with the following contents, modifed appropriately for your install.

Code Block
INFLUXDB_URL=http://localhost:8086
INFLUXDB_BUCKET=flexbucket
INFLUXDB_ORG=flexdeploy

Step 11. Start tomcat

Info

If running FlexDeploy 6.0 or higher, do not use startup.sh as this will not start the influx database.

Linux

Code Block
languagebash
cd <FLEXDEPLOY$FLEXDEPLOY_HOME>HOME
# this will be automatically updated within a FlexDeploy credential (FD_INFLUXDB_ADMIN_TOKEN) on startup so FlexDeploy can connect with the influx database. 
# This will be used in the next setup step.
export INFLUX_DB_TOKEN=<arbitrary value>  
echo ${INFLUX_DB_TOKEN} > application/vsm/.token
./StartFlexDeploy.sh

Windows

Code Block
languagebash
cd <FLEXDEPLOY%FLEXDEPLOY_HOME>HOME%
# this will be automatically updated within a FlexDeploy credential (FD_INFLUXDB_ADMIN_TOKEN) on startup so FlexDeploy can connect with the influx database.  
# This will be used in the next setup step.
set INFLUX_DB_TOKEN=<arbitrary value>  
echo %INFLUX_DB_TOKEN% > application\vsm\.token
StartFlexDeploy.bat

...

Linux

Code Block
languagebash
cd <FLEXDEPLOY$FLEXDEPLOY_HOME>HOME/influxdb
INFLUX_DB_PASSWORD=<arbitrary value>
rm -rf ~/.influxdbv2
./influx setup --bucket flexbucket --token ${INFLUX_DB_TOKEN} --org flexdeploy --username=flexuser --password=${INFLUX_DB_PASSWORD} --host=http://localhost:8086 --force

./influx bucket list
ID                      Name            Retention       Shard group duration    Organization ID Schema Type
8eec65b90f79c55e        _monitoring     168h0m0s        24h0m0s                 9050d0dddc192df9implicit
4d6413cbaad04850        _tasks          72h0m0s         24h0m0s                 9050d0dddc192df9implicit
a3521682726cd901        flexbucket      infinite        168h0m0s                9050d0dddc192df9implicit

# take the ID value for the flexbucket (Name) so we can update the retention policy to 104 weeks or 2 years
./influx bucket update --id a3521682726cd901 --retention 104w

Windows

Code Block
languagebash
cd <FLEXDEPLOY%FLEXDEPLOY_HOME>HOME%\influxdb
set INFLUX_DB_PASSWORD=<arbitrary value>
rmdir /s <user directory>\.influxdbv2
influx setup --bucket flexbucket --token %INFLUX_DB_TOKEN% --org flexdeploy --username=flexuser --password=%INFLUX_DB_PASSWORD% --host=http://localhost:8086 --force

influx bucket list
ID                      Name            Retention       Shard group duration    Organization ID Schema Type
8eec65b90f79c55e        _monitoring     168h0m0s        24h0m0s                 9050d0dddc192df9implicit
4d6413cbaad04850        _tasks          72h0m0s         24h0m0s                 9050d0dddc192df9implicit
a3521682726cd901        flexbucket      infinite        168h0m0s                9050d0dddc192df9implicit

# take the ID value for the flexbucket (Name) so we can update the retention policy to 104 weeks or 2 years
influx bucket update --id a3521682726cd901 --retention 104w

...

Note

After starting your server, check the <FLEXDEPLOY_HOME>/apache-tomcat-flexdeploy/logs/flexdeploy.0.log file for the following error message:

  • ORA-12519, TNS:no appropriate service handler found

If present, increase the number of processes for the database

  • Using SQLPlus update processes setting.

    • alter system set processes=200 scope=spfile;

  • Stop Tomcat

  • Restart the XE Database

  • Start Tomcat

...