Versions Compared

Key

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

The FlexDeploy™ Installation Guide provides system specifications and instructions for installing FlexDeploy and its components.  

Table of Contents
maxLevel2

FlexDeploy Architecture

FlexDeploy is a Java-based web application which requires an application server and an Oracle database.

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 (although supported for production use, XE is generally used for trials and proof of concepts)
  • Oracle Standard, version 11.2
  • Oracle Enterprise, version 11.2
  • Oracle Standard, version 12.1
  • Oracle Enterprise, version 12.1

Application Tier

FlexDeploy requires one of the following application servers. You must install FlexDeploy on only one application server process.

  • WebLogic 12.1.3 (license is not included with your FlexDeploy subscription)
  • Tomcat 8.x

Platform Support

  • Microsoft Windows
  • Unix/Linux (and its variants, such as OEL, RedHat, Solaris, etc.)
Info
titleWindows Quick Start Installer

The Windows Quick Start Installer provides an executable for getting FlexDeploy up and running in less than 15 minutes. This is a good option for users who want to download and try out FlexDeploy. With the Windows Quick Start Installer, Oracle XE must be installed on the same Windows host prior to running the installer.

See FlexDeploy Architecture for architecture details.

Tip

See FlexDeploy System Requirements for details on software and hardware requirements.

Table of Contents
maxLevel2

Downloading FlexDeploy

For customers with active subscriptions, FlexDeploy can be downloaded from the Flexagon Support Site.

For users wishing to install the FlexDeploy Community Edition , or to request a trial version of FlexDeploy Standard/Enterprise Edition, please (free), you can contact us through our website or download the software directly here.

FlexDeploy System Requirements

Database Tier Requirements

FlexDeploy requires one of the following databases to be installed and running.

  • Oracle XE, version 11.2
  • Oracle Standard, version 11.2
  • Oracle Enterprise, version 11.2
  • Oracle Standard, version 12.1
  • Oracle Enterprise, version 12.1

Application Tier Requirements

Working Directory

FlexDeploy uses a working directory for temporary files to be transferred between the server and its endpoints. This directory needs to have at least 4GB of space available on the FlexDeploy Server.

  • As this file system contains only temporary files, there is no reason to backup this directory.
  • Availability of space within the server working directory is critical to functioning of the FlexDeploy platform. Therefore, the filesystem should be monitored and space should be allocated as necessary. In addition, it is recommended that this be a separate mount point.
  • Files in this directory which are older than one day will be purged automatically to help effectively manage the size.

Artifact Repository

The FlexDeploy artifact repository is a directory available on the FlexDeploy server where all build artifacts are stored, and later retrieved for the deployments. This directory needs to have at least 10GB of space available on the FlexDeploy Server.

  • Due to the importance of the artifact repository, this file system should be backed up regularly.
  • Availability of space within the Artifact Repository is critical to the creation of new build versions. It is highly recommended to have a file system size monitor in place for this directory, and size should be adjusted based on the number of builds created, and the size of the artifacts produced. In addition, it is recommended that this be a separate mount point.

Application Server

FlexDeploy is Java web-based application, you can setup either WebLogic or Tomcat to install FlexDeploy.

WebLogic

Tomcat

Endpoint Requirements

An Endpoint is a target server where FlexDeploy can perform build or deploy activities. Endpoints are configured within the FlexDeploy UI. See following requirements for each Endpoint.

Requirements

  • JDK version 1.6 or higher
  • Disk space on each endpoint of 4GB. There is no need to monitor this file system as FlexDeploy will automatically perform cleanup.
  • Operating Systems

    • Microsoft Windows. For Windows endpoint, cygwin must be installed on target see FlexDeploy Cygwin Install Guide.
    • Unix/Linux (and its variants, such as OEL, RedHat, Solaris, AIX, etc.)

Installation Instructions

On-Premise or PaaS Installation

  1. Installation Instructions - Database Tier
  2. Installation Instructions - Application Tier
  3. Endpoint Configuration
  4. Loading FlexDeploy Plugins

...

Installation Instructions

Tip

FlexDeploy Installation with Tomcat is recommended option for installation.

FlexDeploy Installation with included Tomcat

This allows for very quick installation as Tomcat is already included and you just have to update few minor configurations.

  1. Installation Instructions - Database Tier (select one option)
  2. Create Folders for FlexDeploy Server
  3. Installing FlexDeploy with Tomcat

On-Premise or Cloud(IaaS) Installation

  1. Installation Instructions - Database Tier (select one option)
  2. Create Folders for FlexDeploy Server
  3. Installation Instructions - Application Tier (select one option)

FlexDeploy Zip Installer (Windows)

This allows for very quick installation as Tomcat is already included and PostgreSQL is setup. This is supported only on Windows platform. See Running FlexDeploy with embedded database on Windows.

Oracle Java Cloud Service (PaaS) Installation

See Oracle Java Cloud Service Installation. Make sure to use WebLogic 12.1.3 version.

  1. Creating an Oracle Database Cloud Service Instance
  2. Creating an Oracle Java Cloud Service Instance
  3. Installation Instructions - Database Tier - Oracle
  4. Create Folders for FlexDeploy Server
  5. Installation Instructions - Application Tier
  6. Endpoint Configuration

Windows Quick Start Installation

...

FlexDeploy Docker Images

FlexDeploy docker images can be downloaded directly from docker hub. See Installation Instructions - Docker Images for details.

FlexDeploy Virtual Box Image

Virtual Box Image (ova) file with FlexDeploy is also available to quickly start trial of FlexDeploy. If you are interested in FlexDeploy VM Image, please contact us through our website or download it here. See Using FlexDeploy VM Image for details on how to use VM Image.