Simplify Packaging of Z Understand and Refactor Containers
This procedure describes how to extract, configure, start, stop, and uninstall the combined package for Z Understand and Refactor containers.
Obtain and Extract the Package
-
Download the combined package archive from the artifact repository
For example,
bobz-combined-package.tar.gz -
Extract the archive:
tar -xf <package-name>.tar.gz - Navigate into the extracted directory:
For example, if the folder name is bobz:cd <extracted-folder-name>cd bobz
Prepare Configuration (setup.json)
-
Inside the directory, you will find sample configuration files:
setup.sample.db2.jsonsetup.sample.sqlserver.json
-
Choose the appropriate configuration file based on your database type:
- For DB2:
cp setup.sample.db2.json - For SQL Server:
cp setup.sample.sqlserver.json
- For DB2:
- Create a copy of this file and name it as
setup.json. -
Open
setup.jsonand update the required values:- Database connection details
- Credentials
- Environment-specific configurations
Start the Application
- Run the startup script:
The script starts:./start.sh -c setup.json- Understand container
- Refactoring Assistant container
- Verify that all containers are running:
Ensure that all Z Understand and Z Refactoring Assistant containers are in the Up state.podman ps -a - You can access the Z Understand UI dashboard.
-
Configure the certificate in Z Refactoring Assistant:
- Navigate to Servers and Security
- Upload and configure the required certificate (
root.crt)
-
Create and build projects in the following directory: /root/understand/.
Note: Certificates are created in /root/bobz/understand/security/ra (and its
symlink is created in/root/bobz/security).
Note:
Stop the Application
To stop both running containers:
./stop.sh- The script stops:
- Understand container
- Refactoring Assistant container
Uninstall the Package
To completely remove deployment, containers, and associated data,
run:
./uninstall.sh -fa-fa ensures full cleanup.