Before You Begin

Read these instructions completely before attempting an installation.

  • This document provides specific instructions on how to install HelpSystems Abstract using the HelpSystems Product Loader. For general information about the HelpSystems Product Loader, see Using the HelpSystems Product Loader on our website.

  • The installation process automatically installs Abstract into the default library ABSTRACT on the IBM i.

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

Software Requirements and Notes

  • Your operating system level must be at i5/OS V6R1 or higher.

  • Review the ReadMe document for changes that may affect your environment. This document is part of the Instruction Package available on the Abstract download page.

  • If you are updating from Abstract 10.7.235 or higher, the installation program keeps your existing authorization code. If you are doing a new install, or your current version is less than 10.7.235, you need a new authorization code from HelpSystems.

Installing Abstract

Use these instructions to install HelpSystems Abstract. 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 HelpSystems Abstract installer (setupAbstract.exe) from Your Account 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 Manuals and/or the Software for IBM i. Click Start to continue.

    The installer will extract files to your PC and launch the Abstract Product Loader in a secondary window.

    Note: If you select the Manuals component, they will be installed in the following location.

    • C:\Program Files (x86)\SEQUEL\ABSTRACT\manuals

  3. On the IBM i Details panel:

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

    2. Enter a user profile and password that is 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.

    4. Click Next.

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

    1. Click Immediate Load to load the product on the IBM i now.

    2. Click Staged Load 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.

  5. The Product Load Progress panel for Abstract launches. When the processing is complete, you have two choices:

    • If this is the only installation of Abstract you are performing, click Finish.

    • If you have more installations on other IBM i systems, click Restart. Then, return to step 3.

    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 or install 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 using step 4b of the installation or update process, do the following to manually load them on the IBM i you identified above.

  1. At a command line, enter the following to display the Work with Loads panel:

    HSLOADMGR/HSWRKLOAD

  2. Enter option 1 next to the Load Name for Abstract and press Enter.

    Note: Option 2 does not apply to Abstract as a pre-check is not required. Use option 8 if you want to copy the Load command for use in a job scheduler or to submit the load now.

  3. After a series of status messages, the Abstract Installation panel displays. This install panel is used for both first time installation or updating your existing version.

    Specify the installation options you want to use, and press Enter:

    Install interactively or in batch

    Select one of the following:

    1=Submit to batch
    Submits the install as a batch job. Enter the library and job description to run the install in batch.

    2=Run interactively
    Runs the install interactively.

    ABSTRACT Product library

    Enter the name of the library where you want to install Abstract.

    Install ESEND?

    Select one of the following:

    Yes=Install Sequel Software' email support product, Esend

    No=Do not install Esend
    Runs the install interactively.

    ESEND Product library

    Enter the name of the library where you want to install Esend.

    Restore to ASP

    Enter the auxiliary storage pool number for new installs of Abstract..

After You Are Done

The installation process installed the following objects:

  • The ABSTRACT product library

  • The ASCSUPPORT customer support library (where applicable)

  • An ABSTRACT and ESEND command in QUSRSYS

  • IFS files: Operations Navigator ABSTRACT plug-in:
    QIBM\UserData\OpNavPlugin\ASC.ABSTRACT

  • Additional files are installed in the folders \sequel, \esend, \helpsystems and \rio.

  • 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 on our website.

For complete information on using Abstract, see the Abstract User Guide.

If you want to install or update the optional iSeries Access or RDi / RDP plug-in features, continue with the remainder of this document. Otherwise, you are finished with your installation of ABSTRACT

Install the Abstract Plug-in for System i Navigator

For IBM System i Access for Windows V6R1

Do the following for systems using System i Navigator V6R1. This process loads the ABSTRACT plug-in on your PC.

  1. From your PC select Start\Programs\IBM System i Access for Windows\System i Navigator.

  2. From the System i Navigator menu select View\Task Pad.

  3. Select the Install Plug-in option listed in the Environment tasks section of the Task Pad.

  4. Select Abstract from the list of available plug-ins and follow the remaining step to complete the installation.

Verify Installation

Start iSeries/Operations Navigator and select the system where the ABSTRACT plug-in was installed. The Navigator should prompt you to scan for newly installed plug-ins. After the scan, you should see the ABSTRACT folder beneath your system connection.

Update or Convert the Abstract Plug-in for System i Navigator

Note: See the previous section if you are installing the ABSTRACT plug-in for the first time. The following information is specific to current ABSTRACT users who are upgrading their software.

For IBM System i Access for Windows V6R1 or V7R1

If you already have the ABSTRACT client software installed on your PC, start System i Navigator to update your plug-in.

  1. From your PC select Start\Programs\IBM System i Access for Windows\System i Navigator.

  2. From the System i Navigator menu select View\Task Pad.

  3. Select the Upgrade or Service plug-ins option listed in the Environment tasks section of the Task Pad.

  4. Select Abstract from the list of available plug-ins and follow the remaining step to complete the installation. Press Finish.

Install, Update, or Convert the Abstract Plug-in for RDP 8x / RDI 9.0/1/2/5

Note: These versions of RDP/RDi are not supported in Windows 10.

Steps

Make sure you have already installed the ABSTRACT Plug-in for System i Navigator.

