Install FlexDeploy on AWS cloud server

For the AWS cloud server, you’ll need to change the source of the cloud module. This is in the main.tf file in the root directory. For AWS it should look like this:

module "cloud" { source = "./modules/aws" ...

Setup inputs for terrafrom.tfvars

Inputs can be supplied using any of the methods supported by Terraform. However, we recommend using the .tfvars method. The following examples will use that format.

Provider-specific

The provider you have selected will require certain inputs unless you are running locally in which case you do not need any of these inputs.

For AWS you need these:

aws_access_key = "EXAMPLEEXAMPLEEXAMPLE" aws_secret_key = "EXAMPLEEXAMPLEEXAMPLEEXAMPLEEXAMPLEEXA+MPLE"

optionally you can select the region. Default is us-east-1.

aws_region = "us-east-1"

SSH keys

SSH Keys can be provided or can be generated for you. We recommend you provide them so you can keep track of your own key. Here’s what it would look like to input a public and private key (both are required):

If you want to have them generated for you, you can do so like this (again not recommended):

Database Options

db_type is the type of database. Currently only supports ‘Postgres and ‘oracle’. Oracle requires the database and ojdbc files to be in the software folder. More on this under system requirements or below note. Default is Postgres.

db_password is the password for an administrator user for the database.

db_fd_admin_password is the password for the fd_admin user for the database.

db_port is which port the database will listen on. Recommended to be 5432 for Postgres and 1521 for Oracle. Default is 5432.

If you want to use the Oracle database, you need to have both the ojdbc8-full.tar.gz and LINUX.X64_193000_db_home.zip files located in a folder called software in the root directory of the script. ojdbc drivers are version 8. Database install is Oracle 19.3, Linux x64 version.

Example of database configuration for Postgres:

Example for Oracle:

Instance Options

fd_version the version of FlexDeploy. Usually, the latest is recommended. This is required.

fd_install_directory is where FlexDeploy should be installed to. Defaults to /u01/flexdeploy.

fd_repository_directory is where the FlexDeploy artifact repository is located. Defaults to /u01/flexdeploy/artifacts.

db_install_directory. Directory where to install the database. Default is /u02/database.

db_data_directory. Directory where to keep the data for the database. Default is /u03/dbdata.

install_temp_directory is where temporary files will be stored for installation. Defaults to /var/tmp/fdinstall.

use_one_instance will choose whether or not to install the database on the same instance as FlexDeploy. We do not recommend this for production environments. Default is false.

execute_locally chooses whether or not to install FlexDeploy locally. This is not recommended for production environments, since it installs both the database and FlexDeploy on the same instance.

is_windows chooses whether or not this is installing on windows. If you choose this it will work locally. Not recommended since this will install database and FlexDeploy on the same instance.

existing_instance_hostname is the hostname for an existing instance. If this option is set, it will execute against this hostname.

existing_database_hostname is the hostname for a database instance. If this option is set database install will execute against this instance.

admin_user is the admin user for the local install. Only required when executing locally.

Example with only required inputs:

More complex example:

Putting it together

Here are a few examples of all of this put together in terraform.tfvars

For AWS with Postgres:

Terraform commands to run

Place those options inside of a file called terraform.tfvars inside of the root directory of the script.

now that the input variables are all set, we will first run

to set up terraform. Next, we will run

This will output showing everything that will be created. It will look similar to this for aws install:

 

Read over this and make sure you are ok with all of these resources being created.

Next, we can run:

This will run the script and install everything necessary.

This can take quite some time to run depending on the specific configuration so please be patient.

Once it’s done you should see outputs that look similar to this:

 

You can see the URL to connect to FlexDeploy. Then you should be all set to launch FlexDeploy.

If something does not work correctly, or you are just done using this FlexDeploy instance you can run the following:

This will destroy anything created in the cloud. It will not however undo any changes to existing servers.

Launch FlexDeploy

Launch FlexDeploy in your browser with the URL

  • http://hostname:8000/flexdeploy

  • You will need to complete Initial Registration process, where you will create admin user for login.

  • Go to Administration - Plugins on FlexDeploy. Verify that Plugins are loaded.

 

The following macros are not currently supported in the footer:
  • style