Converting Robot/NETWORK Version 10 to Version 11

Before You Begin

Keep the following items in mind before you convert Robot/NETWORK 10 to Robot/NETWORK 11.

Robot Product Considerations

• If you are running Robot/NETWORK 9, you must convert to Robot/NETWORK 10 before converting to Robot/NETWORK 11. Robot/NETWORK 11 does not support any Robot/NETWORK 9 Nodes.
• Because of dependencies between Robot/SCHEDULE and Robot/NETWORK on the same IBM i server, you must update both products at the same time. Allow enough time to complete updates to both products.
• Robot/NETWORK does not support mirroring. Do not mirror the RBTNETLIB library, the RBTNETNODE library, the RBTNETPT user profile, or the Robot/NETWORK IFS directory (HelpSystems/Robot NETWORK).
• You cannot convert to Robot/NETWORK 11 while your system is in restricted state.
• You must convert the Robot/NETWORK 10 Host to Robot/NETWORK 11 before you convert any of its Nodes.
• You do not have to convert your Robot/NETWORK 10 Node(s) at the same time that you convert your Robot/NETWORK 10 Host.

  Note: You must convert the Host and the Alternate Host before you convert any of the other Nodes.

• Make sure that no one is using Robot/NETWORK.
• The MIB for Robot/NETWORK 10 did not change for version 11.
• Back up your current RBTNETLIB, RBTNETNODE, and RBTSYSLIB libraries, as well as the HelpSystems IFS directory on all systems—the conversion process updates these libraries.
• Important: If the current system is part of a Robot/SAVE data center, you must end the Robot/SAVE monitors on all of the systems that are part of the data center before you start the conversion.
• To run Robot/NETWORK 11 with any of the following Help/Systems products, you need the indicated release/modification levels (or higher) for these products:

Robot/ALERT	R05M00
Robot/AUTOTUNE	R07M19
Robot/CONSOLE	R05M00
Robot/MONITOR	R07M08
Robot/REPORTS	R07M31
Robot/SAVE	R12M00
Robot/SCHEDULE	R11M00

To display the release and modification levels of these products, type RBTSYSLIB/RSLVER and press Enter.

• The Robot/NETWORK 11 user profile, RBTNETPT, which is reset during the conversion, uses the group profile RBTUSER to communicate between systems in the network.
• The conversion process calls a Help/Systems program to create or change the two Help/Systems user profiles, RBTUSER and RBTADMIN. The RBTUSER and RBTADMIN 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 Help/Systems products from IBM changes to the QPGMR or QSECOFR profile defaults.
• Note: If you have made any manual changes to the RBTUSER or RBTADMIN user profiles and their authorities, these changes will be lost with any product installation or conversion.

TCP/IP Considerations

Robot/NETWORK 11 uses TCP Host Servers and Java to communicate between a Host and a Node. You may have to change your initial startup program to allow more time for these services to start before starting the RBTSLEEPER subsystem. For example, you might need to delay the job several minutes (DLYJOB) between the time the TCP Host Servers start and the time the RBTSLEEPER subsystem is started.

Prerequisite IBM i Software

To use Robot/NETWORK 11, you must have the following software installed on your IBM i server:

* Robot/NETWORK 11 is supported for IBM i V5R4 and higher.

Fully Qualified Host Name

For successful network communications, Robot/NETWORK 11 requires a fully qualified TCP/IP host name in the format of system_name.domain_name to be in the local directory and/or the DNS server. You can use the command CFGTCP and options 10 and 12 to set up host names. For more information, contact your system administrator or Help/Systems Technical Support.

Pre-Conversion Checker

Before converting Robot/NETWORK, you can run a pre-conversion utility to determine whether the conversion will complete successfully. Download the netcheck .hs file and use the Product Maintenance Wizard.

Converting Robot/NETWORK

To convert Robot/NETWORK 10 to 11, do the following:

1. Sign on under a user profile that is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, and *IOSYSCFG.
   • This user profile should have Limit capabilities set to *NO.
   • Make sure no users are signed on to the product you are converting.
2. End all Help/Systems products on the current system. The conversion process stops the RBTSLEEPER subsystem, which is used by other Help/Systems products. Stopping RBTSLEEPER interrupts processing by these products.

Note: If you have RBTSYSLIB, R01M87 or later, you can use the RSLSHUTDWN command to end all Help/Systems products and the RBTSLEEPER subsystem.

3. Important: If the current system is part of a Robot/SAVE data center, you must end the Robot/SAVE monitors on all of the systems that are part of the data center before you start the conversion.
4. Remove the RBTNETLIB and RBTNETNODE libraries from all library lists. The conversion program must be able to rename these libraries. To ensure there are no locks, enter the following commands:

WRKOBJLCK RBTNETLIB *LIB

WRKOBJLCK RBTNETNODE *LIB

5. Display the Maintain Help/Systems Products menu by entering the following command:

RBTCDRLIB/HLPCDMENU

6. Select option 4 from the Maintain Help/Systems Products menu and enter one of the following conversion codes:

HLPCNET11 (to convert a Host)

HLPCNOD11 (to convert a Node)

After You Are Done

At the end of the conversion you will see a series of messages indicating the status of the conversion.

• If the conversion was successful, install the Robot/NETWORK Explorer on any PC that you want to use to connect to Robot/NETWORK 11 Hosts. Note: The version 10 Robot/NETWORK Explorer cannot connect to a version 11 Host.
• If the conversion was unsuccessful, examine the job log to determine what went wrong, fix the problem(s), and retry the process. You can enter the WRKSPLF command and check the conversion spooled files and job log for errors. Call Help/Systems Technical Support if you have any questions.

Deleting Libraries

The conversion process creates two libraries, RBTHOSTV10 and RBTNODEV10 and creates backup directories in the Help Systems directory. After you are satisfied that the conversion was a success, you can delete these libraries and IFS directory. You can delete the version 10 backup directories /Help Systems/Robot NETWORK.backup and /Help Systems/installs/NET.backup.

Installing Robot/NETWORK 11 On A PC

After you have finished the IBM i portion of the conversion, do the following to install the Robot/NETWORK 11 Explorer on a PC.

1. Close all Windows applications.
2. Download and run the Robot/NETWORK for Windows installation file (setupnetwork11.exe) from the Help/Systems website. You can have version 10 and 11 of the Robot/NETWORK Explorer running at the same time. All configuration information from version 10 will is available in version 11. Note: The version 10 Robot/NETWORK Explorer GUI does not connect to a version 11 Host.

Note: If you quit the Robot/NETWORK Explorer installation process at any time during the installation, a partial install of Robot/NETWORK Explorer will have occurred. To resolve this, just start the Robot/NETWORK Explorer installation process from Step 2. All existing files will be replaced and the product will be installed correctly on the PC.

3. When the installation program completes, view the README file to see any last-minute information about the product.
   

Updated March 22, 2012