Prerequisites
The virtual machine where the Cyware Agent is installed must be in sync with NTP (Network Protocol Time). To check if the system clock is synchronized, and the NTP is active, run the timedatectl command. The NTP Service displays the activation status.
The supported 64-bit OS versions for installation and configuration of Cyware Agent are:
RHEL and CentOS versions: 7.7, 7.8, 7.9, 8.1, 8.2, 8.3, 8.4, 8.5, 8.6, and 9.0
Ubuntu OS versions: Ubuntu Kinetic 22.10, Ubuntu Jammy 22.04 (LTS), Ubuntu Focal 20.04 (LTS), and Ubuntu Bionic 18.04 (LTS). LTS indicates the long-term support for operating systems.
Ensure that you have shared your Public Gateway IP address or Proxy server IP address with the Cyware team so that we can add your IP address to our Allow Lists and enable your access to our repository domains.
Ensure that you have access to generate Open API credentials in Orchestrate.
Ensure that the following Cyware domains are whitelisted. You will require access to these domains during the installation to download the installation package. The Docker registries from which the installer and configuration files can be downloaded are:
https://packages.cyware.com/
https://prod.packages.cyware.com
Ensure that docker packages are installed on your on-premise infrastructure. For more information about installing docker packages, see Install Docker.
Ensure that you have identified the details of the storage mount directory that will be used to install Cyware Agent. The default mount directory is /apps/cyware/cyware_agent. Ensure that the mount directory has sufficient storage with storage disks mounted.
Ensure that you have installed
supervisor
which is required to monitor processes and update any configuration changes. To installsupervisor
, run the following command:yum install supervisor -y
Ensure that you have installed
wget
to download Agent images and related files. To installwget
, run the following command:yum install wget -y
Ensure that you have started and enabled
supervisord
. To start and enablesupervisord
run the following commands:systemctl start supervisord systemctl enable supervisord
To install Cyware Agent with a custom CA certificate, ensure to store the CA certificate in a file on your host system. Ensure that the CA certificate file includes the certificates that belong to the Cyware Orchestrate application. Otherwise, Cyware Agent will not trust and connect with Cyware Orchestrate.
Note
If you want Cyware Agent to trust additional services with different host names, you can include the CA certificates of the hosts in the certificate bundle.
For example, you can export the certificate of your Cyware Orchestrate application and use the certificate to install Cyware Agent. You can export the Cyware Orchestrate from the site information section of your browser and save the certificate in the Base64-encoded ASCII, certificate chain format.