This repository contains utilities to install SoftwareAG webMethods products on a single node using Command Central templates.
It makes use of the official Command Central Docker images to simplify provisioning, without having to preinstall anything on the host machine (except Docker). This approach also avoids having to install a local or shared Command Central instance, while still benefiting from mirroring and templates. At this time, this tool has only been tested with the webMethods 10.5 release.
These tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite, and are not endorsed by SoftwareAG. Users are free to use, fork and modify them, subject to the license agreement.
-
Install Docker and Docker Compose and make sure you have sufficient RAM available.
-
On Docker Hub, subscribe to the official Command Central image with your account. Use
docker loginto connect the host machine to your account. -
Make sure you have Empower credentials with access to the products you want to build, as well as valid license files in XML format. Create a ZIP archive of your license files in
licenses/licenses.zip. -
Edit the
.envfile to choose theSAG_HOMEinstallation directory. On the host machine, create this installation directory andsagadminuser. For example:useradd -u 1724 -U -d /opt/softwareag -m -s /bin/bash sagadmin -
Make sure the
mirrorandtemplatesdirectories of this project are owned by this user:chmod -R 1724 mirror templates -
If products needs to communicate with the host machine itself (e.g. to access a database), refer to it as
nodein the template and add the following line to the/etc/hostsfile of the host:127.0.0.1 node
First, update variables in the mirror.env file with your Empower credentials and a list of artifacts to mirror.
To create a local mirror before installation, execute the following commands:
docker-compose run --rm mirror-installer
docker-compose run --rm mirror-repos
Downloaded data will be stored in the mirror directory. You may wish to share it between machines using NFS/rsync/etc. to avoid repeating this step for other nodes.
First, create or add your existing Command Central templates in the templates/<template-name> directory.
Each template directory must contain a template.yaml file, and may contain preinstall.sh, postinstall.sh and test.sh scripts that will be executed in this order during installation. Some samples are provided in this repository.
For more information about Command Central templates, please see the official documentation and the SoftwareAG/sagdevops-templates repository.
To start provisioning a product on the local machine, execute the following command:
docker-compose run --rm provision <template-name>
This will first install Java and SPM on the host machine in /opt/softwareag, then install the product according to the template.
Make sure all installed products are stopped before running this command. You may run this command multiple times to install different products or adjust settings.
To create systemd services for installed products, you may use commands such as the following:
# Register/enable/start Platform Manager (SPM)
/opt/softwareag/common/bin/daemon.sh -f /opt/softwareag/profiles/SPM/bin/sagspm105 -u sagadmin -n spm105 -i 1
systemctl enable --now sag1spm105
# Register/enable/start Integration Server
/opt/softwareag/common/bin/daemon.sh -f /opt/softwareag/profiles/IS_default/bin/sagis105 -u sagadmin -n is105 -i 1
systemctl enable --now sag1is105
# Do the same for other products
If necessary, you may also start a full Command Central Server and register the local node with the following commands:
docker-compose up -d cc
docker-compose run --rm sagcc add landscape nodes alias=node url="https://node:8093" -e OK -w 180 -c 20 --wait-for-cc
Make sure SPM is running on the host machine before registering it.
Then, access the Command Central web interface at https://<hostname>:8091