Installing iWay 6.0.1 SM

In this section:

The initial iWay installation procedure installs all iWay components and a set of adapters. These components and adapters are available for a 90-day trial. To receive a permanent license after you have installed iWay 6.0.1 SM, register the software using the instructions found in Registering iWay Software.

Additional procedures are found throughout this manual to explain how to activate and configure the components of iWay 6.0.1 SM.


Top of page

x
iWay 6.0.1 SM Installation

Follow the procedure for your platform:



x
Procedure: How to Install iWay 6.0.1 SM on Windows

You must be an administrator for the local machine to run the installation.

  1. Start the installation by executing the installation program. The name of the installation program may vary, for example:
    iway60.exe

    The installation begins by temporarily copying files and analyzing your environment. This may take some time. When this completes, the Welcome window opens.

    Note: If you receive an error, ensure you are installing as an administrator and ensure there is at least 2 GB of free space on your operating system drive.

    If you are installing iWay 6.0.1 SM on Windows Vista, please note that the User Account Control (UAC) mode is enabled by default. UAC is a special mode of operation available on Windows Vista that affects the functionality of administrator accounts. To avoid any errors that deny access, you must grant permission to the iWay 6.0.1 SM installation program to use administrator privileges. As a workaround, right-click the iway60.exe file and select Run as administrator from the context menu.

  2. Click Next at the Welcome window.

    The License Agreement appears.

  3. Review the information, and click Yes if you agree to the terms.

    The Customer Information window opens.

  4. Provide your User Name, Company Name, and Site Code.

    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 iWay Software sales representative.

  5. Click Next.

    The Choose Destination Location window opens.

  6. Accept the default or click Browse to specify a new location. Then, click Next.

    A Window appears in which you select the adapters and components you want to install. Be sure to expand all folders to see the available sub-components.

  7. Check the adapters and/or components you wish to install and click Next.

    You can choose which extensions to install. Information on the extensions appears in iWay 6.0.1 SM Installation Overview.

  8. Check the extensions to install if prompted.

    You are prompted to specify the ports that iWay Service Manager uses.

    Name

    Default Port

    Purpose

    Console Listener

    9999

    HTTP listener for the Service Manager Console.

    SOAP Listener

    9000

    SOAP listener for iBSP and iWay Explorers.

  9. Accept the defaults or specify new values and then click Next.

    Note: Be sure to specify ports that are not being used by other programs or by another instance of iWay. If necessary, contact your system administrator for assistance in identifying available TCP ports.

    The Start Copying Files window opens.

  10. Click Install to start the installation.

    Files are copied to your system in the directory you specified.

    You have the option to start the Service Manager when installation completes. If you choose this option, the Web Console launches in your default Web browser. You can logon to the Web Console using the default user name "admin" and password "admin." You can change the user name and password as explained in Configuring iWay Components.

  11. Click Finish to complete the installation Wizard.
  12. Proceed to Post-Installation Topics and Tasks. For maximum performance, we strongly recommend that you follow the post‑installation procedure for Setting up the iWay Service Manager Service as a Separate Process.


x
Procedure: How to Install iWay 6.0.1 SM on UNIX, OS/400, and z/OS

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

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

