Installing the iWay SDK

How to:

This section describes how to install the iWay SDK on your system.

Follow the procedure for your platform:
Top of page
x
Procedure: How to Install the iWay SDK on Windows

You must be an administrator for the local machine to run the installation. To install iWay the SDK on Windows:

  1. Download and execute the iwaySDK6.1.6.exe file.

    The iWay SDK 6.1.6 Welcome window opens, as shown in the following image.

  2. Click Next.

    The License Agreement window for the iWay SDK opens, as shown in the following image.

  3. Review the license agreement, and click Yes if you agree to the terms and want to continue with the iWay SDK installation.

    The Customer Information window opens, as shown in the following image.

  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, as shown in the following image.

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

    The Ready to Install the Program window opens, as shown in the following image.

  7. Click Install.

    After the iWay SDK installation has finished, the following window is displayed.

  8. Click Finish.
Top of page
x
Procedure: How to Install the iWay SDK 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 iwSDK6.1.6.jar file must be placed in the USS file system.

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

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

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

    Welcome to the iWay SDK 6.1.6 Setup Wizard. This setup program installs iWay SDK 6.1.6.
sp5.31986
    Setup is using Windows XP 5.1 x86 Settings
File encoding is Cp1252, XML encoding is UTF-8
    Copyright (C) 2003-2012, 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.

  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 installation directory prompt appears:

    Destination Location
    Setup will install iWay SDK 6.1.6 in the following
location. Setup allows users to enter a different location.
    Directory: [/iwaySDK/6.1.6]

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

  9. 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]
  10. Press Enter to continue with the installation.

    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 SDK 6.1.6 will be installed in the following location:
/iwaySDK/6.1.6
    Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
  11. 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 SDK 6.1.6 on your system.
    Press 1 to Finish Setup [1]
  12. Press Enter to finish the installation.
iWay Software