Connect:Direct Web Services Silent Install and Silent Upgrade Example

Procedure
  1. Download the installation package from Fix Central and navigate to the directory where the installation package is downloaded.

    The following files will be used to perform Silent Installation:

    • silentInstall.properties

    • MFTWebservices.exe

    • MFTWebservicesInstall.bat (for Windows)
    • MFTWebServicesInstall.sh (for UNIX)
  2. Modify the silentInstall.properties file based on your requirements.
Table 1. Common Parameters for Window/Unix-based Silent installation
Parameters Mandatory/Optional Description
Read-Only parameters
INSTALLER_UI Use default value Do not modify this attribute.
CHOSEN_INSTALL_SET Use default value Do not modify this attribute.
Editable Parameters
USER_INSTALL_DIR M The directory where the installer will get installed.

For Unix, example: /root/MFTWebServices

For Windows, directories should be separated with double backslash. (\\)

Example: C:\\Program Files\\MFTWebservices
SSL_PORT M Port number used to communicate with the Jetty server.
POSTGRESQL_PORT
Attention: CDWS 6.2.0.10 onwards parameters related to Postgres are not applicable
 M Port number used to communicate with the PostgreSQL database.
Note: This property is mandatory if you are upgrading from IBM® Connect:Direct® Web Service v6.0.0.4 to a higher version.
POSTGRESQL_PASSWORD
Attention: CDWS 6.2.0.10 onwards parameters related to Postgres are not applicable
 M

A Base64 password used to connect to the PostgreSQL database.

Password considerations:
  • Password value 'postgres' is not allowed
  • Minimum and maximum length should be 8 characters and 80 characters respectively.
  • must contain at least 1 Alphabet and at least 1 non-Alphabet
  • Should not include blank spaces
    Note: This property is mandatory if you are upgrading from IBM Connect:Direct Web Service v6.0.0.4 to a higher version.
KEYSTORE_PASS M This attribute should store a Base64 password to the Keystore where the certificate will be placed.
CONFIRM_PASS M This attribute should store the same value as KEYSTORE_PASS attribute.
Table 2. Parameters for Windows-based Silent installation
Parameters Mandatory/Optional Description
CERTIFICATE_TYPE_NEW M This attribute stores value for certificate type to be used for secured communication.
Possible values:
  • \"Self Signed certificate\",\"\"
  • \"\",\"CA Signed certificate\"
CERTIFICATE_TYPE_NEW_1 M This attribute should store the following values:
  • Self Signed certificate

    If the administrator elects to generate a self signed certificate.

  • No value (blank)

    If the administrator elects to configure a CA signed certificate.
CERTIFICATE_TYPE_NEW_2 M This attribute should store the following values:
  • No value (blank)

    If the administrator elects to generate a self signed certificate.

  • CA Signed certificate

    If the administrator elects to configure a CA signed certificate.
CERTIFICATE_TYPE_NEW_BOOLEAN_1 M
This attribute should store the following values:
  • 0 for a CA Signed certificate
  • 1 for a Self Signed certificate
CERTIFICATE_TYPE_NEW_BOOLEAN_2 M This attribute should store the following values:
  • 0 for a Self Signed certificate
  • 1 for a CA Signed certificate
Table 3. Attributes for UNIX-based Silent installation
Parameters Mandatory/Optional Description
POSTGRESQL_HOSTNAME
Attention: CDWS 6.2.0.10 onwards parameters related to Postgres are not applicable
 O

Identify the Hostname

Note: Mandatory for platform zlinux or aix.
CERTIFICATE_TYPE M This attribute should store the following values:
  • 1 for Generate Self Signed certificate
  • 2 for Import CA Signed certificate
BACKUP_CONFIG_DATA O

This attribute decides whether to backup the data during uninstallation of the product.

Valid Values are:
  • yes to save the data after uninstallation (Default Value)
  • no to not save the data after uninstallation
Note: If yes is mentioned it will backup configuration data at $INSTALLATION_DIRECTORY/backup Files location.
Table 4. Common parameters based on certificate type
Parameters Mandatory/Optional Description
If certificate type is Self Signed certificate
CERTIFICATE_LABEL M This attribute should store the certificate label or alias of the certificate entered in lower case.
CERTIFICATE_EXPIRY_TIME M This attribute should store the expiry time in days.

Value entered should be greater than 0.
COMMON_NAME M

This attribute should store the Common Name of the certificate.

Values not allowed:
  • Special characters
  • IP addresses, Port numbers
  • "http:// or https://"
ORGANISATION M This attribute should store an Organization Name that must be registered with some authority at the national, state, or city level.

Use the legal name under which your organization is registered. Do not use an abbreviated form or use any of these symbols: ! @ # $ % ^ * ( ) ~ ? > < / \.
LOCALITY M This attribute should store the name of locality/city where the organization is located.
STATE M This attribute should store the name of state where the organization is located.
COUNTRY M This attribute should store country code in the standard format where the organization is located.
EMAIL_ID M This attribute should store e-mail ID for the support group.
DNS_NAME M This attribute should store the domain name secured by the certificate.
IP_ADDR M This attribute should store the IP address secured by the certificate.
If certificate type is CA Signed certificate
CA_CERTIFICATE_FILE M This attribute should contain the full path of the file with the file name. It only considers PEM or PKCS12 format extension certificate. The file must contain the private key, the CA-signed certificate, the CA certificate and all intermediate certificates.

For Unix, example: /root/Certificates/certFile.pem

For Windows, directories should be separated with double backslash. (\\)

Example: C:\\Certificates\\certFile.pem
CA_CERTIFICATE_PASSWORD M This attribute should contain the private key password of the CA Signed certificate. The password would be the Base64 password.
CERTIFICATE_LABEL M This attribute should store the certificate label or alias of the certificate entered in lower case.