Installing iWay Trading Partner Manager on Windows

On Windows, the iWay Trading Partner Manager (TPM) installer is packaged as a self-extracting (.exe) file (for example, tpm-installer-1.5.x-Windows.exe).

Before continuing with the iWay TPM installation, create a directory on your file system for your JDBC driver .jar files. For example:

C:\jdbcjars

Copy your JDBC driver .jar files to this directory, as shown in the following image.

In addition, create a directory on your file system where you would like to install iWay TPM. For example:

C:\iWay_TPM

To install and run iWay TPM:

1. Double-click the iWay TPM installation file (for example, tpm-installer-1.5.x-Windows.exe).

   The iWay TPM installer (InstallAnywhere) loads on your system, as shown in the following image.

   

   If you already have an instance of iWay TPM installed on your system, then the Manage Instances dialog box is displayed, as shown in the following image.

   

   You can install a new instance of iWay TPM if there is already one installed. Select Install a New Instance, and then click OK.

   Note: Do not use the Modify an Existing Instance option, which is not supported in the current release.

   Once loaded, the Introduction screen of the iWay TPM installer is displayed, as shown in the following image.

   
2. Click Next.

   The Choose Installation Folder screen is displayed, as shown in the following image.

   
3. Click Choose, and select the directory you created before you started the installation (for example, C:\iWay_TPM).
4. Click Next.

   The Choose Java Virtual Machine screen is displayed, as shown in the following image.

   
5. Select a specific version of Java that is installed on your system, or accept the default version that is automatically detected by the installer.
6. Click Next.

   The Specify Location of JDBC .jar Files screen is displayed, as shown in the following image.

   
7. Select the directory on your file system you created earlier, which contains your JDBC driver .jar files (for example, C:\jdbcjars).
8. Click Next.

   The Specify TPM Server Port Number screen is displayed, as shown in the following image.

   
9. Specify an available port number on your system to be used by the iWay TPM server.

   Note: The older versions of iWay TPM used port 8080 as default port number. To avoid any conflicts with your previous version of iWay TPM, it is recommended to use a different port number (for example, 8092) with the new version of iWay TPM.

10. Click Next.

    The Enter TPM Database Parameters screen is displayed, as shown in the following image.

    
11. Select SQL Server, Oracle, or Postgres as the database type.
12. Enter the JDBC driver class name, connection URL string, and user name for the database you are configuring with iWay TPM.

    JDBC Driver Classes

    SQL Server:

    com.microsoft.sqlserver.jdbc.SQLServerDriver

    Oracle:

    oracle.jdbc.driver.OracleDriver

    Postgres:

    org.postgresql.Driver

    Connection URLs

    SQL Server:

    jdbc:sqlserver://[HOST][INSTANCE][:PORT][;databaseName=[DB]]

    Oracle:

    jdbc:oracle:thin:@[HOST][:PORT]:[SID]

    Postgres:

    jdbc:postgresql://[host]:[port]/[databasename]

13. Click Next.

    The Enter Password screen is displayed, as shown in the following image.

    
14. Enter the password for the database you are configuring with iWay TPM.
15. Click Next.

    The TPM database connection test results screen is displayed, which shows the results of a connection test to your database, as shown in the following image.

    
16. If the connection test is successful, click Next to continue. If you encounter any issues, click Previous to adjust your database connection parameters and retest your connection.

    Note any messages regarding running SQL scripts to create database tables or update an existing database. If you are required to run any SQL scripts, then see Using SQL Scripts for more information.

    The Install TPM as a Windows Service screen is displayed, as shown in the following image.

    
17. Click Yes if you would like to install TPM as a Windows service.
18. Click Next to continue.

    The Pre-Installation Summary screen is displayed, as shown in the following image.

    
19. Review the iWay TPM installation summary and click Install if all of the information is correct. If you want to change any value, click Previous to return to the appropriate screen.

    A progress indicator is displayed during the iWay TPM installation, as shown in the following image.

    

    When the installation has finished, a prompt to start the iWay TPM server is displayed, as shown in the following image.

    

    If you selected to install iWay TPM as a Windows service earlier in the installation (Step 17), then you can now start the iWay TPM Server.

20. Click Yes, and then click Next.

    iWay TPM will automatically start and run in the background.

    

    For more information on how to start and stop iWay TPM through the Windows Start menu, see Using the Start and Stop Menu Options.

    The Install Complete screen is displayed, as shown in the following image.

    
21. Click Done.

    You are now ready to run iWay TPM and verify your installation.

22. Open your browser and enter the following URL:

    http://hostname:port_number

    where:

    hostname

    Is the name of the system hosting iWay TPM.

    port_number

    Is the port number that you specified for the iWay TPM server during the installation. For example:

    http://localhost:8092

    The iWay TPM login page opens in your browser, as shown in the following image.

    
23. Enter the following default login credentials:
    • Username: admin
    • Password: iway
24. Click Sign in to begin using iWay TPM.

    The iWay Trading Partner Manager console opens, as shown in the following image.