Installation Prerequisites

Here’s the software and hardware requirements to install and run Digital.ai Deploy. You can also find information about the supported OS platforms, databases, and browsers to run Digital.ai Deploy. These are the minimum requirements to install and run Digital.ai Deploy. Your setup might have to be better than the stated minimum requirements depending on your site’s size and usage pattern. Contact Digital.ai support for assistance.

Supported Operating Systems

Digital.ai Deploy supports any of the following commercially supported 64-bit operating systems:

  • Microsoft Windows 2012, 2016, and 2019 (under Mainstream Support)
  • Linux/Unix-based operating systems

    • Ubuntu 18.04 and 20.04
    • CentOS 7.x and 8.x
    • RedHat Enterprise Linux 8.x

Supported Databases

The following databases are supported.

Database Versions Supported
PostgreSQL 12.9, 13.5, and 14.2
MySQL 5.7 and 8.0
Oracle 12c and 19c
Microsoft SQL Server 2017 and 2019
DB2 11.1 and 11.5

Important: Note that DB2 is no longer supported as the database of choice for new sites. However, existing DB2 sites are supported until further notice about dropping support for DB2.

You must set up a database for the Deploy application to store data. Create and configure an empty database before you start the Deploy installation process. During the installation, Deploy creates the database schema on the database you created. Optionally, you can have separate operational and reporting databases. For more information about creating two separate databases, see Separate Databases for Reporting and Repository in Deploy.

Use an enterprise-grade external database server, for example PostgreSQL, for production use. For more information, see Configure the Database and Artifacts Repository.

Supported Java Development Kit

Digital.ai Deploy supports OpenJDK 11. You must install OpenJDK 11 to install and run Digital.ai Deploy.

Important: Deploy is not supported on non-LTS Java Development Kits (JDKs). See the Java SE support roadmap for details on which Java versions are LTS and non-LTS.

Deploy Server Hardware Requirements

To install the Deploy, your servers must meet the following requirements:

CPU

Modern multi-core CPU with x64 architecture

RAM

At least 2GB of RAM is required for Deploy. Here’s is the RAM required for your setup based on the number of workers:

  • 3GB for a single-server—internal worker—setup
  • 2GB for master server and 2GB per worker on one server with local worker setup
  • 2GB for master server and 2GB for each worker server in external worker setup

Hard Disk

The default installation of Digital.ai Deploy requires approximately 250 MB of disk space (excluding Java and other tools), but it is recommended to have at least 100 GB of disk space on each master or worker node.

Hard disk space is mainly used for storing Deploy artifacts and log files. The file size of the Deploy artifacts vary from one site to the other, but depends mainly on the:

  • Size and storage mechanism used for artifacts

    • Deploy supports three ways of storing artifacts:
    • In an external file storage such as Maven or some HTTP(S) location, as described here. This is the preferred way.
    • Directly in the database.
    • On a file system that is shared between all of the masters and workers. In this case, there must be enough space on the shared file system to hold all artifacts for all versions of all applications.
  • Number of deployment packages on your site
  • Number of deployments performed (specifically, the amount of logging information stored)

Deploy always requires that the disk space for the server be persistent. This is important for the following reasons:

  • Configuration files such as deployit.conf, and all the files in centralConfiguration directory are updated in real time
  • Log files are also updated in real time (unless configured otherwise)

Estimating Required Hard Disk Space

To estimate the total required hard disk space:

  1. Install and configure Deploy for your environment. Make sure you correctly set up the database or file-based repository.
  2. Estimate the number of packages to be imported, either the total number or the number per unit of time (NumPackages).
  3. Estimate the number of deployments to be performed, either the total number or the number per unit of time (NumDeployments).
  4. Record the amount of disk space used by Deploy (InitialSize).
  5. Import a small number of packages using the GUI or CLI.
  6. Record the amount of disk space used by Deploy (SizeAfterImport).
  7. Perform a small number of deployments.
  8. Record the amount of disk space used by Deploy (SizeAfterDeployments).

The needed amount of disk space in total is equal to:

