Update an on-premises Datalink (Classic) Agent

Edit online

Apptio releases updates to the Apptio Agent service to enhance features and correct issues. This article describes updating the Agent service. For information on updating the engine for an Agent, see Update the engine for an agent .

Review installation requirements for Agent installation. For information, see Manage an on-premises Datalink (Classic) Agent .

Datalink (Classic) should run on most implementations of Java 11 including those found here for Datalink (Classic) 4.9, and similar versions of JRE 8 for Datalink (Classic) 4.8.

Update the Agent service

Note:

When updating the Agent service, do not unregister the Agent from the Manager (see Register an agent (Datalink (Classic) 4.8 and later) ). Doing so deletes all stored passwords for the Agent and connectors.

  1. Back up important files.
    Note:

    Apptio recommends that you create a backup of the entire Datalink (Classic) installation directory. At a minimum, create a backup of the following Datalink (Classic) Agent files located in the Datalink (Classic) installation directory:

    • The agent.config file

    • The config directory

  2. Open the Datalink (Classic) Manager and do the following:
    1. In the upper right corner, select Install New Datalink (Classic) Agent .
    2. From the drop-down menu, select the appropriate agent installer for the operating system you are installing the agent on.
  3. Stop the agent service by doing the following:
    • In Windows:
      1. Select Start and type services .
      2. Select Services .
        You can also press WIN+R to open the Run dialog, then type services.msc and select Enter .
      3. Right-click the Apptio Datalink (Classic) service and select Properties .
      4. In the Logon tab, if My account is selected and an account is specified, make a note of the account name, as you will need it when restarting the agent.
      5. In the General tab, select Stop .
    • In Linux:
      1. Open a terminal widow.
      2. cd to the directory where Datalink (Classic) Agent is installed.
      3. cd to the bin directory.
      4. Run ./ Apptio DataLink stop
        You may need to run the above command with sudo to stop the Agent service.
  4. Navigate to the Datalink (Classic) directory on the machine where the Agent is installed and run the uninstall file to uninstall the Agent.

    NOTE : For Linux .tgz installations, there is no uninstall script. Instead, remove all contents of the Datalink directory except for the agent.config file and the config folder.

    • The default installation directory for Windows is C:\ApptioDataLink
    • The default installation directory for Linux is /usr/local/datalink
  5. Install the required Java version:
    • If you are upgrading from Datalink (Classic) 4.8.x to 4.9.x (new-master-13921 and later), install Java 11. For more information, see Install Java .
    • If you are upgrading from Datalink (Classic) 4.9.x to above, ignore this step as you already have a compatible version of Java.
  6. Run the Agent installer downloaded in step 2. Follow the prompts, ensuring you install the new Datalink (Classic) Agent in the same directory where it was previously installed. For more information, see Run the Datalink (Classic) Agent setup wizard .
  7. Restart the service.
    • In Windows:
      1. Select Start and type services .
      2. Select Services .
        You can also press WIN+R to open the Run dialog, then type services.msc and select Enter .
      3. Right-click the Apptio Datalink (Classic) service and select Properties .
      4. If you made a note of an account name in step 3 , in the Logon tab, select My account and enter the account name.
      5. In the General tab, select Start .
    • In Linux:
      1. Open a terminal widow.
      2. cd to the directory where Datalink (Classic) Agent is installed.
      3. cd to the bin directory.
      4. Run ./ Apptio DataLink start
        You may need to run the above command with sudo to stop the Agent service.
  8. Open a browser and navigate to the Datalink (Classic) Manager.
  9. Verify the Agent is registered and updated to the new version. For more information, see Update the engine for an agent .

    NOTE : If a message stating that the Datalink (Classic) Agent is not available displays, wait about 60 seconds and refresh the page.

After verifying that the upgrade to Datalink (Classic) 4.9 is successful, you can remove Java 8 if it is no longer required by other software on the system.