{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"1"}},"macroMetadata":{"macroId":{"value":"45cc3dbc-4897-4b61-af8d-9360aaa09219"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"8a4b28ac-96e2-49a4-825d-6dce2c03d894"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Database Tier Requirements","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"Databases"}},"macroMetadata":{"macroId":{"value":"232b5c54e91452487b096dec0c4db9a1"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"e4ffa0da-d9da-4acd-93cf-2722eda40e69"},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported Platforms","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft Windows","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unix/Linux (and its variants, such as OEL, RedHat, Solaris, AIX, etc.)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported Databases","type":"text"}]},{"type":"paragraph","content":[{"text":"FlexDeploy requires one of the following databases to be installed and running.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PostgreSQL 11, 12, 13, 14","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Requires a user with CreateDB privileges or superuser privileges. Prior to FlexDeploy 6.0.0.2, superuser was required.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Oracle XE, version 18, 19, 21 with OJDBC8 <=19 driver","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Oracle Standard, version 12.1, 12.2, 18, 19, 21 with OJDBC8 <=19 driver","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Oracle Enterprise, version 12.1, 12.2, 18, 19, 21 with OJDBC8 <=19 driver","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Requirements","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"4 to 8 GB of RAM for the system.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Oracle database - 2GB SGA should be sufficient.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1 or 2 CPU","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At least 20 GB of available space, may need additional space based on ","type":"text"},{"text":"purge ","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10340172599"}}]},{"text":"criteria and usage. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We recommend approximately 125GB total disk space should be sufficient for database tier (On-Premise or Cloud - Virtual or Physical Server). This includes space for Operating System, database software as well.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Normal database backup procedures should be followed outside of the FlexDeploy Application. Backing up of this database is not included in FlexDeploy.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Application Tier Requirements","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"AppServers"}},"macroMetadata":{"macroId":{"value":"8e0f52c90953259360ca7294897b48ef"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"f7c7361c-63f0-4650-8b4b-21aff32baebd"},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported Platforms","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unix/Linux (and its variants, such as OEL, RedHat, Solaris, AIX, HP-UX etc.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft Windows","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported Application Servers and Requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"FlexDeploy is a Java web-based application which runs on Tomcat 9.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tomcat 9.0.64 is included with FlexDeploy download media. You do not have to separately install Tomcat because it is included in all downloads.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"8GB of RAM","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1+ CPU","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At least 16384 available file descriptors (ulimit).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JDK 8 installed","type":"text"}]}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"JDK Options"}},"macroMetadata":{"macroId":{"value":"441c5c5d1a0c11751404f54d69271c6e"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"2702abc6-401b-4aaa-9b1e-9e0a99964416"}},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optional - consider ","type":"text"},{"text":"Java Cryptography Extension (JCE) unlimited strength policy files","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.oracle.com/java/technologies/javase-jce8-downloads.html"}}]},{"text":" to avoid SSH issues when using strong ciphers.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can allocate 4GB space for install of Tomcat with FlexDeploy. This includes space for logs that will be generated during execution of application. See additional disk requirements below.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time series database InfluxDB is installed as part of installation process for Metrics and Insights. ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Disk Requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"We recommend approximately 125GB total disk space should be sufficient for application tier (On-Premise or Cloud - Virtual or Physical Server). This includes space for Operating System, FlexDeploy software as well.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Application Directory","type":"text"}]},{"type":"paragraph","content":[{"text":"FlexDeploy uses an ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"application directory","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" (aka working directory) for temporary files to be transferred between the server and its endpoints. This directory needs to have at least ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"15GB","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" of space available on the FlexDeploy Server. This directory also contains the time series data stored by InfluxDB for Metrics and Insights shown in FlexDeploy","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"As this file system contains only temporary files, and plugin files, there is no reason to backup this directory.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Automated purge process for working directory","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3 Plugin Jar versions will be kept.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Temporary Files (work folder) in this directory which are older than one day will be purged automatically to help effectively manage the size.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Plugin Jars are stored in this directory","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Artifact Directory","type":"text"}]},{"type":"paragraph","content":[{"text":"The FlexDeploy ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"artifact repository","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" 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 ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"10GB","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" of space available on the FlexDeploy Server.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Due to the importance of the artifact repository, this file system should be backed up regularly.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Source Control Requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"FlexDeploy provides out of the box integration with the following Source Control Management Systems.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Subversion","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Git","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft TFS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Perforce","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CVS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PVCS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Surround SCM","type":"text"}]}]}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"SCM"}},"macroMetadata":{"macroId":{"value":"3ba11181cc068d6711a72e2e78ed0751"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"ee497a8a-9431-4b81-ba86-d446ccbb3193"},"content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"SCM Client Requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"To use Git, The Git executable must be installed on the FlexDeploy server & build endpoints, and it must be accessible in its PATH. The Git executable version must be 1.7.9 or higher.","type":"text"}]},{"type":"paragraph","content":[{"text":"To use PVCS, the pcli executable must be installed on the FlexDeploy server & build endpoints, and it must be accessible in its PATH.","type":"text"}]},{"type":"paragraph","content":[{"text":"To use Surround, the Surround SCM executable must be installed on the FlexDeploy server & build endpoints, and it must be accessible in its PATH. The Surround SCM version must be 2018.2.0 or higher.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Endpoint Requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"An Endpoint is a target server where FlexDeploy can perform build or deploy activities. Endpoints are configured within the FlexDeploy UI.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported Platforms","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unix or Microsoft Windows operating system.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Windows Server 2019+ supports native OpenSSH","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For other Windows servers, Cygwin must be installed along with the openssh package. See the ","type":"text"},{"text":"Cygwin Installation Guide","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10340181471"}}]},{"text":" for more information.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Many Unix/Linux (variants, such as OEL, RedHat, Solaris, AIX, HP-UX, ubuntu etc.) are supported","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Endpoint Requirements","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"Endpoints"}},"macroMetadata":{"macroId":{"value":"746592962a662bedb6209a786c5f9b30"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"b3875a16-037b-4320-84c0-647e04833785"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JDK version 1.6 or higher must be installed. Java 7, 8, and 11 is supported for Endpoints. See ","type":"text"},{"text":"Plugin Java Requirements","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/SHAR/pages/10176823301"}}]},{"text":" for details.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Typically FlexDeploy references the actual JAVA_HOME folder, or the java version that is used by the technology that is being deployed (if any)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The JDK Home can be a symlink if desired to make Java upgrades easier. A symlink is not required or preferred by FlexDeploy, but works.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Windows, a symlink can be created with the ","type":"text"},{"text":"mklink /D ","type":"text","marks":[{"type":"em"}]},{"text":" command where ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":" is set as JDK Home in the endpoint settings of FlexDeploy, and ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":" is the actual Java install location.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the Java install path is changed, then use ","type":"text"},{"text":"rmdir ","type":"text","marks":[{"type":"em"}]},{"text":" to delete the symlink. Then recreate the symlink with the new ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":" folder.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Unix, a symlink can be created with the ","type":"text"},{"text":"ln -sT ","type":"text","marks":[{"type":"em"}]},{"text":" command where ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":" is set as JDK Home in the endpoint settings of FlexDeploy, and ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":" is the actual Java install location.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the Java install path is changed, then use ","type":"text"},{"text":"rm ","type":"text","marks":[{"type":"em"}]},{"text":" to delete the symlink. Then recreate the symlink with the new ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":" folder.","type":"text"}]}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Some plugins require newer versions of Java. Please see the plugin guides for this information.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Disk space on each endpoint of ","type":"text"},{"text":"4GB","type":"text","marks":[{"type":"strong"}]},{"text":" to be used as temporary working directory. You can start with 1GB space and expand as necessary.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"There is no need to monitor this file system as FlexDeploy will automatically perform cleanup.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Local disk storage is preferable, but a shared file system can be used.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"As this file system contains only temporary files, there is no reason to backup this directory.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Files in the working directory are transient in nature and will be purged by FlexDeploy after one day. The actual size of the directory will depend on the number of projects and deployments, but 1GB is a good starting point.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure that there is no scheduled purge job setup on endpoint working directory. FlexDeploy will automatically manage this folder","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally, ","type":"text"},{"text":"rsync","type":"text","marks":[{"type":"link","attrs":{"href":"https://rsync.samba.org/"}}]},{"text":" can be installed on ","type":"text"},{"text":"BOTH","type":"text","marks":[{"type":"strong"}]},{"text":", the endpoint and the FlexDeploy host and ","type":"text"},{"text":"expect","type":"text","marks":[{"type":"link","attrs":{"href":"https://core.tcl-lang.org/expect/index?name=Expect"}}]},{"text":" can be installed on the FlexDeploy host if you wish to use the rsync protocol to transfer files instead of using scp. SCP is the default transfer method.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SSH connectivity from FlexDeploy application tier using one of the following options","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User & Password","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User & Password with sudo","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SSH key","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SSH key with passphrase","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Supported Algorithms for SSH","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FlexDeploy supports the following ciphers for SSH connections. FlexDeploy will automatically negotiate this with the SSH server on the endpoint.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"Supported algorithms for SSH","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD60/pages/9856628032"}}]},{"text":" for information on what SSH algorithms are supported.","type":"text"}]}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Supported web browsers","type":"text"}]},{"type":"paragraph","content":[{"text":"FlexDeploy supports the following web browsers. We recommend the use of latest updates to browsers.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Google Chrome","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mozilla Firefox (On Windows 11, please read ","type":"text"},{"text":"this article","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10340183746"}}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Apple Safari","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft Edge","type":"text"}]}]}]}],"version":1}