Space Needed = ((SizeAfterImport - InitialSize) * NumPackages) +
    ((SizeAfterDeployments - SizeAfterImport) * NumDeployments)

If NumPackages and NumDeployments are expressed per time unit (the number of packages to be imported per month), the end result represents the space needed per time unit as well.

Depending on the environment, the following may also be required:

Networking Requirements

Before installing Deploy, ensure that the network connection to the Deploy host name is functional. You should be able to successfully execute ping xl_deploy_hostname.

By default, the Deploy server uses port 4516. If, during installation, you choose to enable secure communication (SSL) between the server and the Deploy GUI, the server uses port 4517.

External worker setup requires 4516 or 4517 ports to be open to clients and worker machines and, additionally, port 8180 for master-worker communication on all masters and workers.

To enable secure communication and/or to change the port number during installation, choose the manual setup option when installing Deploy.

Minimal Reference Configuration

For both internal and external workers, having an external database instance is preferred.

Internal Worker Hardware Configuration

Important: These numbers are indicative. You may need to review the configuration based on the real-time usage of the Deploy product.

  • Modern multi-core CPU with x64 architecture
  • RAM: 8GB
  • Hard drive: 100GB
  • Faster network connection between database and master/worker instances is preferred

External Worker Hardware Configuration

Master:

  • Modern multi-core CPU with x64 architecture
  • RAM: 8GB
  • Hard drive: 100GB
  • Faster network connection between database and master/worker instances is preferred

    Worker:

  • Modern multi-core CPU with x64 architecture
  • RAM: 8GB
  • Hard drive: 100GB
  • Faster network connection between database and master/worker instances is preferred

Database Server Hardware Configuration

  • Modern multi-core CPU with x64 architecture
  • RAM: 8GB
  • Hard drive: 100GB
  • Faster network connection between database and master/worker instances is preferred

For additional information check database vendor requirements pages:

Supported Web Browsers

  • Firefox: the latest 2 versions
  • Chrome: the latest 2 versions
  • Microsoft Edge Chromium: the latest 2 versions

CLI Client Requirements

To use the Deploy CLI, your system must meet the following requirements:

  • Operating System: Microsoft Windows or Unix-based operating system running Java.
  • Java Runtime Environment: Oracle JDK 11.

Middleware Server Requirements

Unix Middleware Server Requirements

Unix-based middleware servers that Deploy interacts with must meet the following requirements:

  • Credentials: Deploy must be able to log in to the target systems using a user name and password combination to perform at least the following Unix commands: cp, ls, mv, rm, mkdir, and rmdir. If the login user cannot perform these actions, Deploy can also use a sudo user that can execute these commands.
  • SSH Access: The target systems must be accessible by SSH from the Deploy server. They should run an SSH2 server. It is also possible to handle key-based authorization.

Note:

  • It is possible that the SSH daemon on AIX hangs with certain types of SSH traffic.
  • For security, the SSH account that is used to access a host should have limited rights.
  • A variety of Linux distributions have made SSH require a TTY by default. This setting is incompatible with Deploy and is controlled by the Defaults requiretty setting in the sudoers file.

Windows Middleware Server Requirements

Microsoft Windows-based middleware servers that Deploy interacts with must meet the following requirements:

  • File System Access: The target file system must be accessible via CIFS from the Deploy server.
  • Host Access: The target host must be accessible from the Deploy server via WinRM or Windows Telnet server running in stream mode.
  • Directory Shares: The account used to access a target system must have access to the host’s administrative shares such as C$.
  • Ports:

    • For CIFS connectivity, port 445 on the target system must be accessible from the Deploy server.
    • For Telnet connectivity, port 23 must be accessible from the Deploy server.
    • For WinRM connectivity, port 5985 (HTTP) or port 5986 (HTTPS) must be accessible from the Deploy server.

Extending Middleware Support

You can connect Deploy to middleware servers that do not support SSH, Telnet, or WinRM. This requires you to use the Overthere remote execution framework to create a custom access method that connects to the server.

LDAP

To enable group-based security, an LDAP x.509 compliant registry is needed. For more information, see Connect Deploy to LDAP or Active Directory.