Do the following to install and add the plug-in to RDi.

  1. From RDP/RDi, select Help\Install New Software on the main menu.

  2. When the Install screen opens, press the Add button.

  3. In the Add Repository window, enter a Name (we used 'RDP 8.x'), and one the following URLs:

    http://www.sequel-software.com/abstract/rdp80/service (for RDP 8.x)

    or

    http://www.sequel-software.com/abstract/rdi90/service (for RDi 9.0/1/2)

    or

    http://www.sequel-software.com/abstract/rdi95/service (for RDi 9.5)

    Press OK.

  4. Check the item displayed, and press Next to continue (there will only be one item listed, and its value will change based on the URL selected in step 3).

  5. The next Install window displays the ABSTRACT feature. Press Next.

  6. Check the button to accept the license agreement and press Finish to complete the install.

  7. When prompted, press Yes to restart Rational Developer.

    Note: When Rational Developer restarts, the path for the ABSTRACT plug-in needs to be manually adjusted for 64 bit Windows systems.

    To change the path, navigate in RDP/RDi to Window\Preferences.

    1. For versions prior to 9.5 expand the Help directory and select HelpSystems Abstract directories.
      For version 9.5, expand the ABSTRACT Directory Preferences directory and select Abstract Executable Path.

    2. Use the Browse button on the right to set the path to:

      C:\PROGRAM FILES (X86)\IBM\CLIENT ACCESS\PLUGINS\ASC.ABSTRACT

 

Install, Update, or Convert the Abstract Plug-in for RDi 9.6

Note: Abstract Plug-in for RDi 9.6 is only supported on Windows 10 using IBM ACS Windows Application Package. See the next section in this documentation for more on this.

Steps

Be sure to first download the Abstract Plug-in for Eclipse zip file from HelpSystems, extract the contents to your desktop, and run the setupabstract.exe file. This installs several required Window modules.

Do the following to install, and add the plug-in to RDi.

  1. From RDi, select Help\Install New Software on the main menu.

  2. When the Install screen opens, press the Add button.

  3. In the Add Repository window, enter a Name, and the following URL:

    http://www.sequel-software.com/abstract/rdi96/service (for RDi 9.6)

    Press OK.

  4. Check the item displayed, and press Next to continue (there will only be one item listed, and its value will change based on the URL selected in step 3).

  5. The next Install window displays the ABSTRACT feature. Press Next.

  6. Check the button to accept the license agreement and press Finish to complete the install.

  7. When prompted, press Yes to restart Rational Developer.

 

Windows 10 and Access Client Solutions (ACS) Support

For Windows 10, the Abstract RDi plug-in requires IBM ACS Windows Application Package. IBM does not support the use of IBM i (System i, iSeries, Client) Access for Windows on Windows 10, and the Abstract RDi plug-in will not work with these older versions on Windows 10.

Follow the steps below to download and install IBM ACS Windows Application Package, and create connection definitions for your IBM i server(s).

Note: You must be registered on the IBM Entitled Software site with authorization for software downloads to gain access to the downloads pages. Contact IBM if you are having trouble finding the IBM i Access Solutions Windows Application Package. Also, Client Access must be removed before installing the Windows Application Package.

  1. In a browser, open the link: http://www-304.ibm.com/servers/eserver/ess/index.wss
  2. Click the Sign In Button.
  3. Enter log-in information and sign in.
  4. Click My Entitled Software in the upper left corner of page.
  5. Click Software Downloads.
  6. Select Operating System (ie. IBM i).
  7. Select Operating Release (ie. V7R1, V7R2, V7R3..).
  8. Click on Continue.
  9. Select Product Number for IBM I: 5770-SS1 (IBM i).
  10. Click on Continue at bottom of page.
  11. Verify / select Language.
  12. Click on Continue.
  13. Click the hide/show option for 5770-SS1 (IBM i) to list releases.
  14. Click the hide/show option to list products.

    Pick hide/show on either:

    5817: i7.1 B_GROUP1 v07.01.00,ENU,DVD

    5827: i7.2 B_GROUP1 v07.02.00,ENU,DVD

    5837: i7.3 B_GROUP1 v07.03.00, ENU,DVD

  15. Select IBM i Access Client Solutions - Win AP.
  16. Click on Continue at bottom of page.
  17. Click I Agree to download.
  18. Click Download Now.
  19. To install, follow the readme.txt instructions in the Documentation folder.

    Simplified instruction: Run setup.exe from 'Image32 for 32 bit systems', or 'Image64a for 64 bit systems'.

  20. Once Installed, the next step is to define your IBM i system(s): (or use Alternate Step 20 below)

    a. Start a DOS Command Window.

    b. To create a definition, run a command similar to:

    cwbcfg /r /host <<IBMiName>> /ipaddr <<198.xxx.xx.xxx>> /uid <<MyUserProfile>>

    where:

    <<IBMiName>> is the name of your IBM i host machine.

    <<198.xxx.xx.xxx>> is the IP address of your IBM i host machine.

    <<MyUserProfile>> is your IBM i user name.

 

Alternate Step 20

This alternate step uses the more graphical IBM Access Client Solutions to define IBM i host connections for use by the Abstract plug-in.

Steps 1-19 above MUST still be performed-IBM ACS Windows Application Package is required for Viewpoint, but IBM Access Client Solutions is not.

  1. Download IBM Access Client Solutions from IBM at:

    http://www-03.ibm.com/systems/power/software/i/access/solutions.html

  2. Once installed, start ACS, and in the Management panel, click on System Configurations, or select
    Actions\Management\System Configurations from the menu.

  3. Click New to add a new system. This part works much like Client Access.

  4. Once your systems are defined, close the System Configurations dialog, and select File\Copy Connections from the menu.

  5. In the Copy Connections dialog, you can copy host information from ACS to the Windows Application Package and vice versa. You can also use this panel to remove unwanted connections from either.

  6. Close this dialog when finished.

 


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

Last Modified On: February 12, 2018