Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel1

Overview

FlexDeploy is a Java -based web application which requires an Application server (Tomcat) and an Oracle or PostgreSQL database. FlexDeploy is accessed by Browser and can be integrated with various Directory Servers and SSO providers for Authentication and Authorization, but you can also work with an internal local security realm is also provided by FlexDeploy.

FlexDeploy uses a built-in File-System-based Artifact Repository to store build artifacts like jar, ear, war, zip etc. Build artifacts are versioned and used during deployment.

FlexDeploy connects to target servers using the SSH protocol and only requires a Temporary Working Directory and Java for execution on target servers. SSH connectivity to Windows servers is established using Cygwin, i.e. Cygwin must be installed on Windows targets. native SSH server found in Windows 2019 and higher or Cygwin for older endpoints.

FlexDeploy can be installed On-Premise or in the Cloud (AWS, Azure, Oracle, etc) and can be used to perform Build / Deploy / Test / Utility executions on targets in which are On-Premise or in the Cloud as only SSH connectivity is required. You can also use the FlexDeploy Docker container from docker hub for installation.

FlexDeploy has a plugin architecture which allows for integration with various technologies. FlexDeploy comes with many out-of-the-box plugins , but and customers are free can to developer their own plugins using the Plugin SDK.

Drawio
zoom1
simple0

...

inComment

...

0

...

pageId

...

8710361977
custContentId9745334322

...

lbox

...

1
diagramDisplayNameFlexDeploy Architecture

...

contentVer3
revision3
baseUrlhttps://flexagon.atlassian.net/wiki
diagramNameFlexDeploy Architecture
pCenter0
width969
links
tbstyle
height661

Database Tier

...

FlexDeploy requires one of the following Oracle databases, and any required license is not included with your FlexDeploy subscription.

  • Oracle XE, version 11.2, 18, 19 (although supported for production use, XE is generally used for trials and proof of concepts)
  • Oracle Standard, version 11.2, 12.1, 12.2, 18, 19
  • Oracle Enterprise, version 11.2, 12.1, 12.2, 18, 19
  • PostgreSQL 11
  • Supported platforms - Any platform supported by specific database

Application Tier

FlexDeploy requires Tomcat 9.x. You must install FlexDeploy on only one application server process (i.e. cluster is not supported).

Supported platforms

  • Microsoft Windows
  • Unix/Linux (and its variants, such as Oracle Enterprise Linux, Red Hat, Solaris, etc.) 

Target Endpoints

FlexDeploy requires SSH connectivity using User and Password or SSH Key. Additionally, some minor items are required on target endpoints.

  • Working folder for temporary files..
  • JDK 6 or higher.
  • Supported platforms
    • Microsoft Windows
    • Unix/Linux (and its variants, such as Oracle Enterprise Linux, Red Hat, Solaris, AIX etc.) 

    • Mac OS

Insert excerpt
FlexDeploy System Requirements
FlexDeploy System Requirements
nameDatabases
nopaneltrue

Application Tier

Insert excerpt
FlexDeploy System Requirements
FlexDeploy System Requirements
nameAppServers
nopaneltrue

Target Endpoints

Insert excerpt
FlexDeploy System Requirements
FlexDeploy System Requirements
nameEndpoints
nopaneltrue

High Availability Considerations

Here are some guidelines on Active Passive configuration for FlexDeploy, as running more than one server process for FlexDeploy is not yet supported. You can choose to setup Cluster for Application or Database or Both.

  • Install FlexDeploy application on two separate Physical Server or Virtual Machines.

    • Tomcat

      • Install two separate Tomcat as per Installation instructions.

      • Both installation will have configuration for JDBC connection to RAC database.

  • Setup Database cluster for FlexDeploy. This would be RAC cluster for Oracle database. Follow guidelines setup by database vendor for clustering.

  • Make sure to use JDBC connect string for database cluster nodes when defining Data Source definitions.

  • Use shared file systems for the Artifact Repository directory and the plugins subdirectory of the server Working directory, so that active node and passive node will have access to the files.

    • The Artifact Repository location is specified in the flexagon.fd.repository.root Java system property of the server.

    • The Working Directory location is specified in  the flexagon.fd.install.root Java system property of the server. There is no need to place the entire working directory on a shared file system. The requirement is for the plugins subdirectory only.

  • Configure Load Balancer to route all FlexDeploy users to Active Application Server. You can automate the process of fail over to Passive node if necessary.

  • Make sure that only one of the Application Server process is running. This is absolutely necessary even when Load Balancer is routing traffic to only one of the server.

    • This can be achieved by leaving out some configuration details on the Passive node. For example, you can omit Data Source configuration on Passive node, so that it does not start processing request if it is started by mistake.

Drawio
zoom1
simple0

...

inComment

...

0

...

pageId

...

8710361977
custContentId9745399856

...

lbox

...

1
diagramDisplayNameFlexDeploy Architecture HA

...

contentVer1
revision1
baseUrlhttps://flexagon.atlassian.net/wiki
diagramNameFlexDeploy Architecture HA
pCenter0
width1054.75
links
tbstyle
height754