New Install

You can use this section to understand the procedure of installing new Connect:Direct UNIX/Windows severs from IBM® Connect:Direct®.

Note: Only the Connect:Direct installer packages/files downloaded from Fix Central will be recognized by Control Center Director. Installer files downloaded from Passport Advantage will not be recognized by Control Center Director.
Important: You must have the following to support installation of a new IBM Connect:Direct server:
  • IBM Connect:Direct UNIX and Windows package version 6.1.0.1 or later
  • You must have External CA/Key certificates created in control center (If user want to Create Connect:Direct server with external certificate ).
  • Due to certain security limitations on Windows Server 2016 and earlier operating systems, the new installation feature will only function on Windows Server 2019 and later versions.
  • Curl for UNIX Operating system
  • PowerShell version 4.0 and above for Windows Operating system
  • External CA Certificate have to add in Control Center truststore (Before installation of Connect:Direct UNIX and Windows server.
Following steps show the initial workflow for a New Install task:
  1. Create New Install Task
    1. Click New Install > Create New to install a new Connect:Direct server.
    2. Enter a name for the new installer. The Installer Name cannot be changed later.
    3. Select the Operating System from the drop down, which auto populates other dependent fields.
    4. Enter the port details.
    5. Select the Certificate Type
      1. Bootstrap Certificate: Default option. Select this option to configure Connect:Direct server with Control Center Director’s CA signed certificate
      2. External Certificate: Select this option to configure Connect:Direct Server with external Key Certificate and CA Certificate.
    6. In the Overrides for individual servers section, enter the Host Address and Node Name of the machines to install the server. You can add multiple machine host addresses at once.
    7. Enter email IDs you want to send the installation link to in Email Link To field.
    8. Click Save Draft to add the installer in the list of Draft installers. Else, click Proceed, review the entered details and click Confirm. The new installer is visible in All Installers and Active installer list.
    9. Copy the link received on the e-mail ID mentioned while creating the New Install Task. You can also copy/share the link from All Installers/ Active Installer list, as follows:
      1. Find the new installer, and click Share Link from Overflow menu.
      2. On the Share Installer Link window, enter the e-mail ID and click Share Link to send an e-mail with the installation link or click Copy Link to copy it to clipboard.
  2. Manage Installers
    • View Active, Draft and Archived installers.
    • You can make an installer active from Draft installer list.
    • Only an Active Installer can be Archived.
    • An Archived Installer can never be activated again.

Initial Administrator Workflow : Installing Connect:Direct Server

Following steps show the procedure for installing the Connect:Direct Server after successfully creating a New Install Task:

Procedure for Windows
  1. Paste the link received after successfully creating a New Install task in the browser and press Enter. A zipped folder is downloaded.
  2. Unzip the folder and extract all 4 files in the zipped folder.
    Note: By default, a bootstrap certificate is created and installed, which helps in deploying the new Connect:Direct sever.
    Note: Before proceeding to step 3, ensure you have the recorded the values for cdai_keystorePassword and cdai_localCertPassphrase from the options file that was unzipped.
  3. Run installCDWindows.ps1 file with PowerShell version 4.0 or above. After the installation is complete, a success message appears. The installed server is added to CD Configuration Needed Server Group and listed in Server > All C:D Servers list.
  4. Navigate to Server > All C:D Servers. Click the overflow menu icon (Overflow menu icon displays a list of actions) of the newly added server and click Mark Configured to configure the server.
Procedure for UNIX
  1. Execute the following script to download a tar file.
    curl -o <bundlename.tar> --insecure <link you copied from Control Center Director Web Console/e-mail ID>
  2. Untar the downloaded file to extract a bundle of four files.
    tar -xvf <tarfile >
    Note: By default, a bootstrap certificate is created and installed, which helps in deploying the new Connect:Direct sever.
    Note: Before proceeding to step 3, ensure you have the recorded the values for cdai_keystorePassword and cdai_localCertPassphrase from the options file that was unzipped.
  3. Execute ./installCD.sh to install the required file. After the installation is complete, a success message appears. The installed server is added to CD Configuration Needed Server Group and listed in Server > All C:D Servers list.
  4. Navigate to Server > All C:D Servers. Click the overflow menu icon (Overflow menu icon displays a list of actions) of the newly added server and click Mark Configured to configure the server.