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 V7R1 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: If you plan to override any install defaults, you must use Staged Load to ensure proper configuration. 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. Place one of of the following options next to the Load Name for Abstract and press Enter:

    • Option if you are overriding any install defaults. (recommended in most situations)
    • Option 8 if you want to copy the Load command for use in a job scheduler or to submit the load now. (not recommended)
    • Option 2 does not apply to Apstract as a pre-check is not required.
    • Option 4 to delete the save file associated with the product.
  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:
    Run Interactively - This is the default. 
    Submit to Lib/Jobd - Submit the install as a batch job. Enter the library and job description to run the install in batch.

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

    Install Esend? - Check Yes to install Sequel Software’s email support product, Esend. Leave empty to not install Esend.

    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.x

Install the RDP 8.x / RDi 9.x Plug-in

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

Do the following to install the plug-in.

  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

 


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

Last Modified On: September 02, 2017