Installing on UNIX
- Review the system requirements. For more information, 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 the Connect:Direct Web Services from command line on a UNIX Operating System follow the steps given below.
- If you are installing as a root user, the product will be installed across system and therefore,
it is recommended not to install as a root user. You should install it in a shared area with limited
access so as not to disrupt any permission changes on the
/root
directory. -
Ensure that you login to the same functional account to upgrade Connect:Direct Web Services.
-
If you have downloaded the software from IBM Passport Advantage go to the download
folder.
Note: Passport Advantage provides access to your IBM software purchases, so you can download products directly to the computers where you want to install them. For information on the how to download software using Passport Advantage see, Passport Advantage.
-
Untar the installer .tar.gz file and refer Installing, Uninstalling, and Upgrading IBM Connect:Direct Web Service
table.
% tar -zxvf $INSTALLER_FILENAME
-
Run the
remove/MFTWebServicesInstall.sh
script. To check privileges, run the following command.[user@xxd]# ls -l MFTWebServicesInstall.sh -r-xr-x---. 1 <user> <user> <filesize> <date> MFTWebServicesInstall.sh
-
The installation menu appears.
Preparing to install
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...
Launching installer...
============================================
MFTWebServices (created with InstallAnywhere)
-------------------------------------------------------------------------------
Preparing CONSOLE Mode Installation...
=============================================
Introduction
--------------------------------------------------------------------------------
Welcome to the installation wizard for MFTWebServices.
This wizard guides you through the installation of MFTWebServices.
You are strongly recommended to quit all programs before continuing with this
installation.
Respond to each prompt to proceed to the next step in the installation.
You may cancel this installation at any time by typing 'quit'.
Licensed Materials - Property of IBM Corp. © IBM Corporation and other(s).
2021.
-
Enter the absolute installation path and press ENTER to confirm the
location.
Choose Install Folder ----------------------------
Where would you like to install?
Default Install Folder: $HOME/MFTWebServices
ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
-
Enter Secure port number details that Connect:Direct Web Server uses to connect to the Web
Service and press ENTER to continue.
Port for Web Server --------------------------
Enter the ConnectDirectWebServices secure sever port.
eg. https://<hostname:port>/cdws-doc/signOn.html
https://<hostname:port>/cdws-ui/index.html
Secure Port (Default: 9443):
-
Enter the PostgreSQL Database Server port number and press ENTER to
continue.
Port for PostgreSQL ---------------------
Enter PostgreSQL Port
PostgreSQL Port (Default: 5432):
Password for PostgreSQL
---------------------
This installation requires a password to continue.
Please Enter the password:
PRESS <ENTER> TO CONTINUE:
=============================================
Re-Enter Password for PostgreSQL
---------------------
This installation requires to re-enter the password to continue.
Please Re-Enter the password:
PRESS <ENTER> TO CONTINUE:
-
Pre-Installation summary appears.
Press ENTER to continue.
Pre-Installation Summary
---------------------------------
Review the following information before you continue the installation:
Product Name:
MFTWebServices
Install Folder:
$HOME/MFTWebServices
Web Server Port
9443
PostgreSQL Port
5432
Version<$VERSION>
Disk Space Information (for Installation Target):
Required: 345 MegaBytes
Available: 5,000.26 MegaBytes
PRESS <ENTER> TO CONTINUE:
-
Certification Generation information screen appears. Press ENTER to
continue.
Generate Certificate
---------------------------
User can generate two types of certificate:
1. DEFAULT Certificate: The certificate is generated through default values of the system.
2. SELF SIGNED Certificate: The certificate is generated by taking input from the user.
Note: After successful installation, user can add a third party or any other
certificate in existing Keystore/Truststore.
User can also add a new Keystore/Truststore.
Please refer IBM CDWS documentation for more details
Press Enter to proceed.
-
Enter the Certificate option serial number for the certificate type that you would like to use
or generate a - Default, or Self-Signed certificate.
Note: When installation is complete, users can add a CA-signed certificate or any other certificate in existing Keystore/Truststore. Users can also add a new Keystore/Truststore. For more information, see Configuring Keystore/Truststore.
Choose certificate type ------------------------------
1. DEFAULT
2. SELF SIGNED
Enter Your Choice: (Default: 1): 1
If you enter [1], Default Certificate details display. Press ENTER to continue.Certificate Details
------------------------
The Certificate will be generated with following details:
________________________________________________________
Keystore NAME: ssl-server.jks
KEYSIZE: 2048
CERTIFICATE LABEL: connectdirectwebservices
CERTIFICATE EXPIRY TIME: 365 days
ORGANIZATION: OrganizationName
LOCALITY: Irving
STATE: Texas
COUNTRY: US
EMAIL ID: noreply@noreply.com
ALGORITHM: SHA256withRSA
COMMON NAME: <hostname>
PRESS <ENTER> TO CONTINUE:
A Default Certificate is generated.
Certificate Generated Successfully. Keystore NAME: ssl-server.jks
CERTIFICATE LABEL: connectdirectwebservices
PATH: /$HOME/MFTWebServices/mftws/BOOT-INF/classes/ssl-server.jks
ALGORITHM: SHA256withRSA
PRESS <ENTER> TO CONTINUE:
============================================================
Please Wait
-----------------------------------------------------------
...............................................................................
Installation Completed
-----------------------------------------------------------
Installation and Certificate generation is complete.
MFTWebServices-<$version> has been successfully installed to:
/$HOME/MFTWebServices
MFTWebservices User Interface is available at :
https://<hostname:port>/cdws-ui/index.html
MFTWebservices API reference is available at : https://<hostname:port>/cdws-doc/signOn.html
PRESS <ENTER> TO EXIT THE INSTALLER:
-
If you enter [2], user is prompted to set the Keystore password.
Enter Password ------------------------
Certificate Generation requires Password.
Please Enter the Password:
Note: Keystore password should not include any of these special characters, o "%^{}|<>~'!`. -
Enter the Keystore password again to confirm the user input in the previous step.
Confirm Password ----------------------------
Please Enter the Password again:
-
Answer the following prompts related to Self-Signed Certificate details.
Certificate Label -----------------------
Enter Certificate Label (Default: connectdirectwebservices):
=================================================
Certificate Expiry Time
-------------------------------
Enter Certificate expiry time(MAX value: 3649 days) (Default: 365):
===================================================
Common Name(CN)
---------------------------
Enter Common Name(CN) (Default: <hostname>)
====================================================
Organization Name
--------------------------
Enter name of the organization (Default: organizationname):
====================================================
Locality Name
--------------------
Enter name of the locality (Default: Irving):
====================================================
State Name
----------------
Enter name of the State (Default: Texas):
=====================================================
Country Name
---------------------
Enter Country Name (Default: US):
======================================================
Enter E-mail Address
----------------------------
Enter E-mail Address: (Default: noreply@noreply.com):
Table below describes self-signed certificate field, descriptions, example, and default values.
Table 1. Self-Signed Certificate generation entries and descriptions Entry Description Example value Default Value Certificate label Any descriptive name to identify the certificate. mycertificatename connectdirectwebservices Certificate Expiry Time Enter the certificate expiration time 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 -
Self-Signed certificate details display. Press ENTER to continue.
Certificate Details
-------------------------
The certificate will be generated with following details:
________________________________________________________
Keystore NAME: ssl-server.jks
KEYSIZE: 2048
CERTIFICATE LABEL:connectdirectwebservices
CERTIFICATE EXPIRY TIME: 365
CN: <hostname>
ORGANIZATION: MyOrganization
LOCALITY: Irving
STATE: Texas
COUNTRY: US
EMAIL ID: noreply@noreply.com
ALGORITHM: SHA256withRSA
FQDN: <hostname>
PRESS <ENTER> TO CONTINUE:
-
A Self-Signed Certificate is generated successfully. Installation is complete. Press
ENTER to exit the installation screen.
Certificate Generated Successfully. Keystore NAME: ssl-server.jks
CERTIFICATE LABEL: connectdirectwebservices
PATH: /$HOME/MFTWebServicesDoc/mftws/BOOT-INF/classes/ssl-server.jks
ALGORITHM: SHA256withRSA
PRESS <ENTER> TO CONTINUE:
=============================================================
Please Wait
-----------------------------------------------------------
...............................................................................
=============================================================
Installation Completed
------------------------------------------------------------
Installation and Certificate generation is complete.
ConnectDirectWebServices-<$VERSION> has been successfully installed to:
/$HOME/MFTWebServices
MFTWebServices User Interface is available at :
https://<hostname:port>/cdws-ui/index.html
MFTWebServices API reference is available at :
https://<hostname:port>/cdws-doc/signOn.html
PRESS <ENTER> TO EXIT THE INSTALLER
- Press ENTER to exit the installation screen. Note: Postgresql is not installed with CDWS on AIX and zLinux Platforms. You must provide credential/port for already installed postgresql.