Installing and running the agent on System z platforms
Follow these instructions to manually extract and compile the Build Forge agent source code on System z. The agent source code for z/OS is provided as uncompiled source only. A binary distribution is not available.
The following software and programs are required:
- The c89 compiler and Unix header files. On the z/OS system, the agent runs in the Unix System Services (USS) environment.
- The z/OS UNIX shell interface. During installation, you run all commands on z/OS in the z/OS UNIX shell.
- The gzip utility. Note: If gzip is available on the z/OS system, you can extract the tar file on the z/OS system after transferring the source pack to z/OS. If it is not, you must first extract the files on a non-z/OS computer, and then transfer them to the z/OS system.
- The Build Forge agent source pack for z/OS: src-bfagent-<version>.tar.gz.
To enable SSL, make sure the following prerequisites are fulfilled:
- Enable SSL for client and internal communications. See Enabling SSL for client and internal connections.
- The system SSL library must be installed.
- Use the latest version of SystemSSL when you compile the agent code.
To install the agent on System z platforms:
- Using either the product installation media or the download product
image, locate the file for the agent source pack: src-bfagent-<version>.tar.gz.
Copy or download the source pack to a directory on the non-z/OS computer.
- At a shell prompt on the non-z/OS computer, extract the tar file
from the agent source pack by entering the command:
gzip -d src-bfagent-<version>tar.gz
- Using ftp or another transfer method, transfer the tar file to the z/OS system as a binary image and place it in a dedicated HFS subdirectory, usually the USS home directory for a user account.
- On the z/OS system, run the following commands to build the agent
source code:
- First step: Use
./configure-zos
directly if you don't need to enable SSL. Otherwise, you need to provide the-with-system-ssl
and its path to the system SSL. Use the latest version of SystemSSL:- From BuildForge 8.0.0.1, the bfagent supports TLS v1.2 and TLS v1.1
- From z/OS, version 1 release 13, is the minimum version that supports TLS v1.2. If you do not have the minimum version requirement, you must compile the bfagent on z/OS without system SSL.
pax -rf src-bfagent-<version>.tar -ofrom=ISO8859-1,to=IBM-1047 cd bfagent-<version>/src tcsh ./configure-zos [--with-system-ssl=<path>]
- After the ./configure-zos script completes, run the following
command:
./build-zos
Note: If you receive errors after the ./build-zos script runs, see Troubleshooting the agent installation on z/OS. - First step: Use
- On the z/OS system, place the bfagent.conf file in /etc.
If bfagent.conf is not in /etc, the agent must be started with the -f option. See bfagent reference.
- On the z/OS system, place the bfagent executable file in an appropriate location, for example, /usr/bin or /usr/local/bin.
- On the z/OS system, run the following command as root:
# extattr +p -s bfagent
- If you are using system SSL, add the system SSL library to PROGRAM
CONTROL. Use the following commands.
ralter program * addmem('SYS1.SIEALNKE'//nopadchk) uacc(read)
- On the z/OS system, log in as root and start the agent manually
by using the -s option:
bfagent -s
If security policy does not allow you to log in as root, see bfagent.conf reference and see the instructions for the magic_login setting in bfagent.conf.
The agent runs as a standalone daemon and uses the default agent port 5555. To change default port, use the port setting in bfagent.conf. See bfagent reference.
Note: If the Unix TCP/IP daemon (inetd or xinetd) is installed and active on the z/OS system, you can set up the Build Forge agent to run as a service and start automatically. See Running an agent on UNIX and Linux. - On the z/OS system, use the telnet command to test the connection. See Testing the connection.