Installing the agent on System i platforms
Use the following instructions to manually install the agent on System i.
The command script in step 7 creates a job description that will run at start up, and initiates the agent as the BFAGENT user with *ALLOBJ special authority.
- Any user with *ALLOBJ special authority or the QSECOFR user can be authenticated by using the server authentication credentials that you specify in the Management Console.
- To authenticate a user without these privileges, you must configure the magic_login setting in the bfagent.conf file. See the bfagent.conf reference for details.
To install the agent on System i platforms:
- Using the product installation media or the download image, locate the iseries-bfagent-<version>.tar.gz file.
- Extract the tar file from the archive by entering this command:
gzip -d iseries-bfagent-<version>tar.gz
- Extract the files from the tar file.
tar xvf iseries-bfagent-<version>.tar
- On the iSeries server, place the bfagent executable file in the agent installation directory, for example: /bin.
- On the iSeries server, place the bfagent.conf file in /etc.
- In the bfagent.conf file, uncomment the shell option and specify the default shell for PASE, as shown in the following example, or specify your preferred shell.
shell /bin/sh
- Configure System i to run as the BFAGENT user at startup.
Enter the following commands to create the BFAGENT user with *ALLOBJ special authority and create a job description that runs at startup as the BFAGENT user. In the following example, the bfagent executable is installed in /bin.
CRTLIB BFAGENT CRTSBSD SBSD(BFAGENT/BFAGENT) POOLS((1 *BASE)) TEXT('Build Forge Agent subsystem') CRTJOBQ JOBQ(BFAGENT/BFAJOBQ) TEXT('Build Forge Agent job queue') CRTUSRPRF USRPRF(BFAGENT) PASSWORD(*NONE) INLMNU(*SIGNOFF) LMTCPB(*YES) SPCAUT(*ALLOBJ) TEXT('Build Forge Agent user profile') CRTJOBD JOBD(BFAGENT/BFAJOBD) JOBQ(BFAGENT/BFAJOBQ) TEXT('Build Forge Agent autostart')USER(BFAGENT) RQSDTA('CALL PGM(QP2SHELL) PARM(''/bin/bfagent'' '' -s'')') CRTCLS CLS(BFAGENT/BFACLS) TEXT('Build Forge Agent job class') ADDRTGE SBSD(BFAGENT/BFAGENT) SEQNBR(1) CMPVAL(*ANY) PGM(QCMD) CLS(BFAGENT/BFACLS) ADDJOBQE SBSD(BFAGENT/BFAGENT) JOBQ(BFAGENT/BFAJOBQ) MAXACT(*NOMAX) SEQNBR(10) ADDAJE SBSD(BFAGENT/BFAGENT) JOB(BFAGENT) JOBD(BFAGENT/BFAJOBD)