GUIStyle Administration Tool Installation
Product: Strategi - GUIStyle
Modified Date:

This guide provides the steps required to successfully install GUIStyle by ADVANCED BusinessLink Corporation. All steps below should be completed in the order listed. Any questions regarding installation procedures may be forwarded directly to BusinessLink Technical Support for resolution, which can be reached by phone at (425) 602-4777 or by email at support@businesslink.com.

If you already have Administration portion of the GUIStyle Product Module (check for the existance of a GUIADMIN HSM Server) installed on your system and have been instructed to upgrade, please reference Strategi GUIStyle Upgrade.

Step 1 - Verify Installation Requirements
In order to install or use the GUIStyle product, the following requirements must be met:

  1. Your Strategi version must be at least V1R8M3 with all available PTFs. If this requirement has not been met, please contact BusinessLink Technical Support for assistance before proceeding.

  2. Your OS/400 version must be at least V4R4M0.

  3. You must have Java 1.1.8 installed on your iSeries.

  4. In order for the GUIStyle Administration Tool (which is written in Java), to access its databases, the following commands will also have to be run. These allow Java to work with databases. If these are already running, you do not need to do anything.

    STRSBS QSYSWRK
    STRSBS QSERVER
    STRHOSTSVR SERVER(*DATABASE) RQDPCL(*NONE)

  5. As with the Strategi install, *SECOFR class operator authority

Step 2 - Place the GUIStyle Product Module on your iSeries
Contact ADVANCED BusinessLink in order to find out how to download the GUIStyle product, as well as to purchase and install a license for the product. Currently two license levels are available for the product. The first level allows for use of the GUIStyle emulation applet and simple template import functionality. The second level allows for full use of the GUIStyle Administration tool.

In the standard procedure, you will download a file named guiVRM.gz or guiVRM, where VRM is the version, release number, and modification. If the gz is downloaded, you must extract guiVRM from it, which can be done on your PC with WinZip or another zip extraction application. You will then need to move the save file contents into a save file named GUIADMIN on your iSeries 400 in a library of your choice. There are a variety of methods for moving save files from your PC to the iSeries 400. The technical support bulletin titled iSeries 400 - PC Save File Transfer Using FTP explains one method.

Once you have the save file on your iSeries 400, you will need to determine what Strategi version you have:

STRATEGI/DSPSGIVAL RELEASE


 If your Strategi version is V1R8, proceed to Step 3 for SGIV1R8. Otherwise, proceed with Step 3 for SGIV1R9 or Higher

Step 3 for SGIV1R8 - Install the GUIStyle Product Module on SGIV1R8


Once the installation save file is on your iSeries 400 in a library of your choosing, and named GUIADMIN, following these steps will install the GUIStyle server, applet, administrative pieces, and templates.

  1. Your Strategi library must be on your library list

    ADDLIBLE STRATEGI
  2. You must create a website named PRODUCTMODULES with the following command:

    CRTSGIWEB +
        SITE(PRODUCTMODULES) +
        TEXT('Strategi Product Modules') +
        IPADD(*NONE *NONE) +
        STATUS(*SUSPENDED)


     Note: The website must be created with precisely these parameters. Failure to follow these instructions will result in an unusable installation.

  3. Install the GUIAdmin HSM server. This also installs the GUIStyle applet, the GUIStyle administration tool, and the default templates. Note you will need to change "QTEMP" below to the name of the library where you put the GUIADMIN save file.

    INSHSMSVR +
        SVRNAM(GUIADMIN) +
        LIB(GUISTYLE) +
        DIR(PRODUCTMODULES '/guistyle') +
        SAVF(QTEMP/GUIADMIN)
  4. Strategi must be restarted

    ENDSGI +
        RESTART(*YES)
  5. Anyone who needs to be able to use the GUIStyle administration tool should be added to the GUISTYLE Strategi user group:

    ADDSGIGRPM +
        GROUP(GUISTYLE) +
        MBR(*USER (*SELECT))
  6. If you have installed GUIStyle to a library named something other than “GUISTYLE”, you will need to edit the file /strategi/website/productmodules/live/guistyle/admin/serverPropertiesFile.txt, and change the line which says “library = GUISTYLE”, replacing “GUISTYLE” with the appropriate library name. The GUIADMIN HSM Server will need to be restarted for this to take effect.

Step 3 for SGIV1R9 or Higher - Install the GUIStyle Product Module on SGIV1R9 or Higher


Once the installation save file is on your iSeries 400 in a library of your choosing, and named GUIADMIN, following these steps will install the GUIStyle server, applet, administrative pieces, and templates.

  1. Your Strategi library must be on your library list

    ADDLIBLE STRATEGI
  2. Install the GUIAdmin HSM server. This also installs the GUIStyle applet, the GUIStyle administration tool, and the default templates. Note you will need to change "QTEMP" below to the name of the library where you put the GUIADMIN save file.

    INSHSMSVR +
        SVRNAM(GUIADMIN) +
        LIB(GUISTYLE) +
        DIR(PRODUCTMODULES '/guistyle') +
        SAVF(QTEMP/GUIADMIN) +
        DIROPT(*UPDATE)
  3. Strategi must be restarted

    ENDSGI +
        RESTART(*YES)
  4. Anyone who needs to be able to use the GUIStyle administration tool should be added to the GUISTYLE Strategi user group:

    ADDSGIGRPM +
        GROUP(GUISTYLE) +
        MBR(*USER (*SELECT))
  5. If you have installed GUIStyle to a library named something other than “GUISTYLE”, you will need to edit the file /strategi/website/productmodules/live/guistyle/admin/serverPropertiesFile.txt, and change the line which says “library = GUISTYLE”, replacing “GUISTYLE” with the appropriate library name. The GUIADMIN HSM Server will need to be restarted for this to take effect.

** End of Technical Support Bulletin **