Before You Begin

Read these instructions completely before attempting an installation or update.

This document provides specific instructions on how to install or update Robot Console using the HelpSystems Product Loader. For general information about the HelpSystems Product Loader, see “Using the HelpSystems Product Loader.”

Notes on Independent ASP Support

Robot Console enables you to install into an independent ASP (IASP), and allows you to have an instance of Robot Console running in *SYSBAS, as well as one in each ASP group. Here are some things to consider prior to installing into an IASP:

  • Each Robot Console instance must be licensed and must have a unique library name, unless the library is in an IASP. Since libraries in ASP groups reside in their own namespace, they may have duplicate names across ASP groups.

  • System-based objects like QSYSOPR message queue, log monitoring, and FTP monitoring should be monitored from *SYSBAS because your IASP may become unavailable.

  • Robot Console users will need to use the SETASPGRP command, or have their user profile’s JOBD specify the INLASPGRP, prior to using Robot Console.

    Important: QDFTJOBD should never set INLASPGRP, because ASP groups are not available until after IPL, and may cause your system to fail to IPL.

    The Robot Console Explorer has advanced connection information that allows users to specify the ASP group and library name if users do not have their ASP group set by their job description.

Notes on the Robot Console Installation

  • The Robot Console installation process creates or changes two user profiles: RBTUSER and RBTADMIN. RBTADMIN has the attributes of a QSECOFR profile. RBTUSER has attributes like QPGMR. Directory entries are automatically added for the RBTADMIN and RBTUSER profiles. These profiles were created for the following reasons:

    • They satisfy requests from corporate auditors that our objects be owned differently from IBM objects.

    • They allow us to build a secure product for your environment.

    • They isolate the Robot products from IBM changes to the QPGMR or QSECOFR profile defaults.

    Note: If you've made any manual changes to the RBTUSER or RBTADMIN user profiles or their authorities, these changes will be lost with any product installation or conversion.

  • If you have any network security products, be aware that the Robot Console Explorer uses the following servers and exit points. We recommend that all the exit points listed above be open to RBTUSER, RBTADMIN, and the user logging into the Robot Console Explorer.

    Servers Exit Points
    RMTCMD QIBM_QZRC_RMT
    SIGNON QIBM_QZSO_SIGNONSRV
    DATABASE QIBM_QZDA_SQL1 and QIBM_QZDA_SQL2
    FILE QIBM_QPWFS_FILE_SERV

    These exit points are for Robot Console standalone connections only. For Host mode, refer to the exit points for your version of Robot Network.

  • The installation procedure adds the library RBTSYSLIB to your system library list ahead of QSYS.

  • If you use other Robot products, they must be at the following release/modification levels (or higher) for Robot Console 7:

    • Robot Alert R05M66

    • Robot Trapper R01M23

    • Robot Network host R12M00

    • Robot Network node R12M00

    Note: Execute the command RBTSYSLIB/RSLVER to display the release/modification levels for the installed Robot products.

  • Before loading Robot Console, we check if RBTSYSLIB needs to be updated. If it does, you’ll be asked to bring down the subsystem RBTSLEEPER. This ends all Robot products running on your system. When the update completes, the subsystem will restart automatically.

  • For installs only: When you’re finished loading Robot Console, follow the steps below to enter the license code.

  • Once the installation or update process completes, read the After You Are Done section for additional information.

Important: We’ve greatly improved the bundled installers to make them easier to use. However, we recommend you read the installation/update/conversion instructions carefully before proceeding. For a general overview of the improved installer, see “   Using the HelpSystems Product Loader.”

System Requirements

The system requirements for the current (non-archived) version are: 

IBM i (i5/OS, OS/400) version V7R2 or higher

Robot Console Pre-Checker

Before you load Robot Console, you can run a pre-checker to determine whether or not the load will complete successfully. To run the pre-checker, do the following:

  1. Use the "Installing or Updating Robot Console" instructions to download everything to your PC.

  2. When you reach the Product Load Options panel, select Staged Load (step 5b below) and wait until the processing completes.

  3. On the IBM i, execute the following command to display the Work with Loads panel:

    HSLOADMGR/HSWRKLOAD

  4. Enter option 2, Run pre-checker, next to the Load Name for Robot Console and press Enter.

  5. Review the information on the Pre-check Install Console 6 panel. Select *NEW for the installation, then press Enter.

Note: A pre-checker automatically runs during the first part of the Robot Console installation or update process, but we recommend you run it in advance to identify any potential problems before attempting a full installation or update.

 

Installing or Updating Robot Console

