The FlexDeploy™ Linux Installer Guide provides system requirements, required downloads and instructions for installing or upgrading FlexDeploy and its components on Linux and Docker.
...
| Excerpt | ||
|---|---|---|
| ||
About the automated Install/Migration toolThe flexdeployerinstaller.sh script is an automated process that reduces efforts for installing or upgrading FlexDeploy. There is a configuration file which will need to be configured for your installation, and then the installer can take over. There are three basic modes to the installer: 1) prerequisite checking with no installation or upgrade, 2) first time installation of FlexDeploy and 3) upgrading a current installation of FlexDeploy. You choose prereqs mode with the -p argument. Upgrade or install is selected by the presence of the FlexDeploy war in the webapps folder. If you are upgrading Weblogic, use the -w argument. The apache-tomcat-flexdeploy folder will be cleaned up with each upgrade, so it is important not to place any supporting files in the apache-tomcat-flexdeploy folder. Place them in the FLEXDEPLOY_HOME folder or another subfolder instead. Example of such files may include the SSO configuration file, Keystore and/or Wallet files. Versions / Release NotesThe current version is 1.0.20. You should always download the latest version before running another install or upgrade. See the Installer Release Notes for more information and to find the latest release. This automated installer will handle
This automated installer will not handle
Installer argumentsThe following arguments are available to be used:
Step by Step Guide to Using the installerStep 0: System RequirementsSee FlexDeploy System Requirements for details on software and hardware requirements. See FlexDeploy Architecture for architecture details. |
...
Configuration Property | Required | Description |
|---|---|---|
FLEXDEPLOY_HOME | Yes | This is the directory location where FlexDeploy will be installed or is already installed, the default is /u01/flexdeploy. |
FLEXDEPLOY_JAVA_HOME | Yes | This is the path to the appropriate Java JDK 8, it would for FlexDeploy. It should be the path up to bin (, but not including bin). Note that for FlexDeploy < 9.0 this is JDK 8, and for FlexDeploy 9.0+, this is Java 11 or 17. |
WORKING_DIRECTORY | No Defaults to ${FLEXDEPLOY_HOME}/application | This will be the directory location that FlexDeploy uses for temporary files to be transferred between the server and its endpoints. The default location is under FLEXDEPLOY_HOME and is named application. |
ARTIFACT_REPOSITORY_DIRECTORY | No Defaults to ${FLEXDEPLOY_HOME}/artifacts | this will be the directory location that FlexDeploy uses to store all build artifacts and retrieve deployment artifacts. The default location is under FLEXDEPLOY_HOME and is named artifacts. |
BACKUP_DATABASE_DIRECTORY | No | The directory where the database will be backed up to. This value is optional. If Oracle, this directory must already exist within the DBA_DIRECTORIES table and the DIRECTORY_PATH for the entry must exist on the file system on the Database Server. If Oracle, and BACKUP_DATABASE_DIRECTORY is blank, the DEFAULT data_pump directory is used if needed. If PostgreSQL, and BACKUP_DATABASE_DIRECTORY is provided, the database will be backed up to this local folder using the psql command, which must be available on this local host. If PostgreSQL, and BACKUP_DATABASE_DIRECTORY is blank, the database schemas will be backed up by cloning to another schema in the same database. |
INFLUXDB_PORT | No | InfluxDB port Defaults to 8086 if not specified. If running multiple influx servers on a single box, they must use different ports. |
FLEXDEPLOY_DB_PASSWORD | No | The password for fd_admin database user. The password will be prompted if not specified. |
SYSTEM_DB_USER | Yes | Usually set to system for Oracle and postgres for PostgreSQL. This user will create and update the schema definitions |
SYSTEM_DB_PASSWORD | No | The superuser / system password for the user SYSTEM_DB_USER This password is required to create and update schema definitions The password will be prompted if not specified. |
FLEXDEPLOY_PORT | No | Defaults to 8000 for standard installs, 8004 for Docker installs. If you are deploying SSL this port setting will likely not be helpful other than it sets the port that is shown in the message once FlexDeploy is running. |
MAINTAIN_EXISTING_CONTEXT_FILE | No Defaults to 1 | If 0, then the installation process will use the newly downloaded context.xml file and adjust the properties accordingly. If 1, then the installation process will save the existing context.xml and replace it after the upgrade so there are no changes to it. Set to 1 if you have changes to the context.xml file that you wish to maintain such as using a password manager for your database password in context.xml. |
MAINTAIN_EXISTING_SERVER_FILE | No Defaults to 1 | If 0, then the installation process will use the newly downloaded server.xml file and adjust the properties accordingly. If 1, then the installation process will save the existing server.xml and replace it after the upgrade so there are no changes to it. If running SSL and upgrading, 1 is likely the easiest option. From very old versions, choosing 0 and then manually modifying the file may be the easiest option. |
DATABASE_URL | Yes | Adjust the appropriate connection string for the FlexDeploy database, Oracle or Postgres. Verify that your DATABASE_URL line isn’t commented out (# at the beginning of the line) and that all other DATABASE_URL lines are commented out. Several examples are listed in the config file. |
CONTAINER_NAME | No Only used for Docker Defaults to flexdeploy | If installing FlexDeploy through Docker you can set the name of the container that will be created by editing the variable below. Defaults to 'flexdeploy' |
...
If your FlexDeploy server does not have internet access then FlexDeploy software must be downloaded from the Flexagon Support Site and the downloaded zip file must be saved to $FLEXDEPLOY_INSTALLER_HOME/downloads/software (don't unzip).
Step 4.2: Influx database (conditional)
If you are installing/upgrading FlexDeploy to version 6.0+ then keep reading otherwise skip to next step. If your FlexDeploy server does not have Internet access, the software and the client must be downloaded and gzip files must be saved to $FLEXDEPLOY_INSTALLER_HOME/downloads/influxdb (don't extract them).
Step 5: Check the Prerequisites
...
| Warning |
|---|
08/26/2022 12:01:20 PM Error occurred ############################### ISSUE 105 ########################################################## For FlexDeploy 9.0, it must be Java 11 or 17. RESOLUTION: Please update the flexdeployinstaller_config.txt file for the installation. #################################################################################################### |
...