Versions Compared

Old Version 1

changes.mady.by.user Karl Henselin

Saved on

compared with

New Version Current

changes.mady.by.user Karl Henselin

Saved on

Key

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

The FlexDeploy distribution contains the following components:

...

Warning

Unless you are running on Windows or have been advised by Flexagon Support, consider using the Automated Linux installer instead.

Requirements 

Info

See FlexDeploy System Requirements for details on software and hardware requirements

...

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

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.

...

Info

If JAVA_HOME is already set in your environment, you can skip this step.

Unix Example - JAVA_HOME=/u01/java/jdk1.8.0_121382

Windows Example - set JAVA_HOME=c:/installs/Java/jdk1.8.0_121382

 If you were also setting JAVA_HOME, this file would look like this.

...

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

...

Download links for the influx database software and client, if not already downloaded.

Influx database software (Linux) - Influx database software (Windows)

Influx database client (Linux) - Influx database client (Windows)

Untar the influx database software and client to the desired location.

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

...

languagebash

...

Check your open file limits. Influx opens a large number of files to complete its work.

ulimit -Hn

will show the open file limit for the current user. Make sure you run it as the user who will be executing FlexDeploy and Influx.

If it is less that 65536, we recommend raising it.

sudo vi /etc/security/limits.conf

where oracle is the user logged into the box to run FlexDeploy:

oracle soft nofile 16384

oracle hard nofile 65536

Windows

Code Block
languagebash
cd %FLEXDEPLOY_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/data/influxd.sqlite

Windows

  • boltinfluxd.sqlite

Windows

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

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

  • sqlite-path: from <FLEXDEPLOY_HOME>\influxdb\data\engine influxd.sqlite to <FLEXDEPLOY_HOME>\application\vsm\data\enginesqlite-path: <FLEXDEPLOY_HOME>\influxdb\data\influxd.sqlite to <FLEXDEPLOY_HOME>\application\vsm\data\influxd.sqliteinfluxd.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

...

Now that you have installed FlexDeploy, let's get start with configuration. You can do this in matter of minutes by using Blueprints concept, which is very simple configuration wizard for most common usecasesuse cases.

Related Topics

Child pages (Children Display)
pageAdvanced

...