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)