Versions Compared

Version Old Version 11 New Version 12
Changes made by

Karl Henselin

Karl Henselin

Saved on

Key

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

The FlexDeploy™ Linux Installer Guide provides system requirements, required downloads and instructions for installing or upgrading FlexDeploy and its components.

Table of Contents
maxLevel2
Excerpt
nameAbout

About the automated Install/Migration tool

The flexdeployerinstaller.sh script is a new automated process that reduces customer efforts in installing or upgrading FlexDeploy, which will make staying up to date on FlexDeploy versions easier.  The installer will take care of installation or upgrade of FlexDeploy with no manual intervention required.  There is a configuration file which will need to be modified 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.

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.

Versions / Release Notes

The current version is 1.0.5. You should always download the latest version before running another install or upgrade.

See the Installer Release Notes for more information.

This automated installer will handle

  • executing prerequisite checks to ensure the installation/upgrade will be successful

  • downloads of FlexDeploy software and influx database software if the VM has access to the Internet

  • installation of or upgrading to FlexDeploy 5.7.0.12 or higher.

  • upgrading from version 5.2.0.0 or higher.

  • backing up the current FlexDeploy installation, plugins, and optionally artifacts before upgrading

  • backing up the database before upgrading (optional)

  • creating or migrating the FlexDeploy database schemas

  • installation or configuration of the influx database which is used for reporting and dashboard data for FlexDeploy version 6.0 and higher.

This automated installer will not handle

  • downloads of software if the VM has no access to the Internet. In this case, the files need to be placed on the FlexDeploy server in locations specified by the installer

  • download of security wallets

  • upgrading from FlexDeploy versions older than 5.2.0.5

  • upgrading a Kubernetes installation

See FlexDeploy Architecture for architecture details.

Installer arguments

The Argument c must be the last argument specified.

The following arguments are available to be used:

  • -p run the installer in the prerequisite checking mode with no installation/upgrade occurring.  The execution of this checking will not do anything with the current installation, so it can be run anytime.  If the installer detects any issue(s), the issue will be reported to the logs and displayed on the screen.  The prerequisites will also be run during the installation or upgrade process and may stop the process, which is why it is recommended to run this mode until there are no issues being reported.  Each issue that is reported will have a possible resolution to the issue to assist you in resolving it.  Some of the checks are: verify file system sizes to make sure all required directories have at least the minimum amount, flexdeployinstaller_config.txt file properties are set, java is at the right level, etc. Removing this argument will execute the install/upgrade.

  • -v version Tells the installer what version to install. Previously this was mentioned in the config file. It was moved here so that it is easier to ensure what version will be installed. (Added in version 1.0.5 of the installer.) You can specify versions as 4 numbers separated by periods, or the word latest.

    • 6.5.0.0

    • 6.0.0.4

    • 5.7.0.12

    • latest

  • -c<path to>/flexdeployinstaller_config.txt points the installer to the flexdeployinstaller_config.txt file that contains the user configurations.  The file should not be saved under the flexdeployinstaller folder.  It is always required.

  • -s there are several passwords in the flexdeployinstaller_config.txt file and if a password field is left blank, in this scenario, a prompt for the password will happen (nothing will be stored) and the password is not shown on the screen, similar to other Linux password prompts.  The -s option will show the password on the screen as you type.

  • -i skip the database backup. This can be done if you have an existing database backup.

  • -a skip the artifacts backup. This can be done if you have an existing backup of the artifacts folder or a snapshot of the VM.

  • -d Install as a docker container.

  • -w Specify that you are upgrading from a Weblogic install to a Tomcat install. Not compatible with the -d option.

Step by Step Guide to Using the installer

Step 0: System Requirements

Info

See FlexDeploy System Requirements for details on software and hardware requirements

...

Install the Oracle Database binaries and find your jdbc connection string. The automated installer will create FD, FF, and FD_ADMIN schemas in the USERS tablespace.

Excerpt
namestep2

Step 2: Get the Installer
Anchor
Get
Get

Download flexdeployinstaller.zip and get it to the FlexDeploy server. You can wget it there directly if you have Internet access, or transfer the file from another machine.

Code Block
wget -O flexdeployinstaller.zip https://flexagon.com/downloads/flexdeployinstaller

If you don’t have wget, and must use curl, use the -L argument like:

Code Block
curl -L --max-redirs 5 https://flexagon.com/downloads/flexdeployinstaller --output flexdeployinstaller.zip

Once downloaded, select a directory (ex. /u01 or /u02) to unzip the flexdeployinstaller.zip.

Change directory to your selected directory and unzip the flexdeployinstaller.zip download.  If this isn't the first time unzipping the installer, select [A]ll on the replacement question.

Code Block
languagebash
cd <FLEXDEPLOY_INSTALLER_HOME>
unzip <path to flexdeployinstaller download>/flexdeployinstaller.zip

From the FLEXDEPLOY_INSTALLER_HOME directory, change directory to flexdeployinstaller_X.X.X to provide execution permission to the script.

Make sure the user that will run FlexDeploy has access to run the script. That user should execute the script.

Code Block
languagebash
cd flexdeployinstaller_X.X.X
chmod +x flexdeployinstaller.sh

...

If your FlexDeploy VM doesn't have access to the Internet, the FlexDeploy software can be downloaded from the Flexagon Support Site and the downloaded zip file must be saved to FLEXDEPLOY_INSTALLER_HOME/downloads/software (don't unzip).

Code Block
languagebash
cp /path to FlexDeploy software download/Tomcat_Complete-*.zip ${FLEXDEPLOY_INSTALLER_HOME}/downloads/software

Step 4.2: Influx database (conditional)

If you are installing/upgrading FlexDeploy with version 6.0+ and your FlexDeploy VM has access to the Internet, the flexdeployinstaller.sh will pull the required version of the software and client from the influx data website.

If you are installing/upgrading FlexDeploy with version 6.0+ and your FlexDeploy VM doesn't have access to the Internet, the software and the client must be downloaded from the influx data website using the embedded links.  The 2 downloaded gzip files must be saved to FLEXDEPLOY_INSTALLER_HOME/downloads/influxdb (don't extract them). This only needs to be downloaded once.

Code Block
languagebash
cp /path to influx database download/influxdb2*tar.gz ${FLEXDEPLOY_INSTALLER_HOME}/downloads/influxdb

...