Configuring and starting the Satellite Connector service

Configure and start your Satellite Connector service to connect your computer to an IBM Satellite server.

Satellite Connector map with the cloud highlighted

Before you begin

Ensure that you have installed Satellite Connector Agent using the IBM installer.

Procedure

  1. On the Satellite Connector host computer, go to the folder you extracted when you installed Satellite Connector Agent.
    For example, go to C:\SatelliteConnector\satellite-agent-windows.
  2. Edit the file config.json.
    1. Open the file config.json in a text editor.
      The content appears as follows:
      {
        "SATELLITE_CONNECTOR_ID":"<connector_id>",
        "SATELLITE_CONNECTOR_IAM_APIKEY":"<api_key>",
        "SATELLITE_CONNECTOR_TAGS":"<tags>",
        "LOG_LEVEL": "info",
        "PRETTY_LOG": true
      }
    2. Replace <connector_id> and <api_key> with the values that you copied when you installed the agent.
    3. Replace <tags> with the name of the Satellite Connector host computer.
      Tip: This value is not required. However, it will help you to troubleshoot issues.
    4. Save and close the file.
  3. Create and start the Satellite Connector service:
    1. Right click the file satellite-agent-windows\install.cmd, and then select Run as administrator.

      The following message appears:

      Will create and start Satellite Connector Service, please make sure config.json is updated. Continue?(y/n)
    2. Type y, and then press Enter.
    3. When prompted again, type y, and then press Enter.

    The folder connector_agent is created and the Satellite Connector service is started.

  4. Confirm that the Satellite Connector service is running.
    1. Go to the Satellite Connectors page.

      The status shows as Not connected iconNot connected.

    2. Click Refresh icon Refresh.

      The status changes to Connected iconConnected. This confirms that your Satellite Connector is connected to the IBM Satellite server on the cloud.

Results

Satellite Connector Agent is configured and the Satellite Connector service is running.

What to do next

You can now add a destination database.