On z/OS, the iway60SM.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 iway60SM.jar
  4. Start the installation by executing:
    java -jar iway60SM.jar

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

    Welcome to the iWay 6.0.1 Service Manager [GA] Setup Wizard. This setup program
    installs iWay 6.0.1 Service Manager [GA] on this system.
    6.0.1 - beta1.18429
    Setup is using Windows XP 5.1 x86 Settings
    File encoding is Cp1252, XML Encoding is UTF-8
    Copyright (C) 2003-2009, 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.

    The Customer Information prompts appear:

    Customer Information 
    Please enter your information.
    User Name: []
  9. Enter a user name for the product registration and then press Enter. This user name does not affect product operations.
    Company Name: []
  10. Enter your company name for the product registration and then press Enter.
    Site Code: []
  11. Enter your site code and 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 6.0.1 Service Manager [GA] in the following
    location. Setup allows users to enter a different location.
    Directory: [/iway/install/iWay60]
    /opt/iway/iWay60

    Note: On Linux systems, you may need to change the default directory that appears.The default directory normally should be named iWay60, 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.

    A 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 6.0.1 Service Manager [GA] is packaged with a subset of iWay adapters. From the list below select the adapter(s) you want to install with your configuration.
    [x] 1 - Technology Adapters
    [ ] 2 - ERP Adapters
    [ ] 3 - eBusiness Adapters
    [ ] 4 - Legacy Adapters
    [ ] 5 - Protocol Adapters
    Enter a number, (a)ll, (n)one or 0 to finish: [0]

    Note: The X next to an adapter category indicates one or more adapters are selected. iWay Service Manager includes three Technology Adapters by default (iWay Adapter, JAVA Adapter, and RDBMS Adapter).

  15. To view and select the Technology Adapters, type 1 and press Enter.

    The selection of available Technology Adapters appears.

    Technology Adapters
    iWay Technology Adapters provide connectivity to access data,technologies and protocols that enhance integration.
    [X] 1 - iWay Adapter
    [X] 2 - JAVA Adapter
    [X] 3 - RDBMS Adapter
    [X] 4 - Microsoft .NET Adapter
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  16. Type the number of the adapter you want to install and press Enter.

    Note: You can only enter one adapter number at a time. When you press Enter, the Technology Adapters list reappears with your selection checked.

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

    The iWay Adapters menu appears.

    iWay 6.0.1 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.
    [x] 1 - Technology Adapters
    [ ] 2 - ERP Adapters
    [ ] 3 - eBusiness Adapters
    [ ] 4 - Legacy Adapters
    [ ] 5 - Protocol Adapters
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  18. To view and select the ERP Adapters, type 2 and press Enter.

    The selection of available ERP Adapters appears.

    ERP Adapters
    iWay ERP Adapters provide transaction level access to the most popular ERP, CRM, and SCM packages.
    [ ] 1  - MySAP Adapter
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  19. Type the number of the adapter you want to install and press Enter.

    Note: You can only enter one adapter number at a time. When you press Enter, the ERP Adapters list reappears with your selection checked.

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

    The iWay Adapters menu appears.

    iWay 6.0.1 Service Manager [GA] is packaged with a subset of iWay adapters. From the list below select the adapter(s) you want to install with your configuration.
    [x] 1 - Technology Adapters
    [x] 2 - ERP Adapters
    [ ] 3 - eBusiness Adapters
    [ ] 4 - Legacy Adapters
    [ ] 5 - Protocol Adapters
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  21. To view and select the eBusiness Adapters, type 3 and press Enter.

    The selection of available eBusiness Adapters appears.

    iWay eBusiness Adapters allow the user to easily transform B2B messages into XML formats
    [ ] 1 - EDI/X12 Adapter
    [ ] 2 - SWIFT Services
    [ ] 3 - Excel Adapter
    [ ] 4 - Trading Manager
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  22. Type the number of the adapter you want to install and press Enter.

    Note: You can only enter one adapter number at a time. When you press Enter, the eBusiness Adapters list reappears with your selection checked.

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

    The iWay Adapters menu appears.

    iWay 6.0.1 Service Manager [GA] is packaged with a subset of iWay adapters. From the list below select the adapter(s) you want to install with your configuration.
    [x] 1 - Technology Adapters
    [x] 2 - ERP Adapters
    [x] 3 - eBusiness Adapters
    [ ] 4 - Legacy Adapters
    [ ] 5 - Protocol Adapters
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  24. To view and select the Legacy Adapters, type 4 and press Enter.

    The selection of available Legacy Adapters appears.

    iWay Legacy Adapters provide fast and efficient access to TP environments like CICS, IMS/TM
    [ ] 1 - CICS
    [ ] 2 - IMS
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  25. Type the number of the adapter you want to install and press Enter.

    Note: You can only enter one adapter number at a time. When you press Enter, the Legacy Adapters list reappears with your selection checked.

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

    The iWay Adapters menu appears.

    iWay 6.0.1 Service Manager [GA] is packaged with a subset of iWay adapters. From the list below select the adapter(s) you want to install with your configuration.
    [x] 1 - Technology Adapters
    [x] 2 - ERP Adapters
    [x] 3 - eBusiness Adapters
    [x] 4 - Legacy Adapters
    [ ] 5 - Protocol Adapters
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  27. To view and select the Protocol Adapters, type 5 and press Enter.

    The selection of available Protocol Adapters appears.

    Protocol Adapters (also called listeners) interact with protocol-based message sources
    [ ] 1 - AQ Components
    [ ] 2 - Extended AS2 (nAS2)
    [ ] 3 - AS2 Compatible with 5.x Servers
    [ ] 4 - IBI CS3 Protocol
    [ ] 5 - MSMQ Components
    [ ] 6 - SMB/CIFS (SAMBA)
    [ ] 7 - Sonic JMS
    [ ] 8 - Tibco RV Components
    [ ] 9 - FTP Server
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  28. Type the number of the adapter you want to install and press Enter.

    Note: You can only enter one adapter number at a time. When you press Enter, the Protocol Adapters list reappears with your selection checked.

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

    The Extensions menu appears.

    Extensions
    iWay 6.0.1 Service Manager [GA] 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
    [ ] 2 - Enterprise Index
    [ ] 3 - LDAP High Water Mark Listener
    [ ] 4 - RDBMS High Water Mark Listener
    [ ] 5 - SOAP JMS
    [ ] 6 - Service Monitor
    [ ] 7 - Telnet Control Console
    [ ] 8 - Hot backup
    [ ] 9 - 5.x Compatibility
    [ ] 10 - PGP Encryption Components
    [ ] 11 - Security Developers Tools
    [ ] 12 - Data Quality Center
    [ ] 13 - Application Compatibility
    [ ] 14 - Migration Tools
    Enter a number, (a)ll, (n)one or 0 to finish: [0]
  30. 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.

  31. When you are finished with your selections, type 0 and press Enter.
    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  32. 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 6.0.1 Service Manager [GA] configuration.
    Console Port [9999]
    SOAP Port [9000]
    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  33. Press Enter to continue with the installation.

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

    Start Copying Files
    Setup has enough information to start copy the program files. If you want to review or change any settings, now is the time to do so.
    iWay 6.0.1 Service Manager [GA] will be installed in the following location:
    /opt/iway/iWay60
    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
    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  34. Press Enter to start the installation.

    Setup status information is displayed.

    Setup Status
    Setup is configuring your new software installation.
     |----------|----------|----------|----------|
    0%        25%        50%        75%      100%
    ||||||||||||||||||||||||||||||||||
  35. Proceed to Post-Installation Topics and Tasks for information on customizing the iWay Service Manager profile and other settings.

iWay Software