Use these instructions to install or update Robot Console. This process downloads everything to your PC and loads the objects on the IBM i. Read the following steps carefully to proceed.

  1. Download the Robot Console Installer (setupConsole7.exe) from My Downloads page on our website. Double-click it to start it.

  2. On the Choose Components panel, select which components you want to install. You can choose to install the Software for Windows (the GUI and the Manuals) and the Software for IBM i. Click Next.

  3. If you’re only installing the Software for Windows, the process completes and the installer closes. The Software for Windows has been installed. You can skip the rest of these steps.

    Note: The manuals were installed at the following location.

    • C:\Program Files (x86)\Help Systems\Robot CONSOLE 7\manuals

    If you’re loading the Software for IBM i (with or without the Software for Windows), continue to step 4.

  4. On the Choose a Destination IBM i panel:

    1. Select or enter the IBM i where you want to load Robot Console.

    2. Enter a user profile and password that’s a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, and *IOSYSCFG. The user profile should have Limit capabilities set to *NO. This profile will be used to restore and copy objects, and for product maintenance on the IBM i.

    3. (Optional) In the Advanced Settings section:

      • Enter a port number or use the arrows if you want to change the FTP port number to something other than the default of 21.

      • Select Secure File Transfer if you want to use FTPS (FTP over SSL) during the file transfer. The default FTPS secure port is 990, but it can be changed to the required secure port for your environment.

      • In the Timeout (seconds) field, enter the number of seconds the session should be kept active during an FTP transfer. You can choose anywhere between 25 and 1800 seconds (30 minutes).

        Note: If the transfer takes longer than the amount of time specified, the session will expire.

      • Change the name of the destination ASP group, if it’s different from the default group *SYSBAS.

    4. Click Next.

  5. You have two options on the Product Load Options panel:

    1. Click Immediate Load if you’d like to load the product on the IBM i now.

      Note: If you're doing an update, this ends Robot Console until the product load completes. After you are done, we’ll restart the product.

    2. Click Staged Load if you’d like to transfer the objects now and load them on the IBM i at a later time.

      Note: See “Loading Staged Objects on the IBM i” below for instructions on how to load the staged objects on your selected IBM i system.

  6. The Product Load Progress panel for Robot Console launches. When the processing is complete, you have two choices:

    • If this is the only installation or update of Robot Console that you're doing, click Finish.

    • If you have installs or updates to do on other IBM i systems, click Restart. Then, return to step 4.

    Note: If the Product Load Progress panel ends with an overall Failed message, the product upload could not complete properly. To find the reason the upload failed, click View Logs and review your logs. You can also use Download at the top of the logs to save the information for future review.

 

Loading Staged Objects on the IBM i

If you chose to stage your objects during step 5b of the installation or update process, do the following to manually load them on the IBM i you identified above.

  1. If you're loading Robot Console into an IASP, run the following command on the IBM i to set the ASP group:

    SETASPGRP ASPGRP(asp_group_name)

  2. Execute the following command to display the Work with Loads panel:

    HSLOADMGR/HSWRKLOAD

  3. Enter option 1, Load, next to the Load Name for Robot Console and press Enter.

 

Entering the License Code

Note: You only need to enter a license code after installing Robot Console. If you updated Robot Console, skip these steps.

After you load Robot Console, you must enter a license code in order to use the product. If you haven't received a license code, contact your Regional Sales Manager.

  1. Execute the following command on the IBM i to open the Installed Robot Products panel:

    RSLVER

  2. Enter option 1 by Robot Console to open the Robot Console License Setup panel.

  3. Copy your new license code. Then, paste it into the first entry field under License Code (it will automatically fill the other fields).

  4. Press Enter.

 

After You Are Done

  • The Robot Console installation program restored three libraries: RBTSYSLIB, and the Product Library Name and Merge Library Name you selected on the RBCINSTALL command. If you used *DEFAULT library names, then the libraries restored were RBTSYSLIB, RBTCONLIB, and RBCMRGLIB. If the system on which Robot CONSOLE was installed is a Robot Network host system, a fourth library, RBNRBCMST, was also restored.

  • Three libraries were restored to your system for use during the installation or update process: HSLOADMGR, HSLOADMGRW, and RBTCDRLIB. We don't remove them from your system in case you're doing multiple installations. You can delete them when you're finished.

    Note: You can move the library HSLOADMGR to a different system on the IBM i and use it to complete additional installs or updates. For more information, see “Using the HelpSystems Product Loader.”

  • To access the product’s Main Menu on the IBM i, execute the command RBO on a command line to display the Robot Automated Operations Solution panel. Then, enter option 5 for Robot Console.

  • Set up Robot Console on your system as described in the Robot Console User Guide. If you didn't install the manuals on your PC, you can download them from our website.

  • Before you begin creating message sets in Robot Console, display your system reply list using the WRKRPYLE command. Entries in the system reply list may process a message before Robot Console has the opportunity to process it. We recommend that you set up message replies in Robot Console instead of using the system reply list.


Still have questions? We can help. Submit a case to Technical Support.

Last Modified On: April 16, 2019