Installing on Windows

Before you begin, see Minimum Hardware and Software Requirements.

Make sure you have added firewall rules for inbound and outbound connections between Web Services and Connect Direct Server. Firewall rules must allow inbound connections to the specified Web Services port. Connect Direct server must also have its API port open for web service.

To install IBM® Connect:Direct® Web Service on a Windows platform follow the steps given below.

  1. If you downloaded the software from IBM Passport Advantage, unzip the Installer zip file and double click on MFTWebServices.exe file.
    Note: For information on the how to download software using Passport Advantage see, Passport Advantage.
    InstallAnywhere window appears containing a progress bar and Cancel button. Wait for the progress bar to complete to 100%.
  2. Installation Folder window appears. This window serves as a welcome screen with a Guided Setup on the left. The Guided Step up is an installation status panel. As you complete each task, the status panel is updated. Click Next. In the Installation Folder window, use the default location or click Choose and specify a different location. Click Restore Default Folder to choose the default location.
  3. Click Next to continue.
  4. The Ports window appears. Enter the following:
    1. Secure Port that the Web Services uses to connect to the Web Server. For example,
      https://<hostname:port>/cdws-doc/signOn.html
      https://<hostname:port>/cdws-ui/index.html
           
      Default: 9443
    2. Enter PostgreSQL database connection details. For example:
      Default: 5342
      Password:<password>
      Re-Enter Password:<password>
  5. Click Next to continue.
  6. In the Pre-Installation Summary window, review the information, and then click Install.
  7. Generate Certificate window appears.
    This window informs the user of two certificate generation options available to the user.
    Click Next to continue.
  8. Choose Certificate window appears. This window provides users two options that can be used to generate a certificate:
    1. Default Certificate
    2. Self-Signed Certificate
    Note: When installation is complete, users can add a CA-signed certificate or any other certificate in the existing Keystore/Truststore. User can also add a new Keystore/Truststore. For more information, see Configuring Keystore/Truststore.
  9. Select Default option to generate a Default certificate. Click Next to continue
  10. The Certificate Details window appears. This window displays Default certificate details. To generate a Default Certificate, click Next.
  11. A Default certificate is generated and Installation Complete screen appears. Click Done.
  12. Alternatively, select Self-Signed option to generate a User-Defined certificate.
  13. The Keystore screen appears. Set the Keystore password to generate a self-signed certificate.
    Click Next.
  14. Enter the Keystore password again to confirm the user input. Click Next.
  15. The Self-Signed Certificate screen appears. Enter certificate details in the fields, as applicable. To generate a Self-Signed Certificate Next.

    Table below describes self-signed certificate field, descriptions, example, and default values.

    Table 1. Self-Signed Certificate generation field descriptions
    Fields Description Example value Default Value
    Certificate label Any descriptive name to identify the certificate. mycertificatename connectdirectwebservices
    Certificate Expiry Time Enter the certificate expiration date in days 278 days 365 days

    Max value: 3649 days

    Common Name (CN) Identifies the host name associated with the certificate yourdomain <hostname>
    Organization

    The legal name of your organization. This should not be abbreviated and should include suffixes such as Inc, Corp, or LLC.

    Note: Do not abbreviate or use any of these symbols: ! @ # $ % ^ * ( ) ~ ? > < / \.
    MyOrganizationName Inc. organizationname
    Locality

    The city where your organization is located.

    Irving Irving
    State The state/region where your organization is located.
    Note: Do not use abbreviations.
    Texas Texas
    Country

    The two-letter ISO code for the country where your organization is location.

    US US
    E-mail ID An email address used to contact your organization. support@mydomain.com noreply@noreply.com
  16. Self-Signed certificate details summary window appears. Click Next to continue.
  17. A Self-Signed certificate is generated and Click Next to continue.
  18. Installation Complete screen appears. Click Done.