Manage an on-premises Agent

Edit online

Datalink (Classic) Agents are used to access data sources in the cloud or behind your company firewall, for example, IT resource utilization, customer resource management, and human resources systems. By default, an Apptio -hosted Datalink (Classic) Agent is preinstalled and can be used to configure connectors for cloud-based data. Install an additional Agent on-premises if you need to configure connectors for data sources behind your firewall. All Datalink (Classic) Agents are managed by a single Datalink (Classic) Manager.

Supported environments

An Apptio Datalink (Classic) Agent can be installed in any of the following Windows, UNIX, or Linux environments:

  • Windows Server 2008 R2 and later (32 and 64 bit)
  • RHEL 5.9 and later (64 bit)
  • Oracle Linux 5.9 and later (64 bit)
  • Ubuntu 12.04 and later (64 bit)
  • Centos 5.9 and later (64 bit)
  • Centos 7 (32 bit and 64 bit)

Server requirements

An Apptio Datalink (Classic) Agent must be installed on a server that meets the following requirements:

  • Dual Core or better modern CPU 2 GHz or equivalent
  • 8 GB of RAM
  • 10 GB of disk space

Java requirements

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. For more information, see Install Java .

Network requirements

The network supporting the Datalink (Classic) Agent must meet the following requirements:

  1. DNS configured to resolve apptio.com and all sub domains.
  2. The ability to make outgoing TCP connections to all apptio.com domains.
  3. Destinations ports 443.
  4. The following firewall configuration
    • Access to *.apptio.com using port 443.
    • A rule set not to replace the *.apptio.com security certificate for cases when some networks replace apptio .
    • IP ranges to Apptio datacenters hosting the Datalink (Classic) Manager must be allowed.
      This can be provided by support, based on region.
  5. Datalink (Classic) supports a direct connection through HTTP web proxies with basic authentication. You can also use a transparent proxy that allows persistent TCP connections on port 443. Consult your network administrator for help in complying with these requirements. If your organization uses a proxy, provide the following:
    • Server name
    • Port
    • User name and password if used

Required permissions

  • The installer must have admin rights on Agent's computer.
  • (Windows only) If the service is configured to run with integrated security, provide a user name and a password for the service. In this case, review properties of Datalink (Classic) service and obtain log on as to use as the user name and password.

Installation overview

Root access, or Windows administrative access, is required for installation. After installation, a named user account can run the Agent without requiring root access.

Key steps for installing a Datalink (Classic) Agent:

  1. Install Java
  2. Run the Datalink (Classic) Agent setup wizard
  3. Configure the agent-manager connection