{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The FlexDeploy distribution contains the following components:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A tomcat 9 server with required libraries, and base configurations","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The FlexDeploy WAR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The FlexDeploy database installation scripts","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The FlexDeploy database migration scripts (for upgrading an existing FlexDeploy Tomcat installation)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The FlexDeploy plugins","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 Linux installer","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"/wiki/spaces/SHAR/pages/10125805231"}}]},{"text":" instead.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Requirements ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"FlexDeploy System Requirements","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/FD65/pages/10125805076"}}]},{"text":" for details on software and hardware requirements","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installation Instructions","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":"b469fce0856d4668103a00896e233bd4"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"478739c6-0b76-4828-bc10-e65cf76246e2"}},{"type":"paragraph","content":[{"text":"Adjust for Windows path if you are installing on Windows platform.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 1. Ensure Java 8 is installed on the server.","type":"text"}]},{"type":"paragraph","content":[{"text":"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. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":727,"id":"0da5466f-ca93-42aa-ba5c-bee25cc599a1","collection":"contentId-10125805590","type":"file","height":164}}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 2. Prepare software","type":"text"}]},{"type":"paragraph","content":[{"text":"FlexDeploy can be downloaded from the ","type":"text"},{"text":"Flexagon Support Site","type":"text","marks":[{"type":"link","attrs":{"href":"http://support.flexagon.com"}}]},{"text":". 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.","type":"text"}]},{"type":"paragraph","content":[{"text":"Extract the zip file in the desired location (referred to as \"","type":"text"},{"text":"FLEXDEPLOY_HOME","type":"text","marks":[{"type":"strong"}]},{"text":"\" in this document). See example below, where zip was extracted in ","type":"text"},{"text":"/u01/flexdeploy","type":"text","marks":[{"type":"strong"}]},{"text":" folder.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"We recommend use of folder structure without any space in name.","type":"text"}]}]},{"type":"codeBlock","content":[{"text":"cd /u01\nmkdir -p flexdeploy\ncd flexdeploy\nunzip /Tomcat_Complete-X.X.X.X.zip","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is how it will look like after unzip.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":75.0},"content":[{"type":"media","attrs":{"width":725,"id":"3fa66cb2-0ed4-4ec9-be1a-db6b72a59ad3","collection":"contentId-10125805590","type":"file","height":274}}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 3. Setup database and schemas","type":"text"}]},{"type":"paragraph","content":[{"text":"Setup the appropriate database, if you not already done so.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://flexagon.atlassian.net/wiki/spaces/FD65/pages/10125805812"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://flexagon.atlassian.net/wiki/spaces/FD65/pages/10125805844"}},{"text":" ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 4. Update Tomcat context.xml","type":"text"}]},{"type":"paragraph","content":[{"text":"Modify Tomcat configuration file (context.xml) for database connectivity depending on your database type.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace the contents of context.xml with the contents the context-.xml if using PostgreSQL.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace URL and Password with the actual values.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"File - ","type":"text"},{"text":"/apache-tomcat-flexdeploy/conf/context.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example JDBC URL (CONNECT_STRING)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Oracle","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The JDBC short format of host:sid:port should not be used. URL must be in the format listed below as we are requiring use of UCP based connection pooling.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example - ","type":"text"},{"text":"jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=tcp)(HOST=**HOSTNAME**)(PORT=**PORT**)))(CONNECT_DATA=(SERVICE_NAME=**SERVICE_NAME**)))","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If RAC is used for the database, multiple nodes can be listed in the address list of the URL or it can point to the scan listener for the cluster. See below sample URL for a RAC implementation that has a primary and secondary scan listener connecting to to a service name GOLD-CLOUD. This includes connection timeout, retry, and retry delay settings.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example - ","type":"text"},{"text":"jdbc:oracle:thin:@(DESCRIPTION = CONNECT_TIMEOUT=120) (RETRY_COUNT=20) (RETRY_DELAY=3) (TRANSPORT_CONNECT_TIMEOUT=3) (ADDRESS_LIST =(LOAD_BALANCE=on) (ADDRESS = (PROTOCOL = TCP) (HOST=primary-scan) (PORT=1521))) (ADDRESS_LIST =(LOAD_BALANCE=on) (ADDRESS = (PROTOCOL = TCP) (HOST=secondary-scan) (PORT=1521))) (CONNECT_DATA=(SERVICE_NAME = gold-cloud)))","type":"text","marks":[{"type":"code"}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PostgreSQL","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Syntax - jdbc:","type":"text"},{"text":"postgresql://hostname:port/","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":"flexdeploy","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example - ","type":"text"},{"text":"jdbc:","type":"text","marks":[{"type":"code"}]},{"text":"postgresql://dkrlp01:5432/flexdeploy","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are using database name other than flexdeploy, then update URL accordingly.","type":"text"}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Follow the instructions provided ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD60/pages/9856624996"}}]},{"text":" to connect to Oracle Autonomous databases.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Oracle","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"PostgreSQL","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 5. (Optional) Update Tomcat server.xml","type":"text"}]},{"type":"paragraph","content":[{"text":"Modify Tomcat server.xml if necessary. If you want to use different port or setup https, the you would need to update server.xml.","type":"text"}]},{"type":"paragraph","content":[{"text":"File - ","type":"text"},{"text":"/apache-tomcat-flexdeploy/conf/server.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"By default, the Tomcat server is configured to run on port 8000. If this port is in use, change to some other unused port. Search for ","type":"text"},{"text":"/apache-tomcat-flexdeploy/bin/setenvoverride.sh","type":"text","marks":[{"type":"strong"}]},{"text":" (setenvoverride.bat on windows). Main reason to modify this file is to configure specific JAVA_HOME. Other variables can be left as is for default configurations. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure variable ","type":"text"},{"text":"JAVA_HOME","type":"text","marks":[{"type":"strong"}]},{"text":" to use specific version of Java for FlexDeploy tomcat process.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Following other variables are recommended to be left unchanged from default.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure variable ","type":"text"},{"text":"FD_APPLICATION_DIRECTORY","type":"text","marks":[{"type":"strong"}]},{"text":" with directory to use as the FlexDeploy application directory (See ","type":"text"},{"text":"System Requirements","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/FD65/pages/10125805076"}}]},{"text":" for more information about how much space is needed.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure variable ","type":"text"},{"text":"FD_REPOSITORY_DIRECTORY","type":"text","marks":[{"type":"strong"}]},{"text":" with the directory to host the FlexDeploy artifact repository (See ","type":"text"},{"text":"System Requirements","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/FD65/pages/10125805076"}}]},{"text":" for more information about how much space is needed.)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Below are default artifact and working directories created under FLEXDEPLOY_HOME when you extracted zip file.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":726,"id":"5252640e-b8d6-4d41-bda5-3976457d8fba","collection":"contentId-10125805590","type":"file","height":340}}]},{"type":"paragraph","content":[{"text":"Default setenvoverride.sh is shown below.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":727,"id":"ac29e000-7cfb-4825-a716-51ef3cf3f2cd","collection":"contentId-10125805590","type":"file","height":457}}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"Modify Tomcat Environment script (setenvoverride.sh or setenvoverride.bat) for JAVA_HOME.","type":"text"}]},{"type":"paragraph","content":[{"text":"File - ","type":"text"},{"text":"/apache-tomcat-flexdeploy/bin/setenvoverride.sh","type":"text","marks":[{"type":"strong"}]},{"text":" (setenvoverride.bat on windows)","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If JAVA_HOME is already set in your environment, you can skip this step.","type":"text"}]},{"type":"paragraph","content":[{"text":"Unix Example - JAVA_HOME=/u01/java/jdk1.8.0_121","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows Example - set JAVA_HOME=c:/installs/Java/jdk1.8.0_121","type":"text"}]}]},{"type":"paragraph","content":[{"text":" If you were also setting JAVA_HOME, this file would look like this.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":727,"id":"2ad1d0c0-fc5a-4050-9324-ce9472109be0","collection":"contentId-10125805590","type":"file","height":459}}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 7. Update database driver (Only if using Oracle Database)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the latest Oracle JDBC 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":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Be sure to download the JDBC driver matching your Oracle Database version and one which is compiled and compatible with JDK8. If you download the driver which is compiled with a newer JDK you will get errors on server startup similar to the following:","type":"text"}]}]},{"type":"codeBlock","content":[{"text":"Caused by: java.lang.UnsupportedClassVersionError: oracle/jdbc/OracleClob has been compiled by a more recent version of the Java Runtime \n (class file version 54.0), this version of the Java Runtime only recognizes class file versions up to 52.0\n\tat java.lang.ClassLoader.defineClass1(Native Method)\n\tat java.lang.ClassLoader.defineClass(ClassLoader.java:756)\n\tat java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clean up old ojdbc jars from ","type":"text"},{"text":"\\apache-tomcat-flexdeploy\\lib","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save new driver jars","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"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":"listItem","content":[{"type":"paragraph","content":[{"text":"UCP is now required for Oracle Database connections.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Linux","type":"text"}]},{"type":"codeBlock","content":[{"text":"unzip /ojdbc8-full.zip\n\ncd $FLEXDEPLOY_HOME/apache-tomcat-flexdeploy/lib\nrm ojdbc*.jar\ncd ..\nmkdir -p libext\ncd libext\ncp /ojdbc-full/*.jar .","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","content":[{"text":"unzip \\ojdbc8-full.zip\n\ncd %FLEXDEPLOY_HOME%\\apache-tomcat-flexdeploy\\lib\ndel /f ojdbc*.jar\ncd ..\nmkdir libext\ncd ..\\libext\ncopy \\ojdbc-full\\*.jar .\n","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Please put any extra libraries required inside of ","type":"text"},{"text":"/apache-tomcat-flexdeploy/libext","type":"text","marks":[{"type":"strong"}]},{"text":" not ","type":"text"},{"text":"/apache-tomcat-flexdeploy/lib","type":"text","marks":[{"type":"strong"}]},{"text":". You may need to create this directory.","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 8. Set execute permission (Linux only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Set the shell scripts executable with this command.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"chmod +x $FLEXDEPLOY_HOME/apache-tomcat-flexdeploy/bin/*.sh\nchmod +x $FLEXDEPLOY_HOME/*.sh","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 9. Adjust for non-default server side directories","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Skip this step if you did not modify setenvoverride for FD_APPLICATION_DIRECTORY in ","type":"text"},{"text":"Step 6","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If you are using non-default server side directories, then move all the jar files from /application/plugins to FD_APPLICATION_DIRECTORY/plugins. At startup, FlexDeploy will load all the plugins.","type":"text"}]},{"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"}]}]}]},{"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":"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":"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, we recommend raising it.","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":3},"content":[{"text":"Windows","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"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":"textColor","attrs":{"color":"#ff5630"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Linux","type":"text"}]},{"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.sqlite","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Windows","type":"text"}]},{"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.sqlite","type":"text"}]}]}]},{"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. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"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.","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","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.\nset INFLUX_DB_TOKEN= \necho %INFLUX_DB_TOKEN% > application\\vsm\\.token\nStartFlexDeploy.bat","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Once influx and tomcat servers are up, we need to run setup on the influx database.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":725,"id":"e15d7ed3-40da-4875-b19d-a06bf890e46a","collection":"contentId-10125805590","type":"file","height":235}}]},{"type":"heading","attrs":{"level":3},"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./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":"heading","attrs":{"level":3},"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\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\n# 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":"558f41de-29bf-444d-9e90-02331694a32d","collection":"contentId-10125805590","type":"file","height":31}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Note for Oracle XE Database","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"After starting your server, check the ","type":"text"},{"text":"/apache-tomcat-flexdeploy/logs/flexdeploy.0.log ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"file for the following error message:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ORA-12519, TNS:no appropriate service handler found","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If present, increase the number of processes for the database","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using SQLPlus update processes setting.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"alter system set processes=200 scope=spfile;","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stop Tomcat","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restart the XE Database","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start Tomcat","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 12. Launch FlexDeploy in your browser.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"http://","type":"text"},{"text":"hostname","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":":8000/flexdeploy","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update hostname in URL to indicate host where FlexDeploy is installed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update port if you had modified server.xml for different port number.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You will need to complete ","type":"text"},{"text":"Initial Registration","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/FD60/pages/9856634377"}}]},{"text":" process, where you will create admin user for login.","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 13. Verification","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to Administration - Plugins on FlexDeploy. Verify that Plugins are loaded. You should not see any files remaining in ","type":"text"},{"text":"FD_APPLICATION_DIRECTORY","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"/plugins","type":"text","marks":[{"type":"strong"}]},{"text":" folder after a few minutes.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 14. FlexDeploy configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Now that you have installed FlexDeploy, let's get start with configuration. You can do this in matter of minutes by using ","type":"text"},{"text":"Blueprints","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/FD65/pages/10125807169"}}]},{"text":" concept, which is very simple configuration wizard for most common usecases.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Related Topics","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"children","parameters":{"macroParams":{"page":{"value":"Advanced"}},"macroMetadata":{"macroId":{"value":"943217fccbeb97be607296db9b854195"},"schemaVersion":{"value":"2"},"title":"Children Display"}},"localId":"78824c38-23c6-4a3a-96eb-9fc258d5eeed"}},{"type":"paragraph"}],"version":1}