How to Install iWay 8.0 Service Manager on UNIX, OS/400, and z/OS Platforms

On UNIX/Linux, installing as root is not recommended. Creating a dedicated iWay user ID and group with appropriate rights is preferable.

On OS/400, your user ID must have *ALLOBJ, *JOBCTL, and *SAVSYS authority.

On z/OS, the iway80.jar file must be placed in the USS file system.

The new unified iWay installer can enable silent, unattended installation. Contact iWay Customer Support for more information.

  1. Use FTP in binary mode to transfer the installation file to your UNIX or OS/400 machine. For OS/400, place the file in a directory under QSH.
     
  2. Navigate to the directory containing the installation file. On OS/400, you must be running under QSH.
     
  3. Ensure the installation file is executable, for example:
    chmod 755 iway80.jar
  4. Start the installation by executing:
    java -jar iway80.jar

    The installation initializes, which may take some time. When initialization is complete, a Welcome prompt appears:

    Welcome to the iWay 8.0.2.101 Service Manager Setup Wizard. This setup program installs iWay 8.0.2.101 Service Manager on this system.
    8.0.2.101
    Setup is using Windows 10 10.0 amd64 Settings
    File encoding is Cp1252, XML encoding is UTF-8
    Copyright (C) 2003-2018, iWay Software/Information Builders, Inc. All Rights Reserved.
    Press 1 for Next, 2 to Cancel [1]

    Note: If the installation does not launch, ensure that /JAVA_HOME/bin is in your $PATH variable. See Java Requirements for information on setting up your Java environment.

  5. Press Enter to continue.

    A license agreement appears.

  6. Review the agreement and press Enter until you see the following prompt:
    Please choose from the following options:
    [ ] 1 - I accept the terms of the license agreement.
    [X] 2 - I do not accept the terms of the license agreement.
    To select an item enter its number, or 0 when you are finished: [0]
  7. If you accept the terms, type 1 and press Enter.

    The prompt repeats showing the new value.

    [X] 1 - I accept the terms of the license agreement.
    [ ] 2 - I do not accept the terms of the license agreement.
    To select an item enter its number, or 0 when you are finished: [0]
  8. Type 0, then press Enter to continue.

    The Customer Information prompts appear:

    Customer Information
    Please enter your information.
    User Name: [unknown]
  9. Enter a user name for the product registration and then press Enter. This user name does not affect product operations.
    Company Name: [unknown]
  10. Enter your company name for the product registration and then press Enter.
    Site Code: [nnnx.nn] or q to quit: [unknown]
  11. Enter your site code or press q to quit, and then press Enter.

    Important: The site code is a unique company identifier associated with a specific machine. Be sure to enter a valid and accurate site code in this step because this entry is used when generating your permanent license during the registration process. If you need assistance with the site code, contact your Information Builders sales representative.

    The Navigation prompt appears:

    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  12. Press Enter to continue.

    The installation directory prompt appears:

    Destination Location
    Setup will install iWay 8.0.2.101 Service Manager in the following location. Setup allows users to enter a different location.
    Directory: [/iway/install/iWay8]

    Note: On Linux systems, you may need to change the default directory that appears. The default directory normally should be named iWay8, but some Linux environments do not follow this default.

  13. Specify where to install iWay on your system and then press Enter. Ensure this is a directory to which you have write access.

    The navigation prompt appears.

    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  14. Press Enter.

    The following prompt for iWay adapter selection appears.

    iWay Adapters
    iWay 8.0.2.101 Service Manager is packaged with a subset of iWay adapters.
    From the list below select the adapter(s) you want to install with your
    configuration.
    [ ] 1 - Technology Adapters
    [ ] 2 - Application Adapters
    [ ] 3 - eBusiness Adapters
    [ ] 4 - Legacy Adapters
    [ ] 5 - Queuing Adapters
    [ ] 6 - Protocol Adapters
    [ ] 7 - IOT Protocols
    Enter a number, (a)ll, (n)one or 0 to finish: [0]

    Note: An X next to an adapter category indicates one or more adapters are selected.

  15. Type the number of the adapter you want to install and press Enter.

    Note: You can only enter one adapter number at a time.

  16. When you are finished with your selections, type 0 and press Enter.

    You are returned to the iWay Adapters selection prompt.
    iWay Adapters
    iWay 8.0.2.101 Service Manager is packaged with a subset of iWay adapters.
    From the list below, select the adapter(s) you want to install with your
    configuration.
    [ ] 1 - Technology Adapters
    [ ] 2 - Application Adapters
    [ ] 3 - eBusiness Adapters
    [ ] 4 - Legacy Adapters
    [ ] 5 - Queuing Adapters
    [ ] 6 - Protocol Adapters
    [ ] 7 - IOT Protocols
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  17. Type 0 and press Enter.

    The navigation prompt appears.

    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  18. Type 1 and press Enter to continue.

    The Extensions menu appears.

    Extensions
    iWay 8.0.2.101 Service Manager comes with a set of additional components that can be used to extend standard functionality. 
    From the list below, select the extension(s) you want to install.
    [ ] 1 - Gateway (RVI)
    [ ] 2 - Enterprise Index
    [ ] 3 - LDAP High Water Mark Listener
    [ ] 4 - RDBMS High Water Mark Listener
    [ ] 5 - Hot backup
    [ ] 6 - Compatibility Services
    [ ] 7 - PGP Encryption Components
    [ ] 8 - Security Developers Tools
    [ ] 9 - Data Quality Service
    [ ] 10 - Real-Time Data Replication
    [ ] 11 - XQuery
    [ ] 12 - MongoDB Connector
    [ ] 13 - Simple Network Management Protocol Agent (SNMP)
    [ ] 14 - Command Scheduler
    [ ] 15 - Java Scripting Engine
    [ ] 16 - Schema Validation Services
    [ ] 17 - Advanced XML Digital Signature
    [ ] 18 - De-identification Services
    [ ] 19 - Envoy
    [ ] 20 - Open Rules Decision Management Integration
    [ ] 21 - PDF Services
    [ ] 22 - Twilio based messaging, voice, and video cloud services
    [ ] 23 - WebFOCUS support
    [ ] 24 - Twitter
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  19. Type the number of the extension you want to install and press Enter.

    Note: You can only enter one extension number at a time. When you press Enter, the Extensions menu reappears with your selection checked.

  20. When you are finished with your selections, type 0 and press Enter.

    The navigation prompt appears.

    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  21. Type 1 and press Enter to continue.

    You are prompted for the iWay port assignments. You can accept the default value listed with each prompt or type a new value appropriate for your installation, and press Enter.

    Resource Assignments
    Setup allows users to customize the default port numbers used within 
    the installed iWay 8.0.2.101 Service Manager configuration.
    Console Port [9999]
    SOAP Port [9000]
    Envoy Port [9001]
    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

    Note: The Envoy Port option is displayed only if Envoy is selected in the Extensions menu.

  22. Type 1 and press Enter to continue.

    If you selected Envoy in the Extensions menu, then you are prompted for Sentinel Registration. You can accept the default value listed with each prompt or type a new value appropriate for your installation, and press Enter.

    Sentinel Registration
    This version of Service Manager can be remotely managed by iWay Sentinel. Enter the following to enable self-registration with Sentinel.
    Host: [localhost]
    Port: [8080]
    Userid: [admin]
    Password: [admin]
    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  23. Type 1 and press Enter to continue.

    A notice and summary are displayed to inform you that you have provided enough information to start copying files.

    Start Copying Files
    Setup has enough information to start copying the program files. If you
    want to review or change any settings, now is the time to do so.
    iWay 8.0.2.101 Service Manager will be installed in the following location:
    /opt/iway/iWay8
    The base configuration will be installed with the following settings:
       Default console userid is set to iway
       Default console password is set to iway
       Default console port is set to 9999
       Default SOAP port is set to 9000
       Default ENVOY port is set to 9001
       Register with Sentinel as admin,admin@localhost:8080
       Site Code is 9999
    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  24. Press Enter to start the installation.

    The Setup Status information is displayed.

    Setup Status
    Setup is configuring your new software installation.
     |----------|----------|----------|----------|
    0%        25%        50%        75%      100%
    ||||||||||||||||||||||||||||||||||

    Once installation has finished, a message appears indicating that the setup is complete.

    Setup Completes
    Setup has finished installing iWay 8.0.2.101 Service Manager on your system.
    Press 1 to Finish Setup [1]