Verify Integrator Upgrade

Installing LANSA on IBM i

Verify Integrator Upgrade

Check for the completion message:
          UPGRADE OF LANSA INTEGRATOR COMPLETED, PLEASE CHECK THE JOB LOG.

If you do not see this message:

     ****All selected LANSA components have been successfully installed/upgraded**

 

read the other messages in the job log and perform any suggested actions.

The Integrator upgrade program restores the JSM properties and JAR files and only partially upgrades the Java Service Manager.

The first time you start the Java Service Manager after an upgrade, it will run for a short while and, if the upgrade has been successful, it will restart itself, ready for you to use. If the upgrade has not been successful, the Java Service Manager will not start.

You can check the Java Service Manager upgrade's progress by viewing the UPGRADE-LOG.TXT file (example below) in the JSM instance directory. Always check this file for completion messages, to be sure that the upgrade has been completed successfully.

      Upgrade JSM instance : /jsm/instance -

      Upgrade properties file : manager.properties

      Properties file upgraded

      -

      Upgrade properties file : service.properties

      Properties file upgraded

      -

      -

      Upgrade properties file : XMLQueueService.properties

      Properties file upgraded

      -

      Upgrade completed

      Remove upgrade files

      -

      Delete file : /devjsm/instance/upgrade/mailcap.txt

      -

      Delete file : /devjsm/instance/upgrade/integrator-feature.txt

      -

      -

      Delete upgrade directory

      -

      Removal completed

User Exit programs

If User Exit programs JSMADMEXT, JSMDRTEXT, JSMLSAEXT and JSMPXYEXT are used they should be checked and recompiled. Samples are provided in file QCLSRC. For information, refer to Exit Programs (IBM i).

Review files and manually adjust

After the upgrade has completed it is important to review the files and make some manual adjustments.

All the properties files will contain Integrator Studio sections and an "unassigned" section. This section contains lines that did not belong to a section.

Review the unassigned section for possible configuration entries. Normally this section just contains # comments and the whole section can be deleted.

      #!<studio-project id="00000000-000000" name="unassigned">

      #

      # Move these entries to a new or existing studio-project section.

      # Delete this unassigned section.

      #

      #

      #!</studio-project>

After reviewing the files, start the JSM instance again and the instance will be ready.

PKI Editor

The PKI Editor is available for use when using the secure mime feature to send and receive e-mails using the SMTP mail, POP3 mail and EDI-INT (AS2) services. This is only available if the secure mime jar files are installed. These jar files are not shipped with LANSA Integrator as these files relate to Public Key encryption which must be purchased separately from Phaos Technology Corporation to support secure mime (SMIME). In particular, the software that needs to be purchased is:

  • Phaos Security Engine
  • Phaos CMS
  • Phaos S/MIME 

Please refer to the Phaos Technology Corporation web site for more information.