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:

  1. Using the product installation media or the download image, locate the iseries-bfagent-<version>.tar.gz file.
  2. Extract the tar file from the archive by entering this command: 
    gzip -d iseries-bfagent-<version>tar.gz
  3. Extract the files from the tar file.
    tar xvf iseries-bfagent-<version>.tar
  4. On the iSeries server, place the bfagent executable file in the agent installation directory, for example: /bin.
  5. On the iSeries server, place the bfagent.conf file in /etc.
  6. 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
  7. 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)