Registering IBM i Endpoints

You can use the functionality of the Powertech Antivirus application within HelpSystems One with IBM i endpoints.

To register your HelpSystems One environment with Powertech Antivirus for IBM i 8.07 and above, complete the steps in all sections below, in order:

On the IBM i

  1. Sign on to the IBM i with a user profile that has *IOSYSCFG special authority.

  2. Ensure the name used for the Powertech Antivirus server can be resolved to an IP address. This resolution can be achieved with DNS or with host table entries. To use host table entries, follow these steps:

    1. Run CFGTCP.

    2. Choose option 10, Work with TCP/IP host table entries.

    3. Choose option 1, Add.

    4. Enter <IP address of the Powertech Antivirus Server>.

    5. Enter the Powertech Antivirus server host name.

  3. Run call qp2term.

  4. From the qp2term command line, run cd /standguard/webclient/integration.

  5. Run ./register.sh -k <API key copied from the HelpSystems One user interface> -s <Powertech Antivirus Server IP address> -c <your IBM i system name>.

    EXAMPLE: ./register.sh -k fb0229ee-1518-4bfa-8ff2-ec733a803c98 -s XX.XX.XXX.XX -c MyIBMi
    Where:
    • API key from HelpSystems One is fb0229ee-1518-4bfa-8ff2-ec733a803c98
    • Powertech Antivirus Server IP address is "XX.XX.XXX.XX"
    • IBM i endpoint name is MyIBMi

    NOTE: You can find the API key on the Endpoint Registration page of the Powertech Antivirus application in HelpSystems One.

  6. Press F3 to exit the qp2term environment.

In HelpSystems One

Your IBM i endpoint should now appear within the Powertech Antivirus application in HelpSystems One. To allow the connection to be made from the endpoint, complete the following steps in the Powertech Antivirus application.

  1. Navigate to the Connection Settings page.

  2. Click (Show Actions) next to the IBM i endpoint.

  3. Select Allow.

After Registering

Start the job that connects the IBM i endpoint to HelpSystems One by completing the following steps on the IBM i:

  1. Run ADDLIBLE STANDGUARD.

  2. Run AVINSITE *RESTART. The user profile running this command needs *USE authority to user profile STANDGUARD.

  3. Only for systems where Powertech Antivirus for IBM i has been updated from R08M06 to R08M07, do the following steps:

    1. Sign on to an interactive session on the IBM i.

    2. Run the command:
      edtf '/standguard/webclient/integration/config/server.toml'

    3. Insert the following lines at the end of the file:
      [ibmistatuscheck]
      interval = 5

    4. Press F3 twice.

    5. You can now start the AVINSITE job.

Managing the AVINSITE Job

If needed, you can manage the connection between the endpoint and HelpSystems One by using the AVINSITE job that runs in subsystem QSYSWRK. The user profile running the AVINSITE command needs *USE authority to user profile STANDGUARD. Use STANDGUARD/AVINSITE on the IBM i with one of the following options:

*START
Starts the job that connects to HelpSystems One.
*STOP
Ends the job that connects to HelpSystems One.
*STATUS
Displays the status of the connection to HelpSystems One.
*RESTART
Restarts the connection to HelpSystems One.
*AUTOSTART
Adds an autostart job entry to the QSYSWRK subsystem so AVINSITE starts automatically when the system IPLs. This option can also be used to remove the autostart entry. In the following example, the autostart entry is added:
AVINSITE OPTION(*AUTOSTART) VALUE(*YES)

To view the local HelpSystems One/IBM i endpoint log, run the command:

dspf '/standguard/webclient/integration/log/avinsite.log'