Installing Secure Connectors

Provides procedures to download the Secure Connector installer and install the Secure Connector.

Before you begin

For Windows installations, verify that you do not have an existing version of the Secure Connector installed. If you have a previous version that is installed, uninstall it before you proceed.

For Linux installations, while it is not required, it is good practice to uninstall previous Secure Connector installations.

For Linux machines, install a desktop environment, such as GNOME or KDE, to provide a graphical interface.

About this task

After you create a Secure Connector in the appliance, you must configure a machine behind the firewall to facilitate communication between the Secure Connector and a specific endpoint behind the firewall. Use the Secure Connector installer to configure the machine behind the firewall.

Note: The machine on which you choose to run the installer must have access to the endpoint. You do not have to run the installer on the same machine as the endpoint.
Note: If you are using secure connector on appliance then:
  • Ensure that the appliance IP is reachable (you are able to ping) from the machine where the secure connector is installed.
  • The ports mentioned below are used internally by the appliance for communication with the Secure Connector. It is recommended that you do not use these ports on the appliance in any of your orchestration activities that involves HTTP Receive Request activity and Web Service activities.
    • 9080
    • 9442
    • 9443
    • 9445

Downloading the Secure Connector installer:

You can download the Secure Connector installer from the Cast Iron® installer CD, Fix Central, or IBM® Passport Advantage®. You can download for Windows or Linux, 32-bit or 64-bit, based on your requirement.

To install the Secure Connector:

  1. Start the Secure Connector installer that you downloaded.
    • windows-secure-connector-installer.exe (for Windows)
    • linux-secure-connector-installer.sh (for Linux)

    The Secure Connector Installer wizard is displayed.

  2. Click Next then read and accept the licensing agreement.
  3. Click Next and choose an installation directory.
  4. Click Next. A message window states the location where the target directory is created.
    Note: If an installation directory exists, a warning message is displayed and you must confirm that you want to install and overwrite existing files.
  5. Click OK.
  6. Set up shortcut options to start, stop, and edit a Secure Connector.
    1. Select one or both of the following options:
      • Create shortcuts in the Start menu.
      • Create additional shortcuts on the desktop.
    2. Select a program group from which you access the shortcuts.
    3. Choose to create shortcuts for the current user or all users.
  7. Click Next. The installation progress displays.
  8. Select a Secure Connector configuration file. If you have not already downloaded a Secure Connector configuration file, download one now. For more information about how to download Secure Connector configuration files, see Downloading Secure Connector Configuration Files.
  9. Click Next.
  10. For Windows installation, choose to install and run the Secure Connector as a Windows Service. If you choose install the Secure Connector as a Windows Service, you can control the Secure Connector using the Windows Services control panel (recommended). If you choose not to install and run the Secure Connector as a Windows Service, then the Secure Connector is installed as a Windows application. To run the Secure Connector as a Windows Service, you must specify the following service account information:
    • Service Start Mode
    • Service Account Domain
    • Service Account User
    • Service Account Password
  11. Click Next. The Create Vendor Supplied Libraries screen is displayed.
  12. Click Add and select the library files to upload. In the appliance, the valid files are .jar,.dll, and .so file types. The files that you select are displayed in the Files to Add column.
  13. Click Update.

    The files that display in the Files to Add column are not committed until you click Update.

  14. Click Next. A dialog box is displayed to confirm the changes made, if you have not clicked the Update button. Click Yes to update changes and proceed further. If you click No to go to the next screen without any changes. Click the Cancel button to stay on the same screen.
  15. When you click Yes to proceed further, the Vendor JAR created/updated successfully message is displayed.
  16. Click OK. A message saying that the installation has completed successfully is displayed.
  17. Restart the Secure Connector.
Note: If your endpoint (that is SAP) requires additional libraries, you must install the additional libraries before you start the Secure Connector. For more information about installing additional libraries, see Installing Vendor Supplied Libraries for Secure Connectors.

To run the Secure Connector installer:

  1. Start the Secure Connector installer that you downloaded in the Creating a Secure Connector section.

    • windows-agent-installer.exe (for Windows)

    • linux-agent-installer.sh (for Linux)

  2. Accept the licensing agreement and choose an installation directory.

  3. Log in to the Web Management Console as the administrator.

  4. Select Setup > Support Information. Keep the Support Information page open while configuring the Secure Connector installer parameters. You can cut and paste values from the Support Information page to the appropriate parameter field.

  5. Provide values for the following parameters:

    • Secure Connector Name - Specify the name of the Secure Connector you created.

    • Tenant ID - Use the default value provided in the file. It is used for internal communication.

    • Environment ID - Use the default value provided in the file. It is used for internal communication.

    • Gateway - Use the default value provided in the file. It is the data network IP on which the appliance is running.

    • Listen on Port - Modify this parameter only if another service is using the port that is specified or you want to run multiple Secure Connectors on the box.

    • Transmit on Port - Modify this parameter only if another service is using the port specified or you want to run multiple Secure Connectors on the box.

    • Secure Connector Auth Key - Specify the authentication key from the Secure Connector you created in the cloud.

    • Secure Connector Private Key - Specify the authentication private key, which you downloaded while creating the Secure Connector in the cloud.

  6. Open a command prompt and navigate to the Secure Connector installation directory.

  7. If your endpoint (that is, SAP) requires additional libraries, you must install the additional libraries before you start the Secure Connector. For more information about installing additional libraries, see Installing Vendor Libraries on the Secure Connector.

  8. Start the Secure Connector by running one of the following files at the command prompt:

    • For Windows: runclient_osgi.bat

    • For Linux: runclient_osgi.sh




Feedback | Notices


Timestamp icon Last updated: Friday, February 5, 2016


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.appliance.doc/Secure_Connector/installingSecureConnectors.html