Manually installing IBM Endpoint Manager clients

You can manually install the Endpoint Manager client.

About this task

In most cases, the IBMEndpointManagerClient system plug-in installs the Endpoint Manager client on virtual machines in your virtual application instances and classic virtual system instances automatically. There are two scenarios in which you must manually install the client:
  • A previous version of Cloud Pak System was upgraded to a version that contains the integrated IBM® Endpoint Manager functions and existing deployments are required to participate as Endpoint Manager clients.
  • The automatic installation of the Endpoint Manager client failed.
The Endpoint Manager client can be manually installed on the virtual machine, except for the following cases:
  • You do not have SSH access to the virtual machine.
  • There is not enough disk space on the virtual machine to install the client, and more disk space cannot be added.
  • The operating system is not compatible with the client.
  • For security reasons, the virtual machine cannot use ICMP or UDP, or Port 52311 is not open.

Procedure

  1. Access the virtual machine by using SSH.
  2. Locate the IBM Endpoint Manager Client installation binary file. This file is placed in the /tmp directory. The file name is as follows:
    • Red Hat Linux®: BESAgent-9.0.586.0-rhe5.x86_64.rpm
    • Windows: BigFix-BES-Client-9.0.586.0.exe

    If you cannot locate the installation file, you can download it from BigFix® website: http://support.bigfix.com/bes/install/downloadbes.html and transfer it to the virtual machine.

  3. Locate the IBM Endpoint Manager masthead file.
    • The IBM Endpoint Manager Shared Service deployment contains the masthead file. You can retrieve the contents of this file by using a REST API, as follows:
      https://<IP address for the deployed Shared Service:9999/sharedservice/IBMEndpointManager/getMasthead
      This API returns a string that contains the masthead content.
    • Pull the masthead file from the IBM Endpoint Manager server, as follows:
      http://<IP address for the IBM Endpoint Manager server:52311/masthead/masthead.afxm
    Important: Depending on the method that you used to locate the masthead file, either save the contents of the masthead or rename the masthead file to actionsite.afxm. Place the masthead file in /etc/opt/BESClient. Create this directory if it does not exist.
  4. Run the IBM Endpoint Manager Client installation command. See the IBM Endpoint Manager documentation for manual client installation commands.
    For example, the Red Hat Linux installation command is rpm -ivh <client_binary>.rpm.
  5. Open the necessary protocols and ports on the firewall. See the operating system documentation for firewall-specific commands. For IBM Endpoint Manager Client to communicate with the relay, the following protocols and ports must be open and available:
    • Port 52311
    • Protocol ICMP
    • Protocol UDP
  6. Start the IBM Endpoint Manager Client. See the IBM Endpoint Manager documentation for start commands.
    For example, the Red Hat Linux start command is /etc/init.d/besclient start.
  7. Verify registration on the IBM Endpoint Manager console. If the IBM Endpoint Manager Client is properly configured, started, and registered, it displays in the list of computers on the IBM Endpoint Manager console.