{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This page provides instructions for upgrading a FlexDeploy installation. These instructions upgrade Tomcat to the version included in the distribution zip depending on current version of FlexDeploy.","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Unless you are running on Windows or have been advised by Flexagon Support, consider using the ","type":"text","marks":[{"type":"strong"}]},{"text":"Automated Install/Upgrade","type":"text","marks":[{"type":"link","attrs":{"href":"#"}},{"type":"strong"}]},{"text":" instead.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"FlexDeploy System Requirements","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD90/pages/10926687362"}}]},{"text":" for details on software and hardware requirements.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Upgrade Instructions","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Make sure you have downloaded the latest version of FlexDeploy so it can be accessed during upgrade process.","type":"text"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"2"},"maxLevel":{"value":"2"}},"macroMetadata":{"macroId":{"value":"75cb66a2657eb5789d0903344b9b8c88"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"cd0bb568-d403-4b98-a78a-1a680c28b94a"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 1. Stop the Tomcat server","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd $FLEXDEPLOY_HOME/apache-tomcat-flexdeploy/bin\n./StopFlexDeploy.sh","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd %FLEXDEPLOY_HOME%/apache-tomcat-flexdeploy/bin\nStopFlexDeploy.bat","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 2. Download FlexDeploy software","type":"text"}]},{"type":"paragraph","content":[{"text":"Make sure that you have downloaded the latest version of FlexDeploy and unzip it into a temporary location (for example, ","type":"text"},{"text":"/u01/software","type":"text","marks":[{"type":"strong"}]},{"text":"), so it can be accessed during the upgrade process. You can get download links from ","type":"text"},{"text":"http://support.flexagon.com","type":"text","marks":[{"type":"link","attrs":{"href":"http://support.flexagon.com"}}]},{"text":". ","type":"text"},{"text":"Do not unzip the FlexDeploy distribution directly into the FLEXDEPLOY_HOME directory so we can prevent unwanted file(s) or folder(s) from being overwritten","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#ff5630"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that following instructions show unzip being done in separate folder than where you have stored downloaded file.","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mkdir /u01/software/upgradetempdir\ncd /u01/software/upgradetempdir\nunzip /Tomcat_Complete-8.x.x.x.zip","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mkdir c:\\u01\\software\\upgradetempdir\ncd c:\\u01\\software\\upgradetempdir\nunzip \\Tomcat_Complete-8.x.x.x.zip","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 3. Backup current implementation","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"Backup current implementation"}},"macroMetadata":{"macroId":{"value":"fa45dbf2076b6d99ab519284e42cc5ee"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"b147c7e0-e4b5-49f2-b359-bc4f78758abd"},"content":[{"type":"paragraph","content":[{"text":"Backup the FlexDeploy schemas, Artifact Repository, plugins folder, and apache-tomcat-flexdeploy folder. In case you need to back out this FlexDeploy upgrade, you can use this backup data.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is highly recommended that a backup of the database be taken using standard tools like RMAN for Oracle. Another option would be to export the ","type":"text"},{"text":"FD, FD_ADMIN, and FF","type":"text","marks":[{"type":"strong"}]},{"text":" schemas using data pump. Follow standard procedures for PostgreSQL for database backup.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"PostgreSQL database backup","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pg_dumpall -w -U postgres -f fd_db_bkp.bkp -p 5432","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Oracle database backup","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# If this database is exclusively used for just FlexDeploy application, you can rely on your Database backup and recovery processes (RMAN) instead of export data procedure.\n# You will need to setup environment variables before running expdp. For example,\n\nexport ORACLE_HOME=c:\\oracle\\product\\12.1.0\\dbhome_1\nexport ORACLE_SID=fd01\n\n# export statements above are for example only as values will be different for your installation. \n\nexpdp system directory=DATA_PUMP_DIR dumpfile=fd_bkup.dmp schemas=FD,FF,FD_ADMIN","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"File System backup","type":"text"}]},{"type":"paragraph","content":[{"text":"It is recommended that a backup of the ","type":"text"},{"text":"artifact repository","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"plugins","type":"text","marks":[{"type":"em"}]},{"text":", and ","type":"text"},{"text":"apache-tomcat-flexdeploy","type":"text","marks":[{"type":"em"}]},{"text":" be taken in case a back-out is required. The location of the artifact repository can be identified by looking at value of ","type":"text"},{"text":"-Dflexagon.fd.repository.root","type":"text","marks":[{"type":"strong"}]},{"text":" in ","type":"text"},{"text":"setenvoverride.sh","type":"text","marks":[{"type":"strong"}]},{"text":"/setenv.sh file. This file will be in ","type":"text"},{"text":"/apache-tomcat-flexdeploy/bin","type":"text","marks":[{"type":"strong"}]},{"text":". Additionally look for ","type":"text"},{"text":"flexagon.fd.application.root","type":"text","marks":[{"type":"strong"}]},{"text":" to determine server application directory for plugins backup. Standard file backup procedures can be followed.","type":"text"}]},{"type":"paragraph","content":[{"text":"See the following example. ","type":"text"},{"text":"Make sure to backup apache-tomcat-flexdeploy folder as that is going to be replaced during next steps.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd /\ntar -cvzf ../artifacts.tar.gz *\n\n# The plugins folder may not exist yet depending which version of FlexDeploy you are upgrading from\ncd \ncd plugins\ntar -cvzf ../plugins.tar.gz *\n\n# apache-tomcat-flexdeploy (if apache-tomcat-flexdeploy-old exists then use some other folder name)\ncd $FLEXDEPLOY_HOME\nmv apache-tomcat-flexdeploy apache-tomcat-flexdeploy-old","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd \ntar cvzf ..\\artifacts.tar.gz *\n\n# The plugins folder may not exist yet depending which version of FlexDeploy you are upgrading from\ncd \ncd plugins\ntar -cvzf ..\\plugins.tar.gz *\n\n# apache-tomcat-flexdeploy (if apache-tomcat-flexdeploy-old exists then use some other folder name)\ncd %FLEXDEPLOY_HOME%\nmove apache-tomcat-flexdeploy apache-tomcat-flexdeploy-old","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 4. Upgrade the FlexDeploy schemas","type":"text"}]},{"type":"paragraph","content":[{"text":"See details in ","type":"text"},{"text":"Upgrading FlexDeploy Schemas","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD90/pages/10926686381"}}]},{"text":". ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 5. Apply new version","type":"text"}]},{"type":"paragraph","content":[{"text":"You must have performed backup of apache-tomcat-flexdeploy folder by now as described in Step 3. If you have not done that, please go back to Step 3 for details.","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"paragraph","content":[{"text":"Note on additional extension jar files","type":"text","marks":[{"type":"strong"}]},{"text":" : If you had placed additional libraries in ","type":"text"},{"text":"apache-tomcat-flexdeploy/lib","type":"text","marks":[{"type":"code"}]},{"text":" folder or in the ","type":"text"},{"text":"apache-tomcat-flexdeploy/libext","type":"text","marks":[{"type":"code"}]},{"text":" folder, then you will need to copy them from backup folder into the new ","type":"text"},{"text":"apache-tomcat-flexdeploy/libext","type":"text","marks":[{"type":"code"}]},{"text":" folder. ","type":"text"},{"text":"Note that all extension jars should be kept in ","type":"text","marks":[{"type":"underline"}]},{"text":"libext","type":"text","marks":[{"type":"strong"},{"type":"underline"}]},{"text":" folder","type":"text","marks":[{"type":"underline"}]},{"text":". Examples might be JDBC driver (for Oracle drivers there is additional detail in the following step), CyberArk libraries etc. ","type":"text"},{"text":"Note that Tomcat jar files should never be kept in libext folder","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#ff5630"}}]},{"text":". ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy shell/bat scripts from root folder of extracted FlexDeploy download zip","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy new Tomcat folder from extracted FlexDeploy download zip","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy additional jar files from backup taken in step 3","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"See example below on steps necessary. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd $FLEXDEPLOY_HOME\ncp /u01/software/upgradetempdir/*.sh .\nchmod +x *.sh\n\nmkdir apache-tomcat-flexdeploy\ncd apache-tomcat-flexdeploy\n\ncp -r /u01/software/upgradetempdir/apache-tomcat-flexdeploy/* .\nchmod +x bin/*.sh\n\n# restore the libext from the tomcat backup done in Step 3\n# if necessary copy other files that you may have placed in lib\n# only run this if you had libext folder in your apache-tomcat-flexdeploy-old folder.\ncd libext\ncp $FLEXDEPLOY_HOME/apache-tomcat-flexdeploy-old/libext/* .","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd %FLEXDEPLOY_HOME%\ncopy c:\\u01\\software\\upgradetempdir\\*.bat .\n\nmkdir apache-tomcat-flexdeploy\ncd apache-tomcat-flexdeploy\n\nxcopy c:/u01/software/upgradetempdir/apache-tomcat-flexdeploy /e\n\n# restore the libext from the tomcat backup done in Step 3\ncd libext\nxcopy %FLEXDEPLOY_HOME%\\apache-tomcat-flexdeploy-old\\libext /e","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 6. Manage Tomcat context.xml","type":"text"}]},{"type":"paragraph","content":[{"text":"Copy the ","type":"text"},{"text":"context.xml","type":"text","marks":[{"type":"em"}]},{"text":" file from the backup folder into ","type":"text"},{"text":"/apache-tomcat-flexdeploy/conf.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd $FLEXDEPLOY_HOME/apache-tomcat-flexdeploy-old/conf\ncp context.xml $FLEXDEPLOY_HOME/apache-tomcat-flexdeploy/conf","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd %FLEXDEPLOY_HOME%\\apache-tomcat-flexdeploy-old\\conf\ncopy context.xml %FLEXDEPLOY_HOME%\\apache-tomcat-flexdeploy\\conf","type":"text"}]},{"type":"paragraph","content":[{"text":"If using Oracle database,","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the Oracle JDBC 8 driver from ","type":"text"},{"text":"https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html"}}]},{"text":". Click on the driver link matching your Oracle database version, and download the driver compatible with JDK8. For example, ","type":"text"},{"text":"ojdbc8-full.tar.gz","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save new driver jars","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#008000"}}]},{"text":"from downloaded jdbc driver to ","type":"text"},{"text":"/apache-tomcat-flexdeploy/libext","type":"text","marks":[{"type":"strong"}]},{"text":". You may have done this already as part of Step 4. Make sure that if you copied the jars for libext of your backup to your new libext, you don’t end up with multiple versions of the Oracle JDBC jars. If migrating from an old version of FlexDeploy, you may want to clean your libext folder and start with a new Oracle Database driver download.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd /u01/software\nmkdir drivers\ncd drivers\n\ntar -xf /ojdbc8-full.tar.gz\n\ncd $FLEXDEPLOY_HOME/apache-tomcat-flexdeploy/lib\nrm ojdbc*.jar\ncd ../libext\ncp /u01/software/drivers/ojdbc8-full/*.jar .","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd c:\\u01\\software\nmkdir drivers\ncd drivers\n\ntar xf \\ojdbc8-full.tar.gz\n\ncd %FLEXDEPLOY_HOME%\\apache-tomcat-flexdeploy\\lib\ndel /f ojdbc*.jar\ncd ..\\libext\ncopy c:\\u01\\software\\drivers\\ojdbc8-full\\*.jar .","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 7. Manage Tomcat server.xml","type":"text"}]},{"type":"paragraph","content":[{"text":"Edit the ","type":"text"},{"text":"/apache-tomcat-flexdeploy/conf/server.xml","type":"text","marks":[{"type":"code"}]},{"text":" and modify the HTTP/HTTPS ports to match that of the original file which was backed up in step 3. If you had setup keystore details, copy that as well from backup file. DO NOT simply copy over the backup file as there may be other changes.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 8. Manage setenvoverride file","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Changes should not be made in setenv.bat or setenv.sh","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If you were already using ","type":"text"},{"text":"setenvoverride.bat or setenvoverride.sh","type":"text","marks":[{"type":"strong"}]},{"text":", then copy that from backup folder (Step 3), otherwise any changes previously done for setenv.bat or setenv.sh must be added to setenvoverride.bat or setenvoverride.sh. For example, the Artifact directory, application directory, and java_home changes will need to be transferred over from your old setenv.bat or setenv.sh file. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If your backed up setenv.bat or setenv.sh file has a line that contains JAVA_HOME, then the new setenvoverride.bat or setenvoverride.sh should look like this:","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":906,"id":"93021f9f-5c54-4eca-9a18-b0179c10dbb4","collection":"contentId-10926688382","type":"file","height":413}}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":911,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":730,"id":"8589f3e3-f007-4bf7-940b-831fe1f8dbd5","collection":"contentId-10926688382","type":"file","height":468}}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 9. Update Plugins","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Plugin files to copy are in /u01/software/upgradetempdir/application/plugins in the unzipped Tomcat Complete file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Let's determine where to copy files in your installation now. Locate ","type":"text"},{"text":"flexagon.fd.install.root","type":"text","marks":[{"type":"strong"}]},{"text":" folder for your FlexDeploy installation, which is FlexDeploy application directory. This is specified on the Java command line. For example, ","type":"text"},{"text":"-Dflexagon.fd.install.root=/u01/flexdeploy/application","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can look for this information in setenvoverride.bat or setenvoverride.sh file depending whether using Windows or Unix. ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create ","type":"text"},{"text":"plugins","type":"text","marks":[{"type":"strong"}]},{"text":" folder if it does not exist under ","type":"text"},{"text":"flexagon.fd.install.root","type":"text","marks":[{"type":"strong"}]},{"text":" folder. Copy files from download zip (#1 above) to this plugins folder.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":733,"id":"2da26136-9acb-4a49-bc4b-2012e0e5c639","collection":"contentId-10926688382","type":"file","height":165}}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 10. Configure Influx Database","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This is a ","type":"text"},{"text":"required step that must be executed","type":"text","marks":[{"type":"strong"}]},{"text":" if this is the first time you are upgrading to a FlexDeploy 6.0 or higher version. Once upgraded, this step shouldn’t be executed again.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Download links for the influx database software and client, if not already downloaded.","type":"text"}]},{"type":"paragraph","content":[{"text":"Influx database software","type":"text","marks":[{"type":"link","attrs":{"href":"https://dl.influxdata.com/influxdb/releases/influxdb2-2.2.0-linux-amd64.tar.gz"}}]}]},{"type":"paragraph","content":[{"text":"Influx database client","type":"text","marks":[{"type":"link","attrs":{"href":"https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.2.1-linux-amd64.tar.gz"}}]}]},{"type":"paragraph","content":[{"text":"Untar the influx database software and client to the desired location.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"tar xf /influxdb2-2.2.0-linux-amd64.tar.gz --strip-components 1 -C $FLEXDEPLOY_HOME/influxdb\ntar xf /influxdb2-client-2.2.1-linux-amd64.tar.gz --strip-components 1 -C $FLEXDEPLOY_HOME/influxdb","type":"text"}]},{"type":"paragraph","content":[{"text":"Copy config files. See example below on steps necessary. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd $FLEXDEPLOY_HOME\ncd influxdb\nmkdir config\ncd config\ncp /u01/software/upgradetempdir/influxdb/config/* .","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd %FLEXDEPLOY_HOME%\ncd influxdb\nmkdir config\ncd config\nxcopy c:/u01/software/upgradetempdir/influxdb/config /e","type":"text"}]},{"type":"paragraph","content":[{"text":"Adjust the influx database configuration file. ","type":"text"},{"text":"/influxdb/config/config.yaml","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd $FLEXDEPLOY_HOME\nmkdir -p application/vsm\ncd influxdb/config\nvi config.yaml","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd %FLEXDEPLOY_HOME%\nmkdir application\\vsm\ncd influxdb\\config\nedit config.yaml","type":"text"}]},{"type":"paragraph","content":[{"text":"Change the following locations: ","type":"text"},{"text":"You must put absolute path as no environment variables are allowed in this file.","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bolt-path: from /influxdb/data/influxd.bolt to /application/vsm/data/influxd.bolt","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"engine-path: from /influxdb/data/engine to /application/vsm/data/engine","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sqlite-path: /influxdb/data/influxd.sqlite to /application/vsm/data/influxd.sqlit","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If running FlexDeploy 6.0 or higher, do not use startup.sh as this will not start the influx database. User StartFlexDeploy.sh or StartFlexDeploy.bat.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph","content":[{"text":"Now Start FlexDeploy to perform additional steps for InfluxDB. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd $FLEXDEPLOY_HOME\n# this will be automatically updated within a FlexDeploy credential (FD_INFLUXDB_ADMIN_TOKEN) on startup so FlexDeploy can connect with the influx database. \n# This will be used in the next setup step.\nexport INFLUX_DB_TOKEN= \necho ${INFLUX_DB_TOKEN} > application/vsm/.token\n./StartFlexDeploy.sh","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd %FLEXDEPLOY_HOME%\n# this will be automatically updated within a FlexDeploy credential (FD_INFLUXDB_ADMIN_TOKEN) on startup so FlexDeploy can connect with the influx database.\n# This will be used in the next setup step.\nset INFLUX_DB_TOKEN= \necho %INFLUX_DB_TOKEN% > application\\vsm\\.token\nStartFlexDeploy.bat","type":"text"}]},{"type":"paragraph","content":[{"text":"Once influx and tomcat servers are up, we need to run setup on the influx database.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This setup is only executed the first time upgrading to FlexDeploy 6.0 or higher","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph","content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd $FLEXDEPLOY_HOME/influxdb\nINFLUX_DB_PASSWORD=\nrm -rf ~/.influxdbv2\n./influx setup --bucket flexbucket --token ${INFLUX_DB_TOKEN} --org flexdeploy --username=flexuser --password=${INFLUX_DB_PASSWORD} --host=http://localhost:8086 --force\n\n# need to adjust the influx database retention policy\n./influx bucket list\nID Name Retention Shard group duration Organization ID Schema Type\n8eec65b90f79c55e _monitoring 168h0m0s 24h0m0s 9050d0dddc192df9implicit\n4d6413cbaad04850 _tasks 72h0m0s 24h0m0s 9050d0dddc192df9implicit\na3521682726cd901 flexbucket infinite 168h0m0s 9050d0dddc192df9implicit\n\n# take the ID value for the flexbucket (Name) so we can update the retention policy to 104 weeks or 2 years\n./influx bucket update --id a3521682726cd901 --retention 104w","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd %FLEXDEPLOY_HOME%\\influxdb\nset INFLUX_DB_PASSWORD=\nrmdir /s \\.influxdbv2\ninflux setup --bucket flexbucket --token %INFLUX_DB_TOKEN% --org flexdeploy --username=flexuser --password=%INFLUX_DB_PASSWORD% --host=http://localhost:8086 --force\n\nrem need to adjust the influx database retention policy\ninflux bucket list\nID Name Retention Shard group duration Organization ID Schema Type\n8eec65b90f79c55e _monitoring 168h0m0s 24h0m0s 9050d0dddc192df9implicit\n4d6413cbaad04850 _tasks 72h0m0s 24h0m0s 9050d0dddc192df9implicit\na3521682726cd901 flexbucket infinite 168h0m0s 9050d0dddc192df9implicit\n\nrem take the ID value for the flexbucket (Name) so we can update the retention policy to 104 weeks or 2 years\ninflux bucket update --id a3521682726cd901 --retention 104w","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":787,"id":"4e526be1-cbe6-4833-8442-52135fc0a4f7","collection":"contentId-10926688382","type":"file","height":31}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Setup the config file for FlexDeploy to connect to influxdb.","type":"text"}]},{"type":"paragraph","content":[{"text":"Create the file /influxdb/config/fdinflux.config with the following contents, modifed appropriately for your install.","type":"text"}]},{"type":"codeBlock","content":[{"text":"INFLUXDB_URL=http://localhost:8086\nINFLUXDB_BUCKET=flexbucket\nINFLUXDB_ORG=flexdeploy","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 11. Verify Ulimit and adjust if needed (Linux only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Check your open file limits. Influx opens a large number of files to complete its work.","type":"text"}]},{"type":"paragraph","content":[{"text":"ulimit -Hn","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"paragraph","content":[{"text":"If it is less that 65536, raise it or your influxdb log will likely grow very quickly and potentially run you out of disk space.","type":"text"}]},{"type":"paragraph","content":[{"text":"sudo vi /etc/security/limits.conf","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where oracle is the user logged into the box to run FlexDeploy:","type":"text"}]},{"type":"paragraph","content":[{"text":"oracle soft nofile 16384","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"oracle hard nofile 65536","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 12. Start tomcat","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If running FlexDeploy 6.0 or higher, do not use startup.sh as this will not start the influx database. User StartFlexDeploy.sh or StartFlexDeploy.bat.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If you did not start FlexDeploy yet (as part of Step 10), then start FlexDeploy using StartFlexDeploy.sh or StartFlexDeploy.bat. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Launch FlexDeploy in your browser - http://:/flexdeploy","type":"text"}]}],"version":1}