Installing on Windows
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.
-
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%. - 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.
- Click Next to continue.
-
The Ports window appears. Enter the following:
- 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
- Enter PostgreSQL database connection details. For example:
Default: 5342 Password:<password> Re-Enter Password:<password>
Attention: CDWS 6.2.0.10 onwards steps related to Postgres are not applicable
- Secure Port that the Web Services uses to connect to the Web Server. For
example,
- Click Next to continue.
- In the Pre-Installation Summary window, review the information, and then click Install.
- The Enter Keystore Password screen appears.
- Enter the Keystore password again to confirm the user input. Click Next.
-
Configure Certificate window appears.
This window provides users two options that can be used to configure a certificate:
- Generate Self Signed Certificate
- 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. - Select Generate Self Signed Certificate option to generate a User-Defined certificate.
-
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> 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 DNS Name Identifies the domain name associated with the certificate. localhost <hostname> IP Address Identifies the IP Address associated with the certificate. 127.0.0.1 <IPv4 address> - Self Signed certificate details summary window appears. Click Next to continue.
- Self Signed certificate is generated and Click Next to continue.
- Installation Completed screen appears. Click Done.
- Alternatively, users can select Import CA Signed Certificate option to configure a CA Signed certificate in keystore.
-
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.
- Enter the Private key password of the certificate. Click Next to import the certificate.
- The certificate will get imported successfully. Click Next to continue.
- Installation Completed screen appears. Click Done.