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,
      Default: 9443
    2. Enter PostgreSQL database connection details. For example:
      Default: 5342
      Re-Enter Password:<password>
      Attention: CDWS onwards steps related to Postgres are not applicable
  5. Click Next to continue.
  6. In the Pre-Installation Summary window, review the information, and then click Install.
  7. The Enter Keystore Password screen appears.
  8. Enter the Keystore password again to confirm the user input. Click Next.
  9. Configure Certificate window appears.
    This window provides users two options that can be used to configure a certificate:
    1. Generate Self Signed Certificate
    2. Import CA 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.
  10. Select Generate Self Signed Certificate option to generate a User-Defined certificate.
  11. The Self Signed Certificate screen appears. Enter certificate details in the fields, as applicable. To generate a Self Signed certificate click 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 mftwebservices
    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>

    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

    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

    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.
    DNS Name Identifies the domain name associated with the certificate. localhost <hostname>
    IP Address Identifies the IP Address associated with the certificate. <IPv4 address>
  12. Self Signed certificate details summary window appears. Click Next to continue.
  13. Self Signed certificate is generated and Click Next to continue.
  14. Installation Completed screen appears. Click Done.
  15. Alternatively, users can select Import CA Signed Certificate option to configure a CA Signed certificate in keystore.
  16. In the Select CA Signed certificate screen, user has to choose a valid path to the CA signed certificate to be imported.
    Note: Certificate file must be either in PEM or PCKS12 format and it must contain the private key, the CA signed certificate, the CA certificate and all intermediate certificates.
  17. Enter the Private key password of the certificate. Click Next to import the certificate.
  18. The certificate will get imported successfully. Click Next to continue.
  19. Installation Completed screen appears. Click Done.