Articles in this section

Alternative Methods of Connecting to Non-Discoverable Endpoints

Todd Kirkland
  • Updated
Follow

In addition to connecting non-discoverable endpoints to Intigua 3.7 in the Intigua Console, the following alternative methods are available.

---------

Connecting Non-Discoverable Endpoints with the API Client

You can add non-discoverable endpoints to Intigua 3.7 with a supplied API client to the Intigua server, as follows:

  1. Grant API permission to an Intigua user.
  2. Open a CLI interface to the Intigua server (a vSphere console, or via SSH), and run:

    /root/intigua_client.py --user <username> --apikey <API_key> server-add --ip <target_IP> --name <name> --dnsname <hostname> --osname <OS>

    where the above parameters are as in the table below.

    Alternatively, if you have a copy of the client (intigua_rest_cmd_client.py) on another machine, you can run it remotely from there, in which case you need to adjust the path to the client accordingly, and the command needs to include: --url https://<server>/vmanage-server/rest/rest-api/ , where <server> is the IP address or resolvable hostname of the Intigua server.

    Optionally, you could incorporate the command in a script, such as for adding multiple machines.

    The command parameters are:

    Parameter

    Description

    <username>, <API_key>

    Username and API key of an Intigua user with API permissions (from previous step)

    <target_IP>

    Endpoint's IP address

    <name>

    A descriptive name for the endpoint, which will appear in the endpoint list, in the Name column

    <hostname>

    Endpoint's DNS hostname

    <OS>

    Endpoint's operating system. Use either a guest OS identifier as defined in the VMware vSphere SDK, or any string containing the OS' commercial name and the phrase 64-bit or 32-bit
  3. Configure endpoint user accounts.

Newly-added endpoints appear in the endpoint list with the initial status of Untested. Upon first vAgent deployment or upon a manual Refresh status from the Servers tab, the connection status will be updated and Intigua 3.7 will attempt to install the Intigua connector on the machine.
Manually Connecting Non-Discoverable Endpoints

You can locally install the Intigua connector on any endpoint server. This is useful for connecting servers which are not otherwise accessible to the Intigua management server, and also for adding the Intigua connector to a base image that will be used to spawn multiple servers later.

To install the Intigua connector on a supported endpoint:

  1. Make sure organizational firewalls allow HTTPS (port 443) communication from the endpoint to the Intigua 3.7 server.
  2. Copy the supplied Intigua connector file to the endpoint. Find the connector file on the Intigua Server:
    • For Windows endpoints: /usr/share/intigua/bin/vlink-win-win32_x64-<version>.exe
    • For Linux endpoints: /usr/share/intigua/bin/vlink_installer_linux_x64_<version>_Release.bsx
  3. On the endpoint, run (make sure to copy all quote signs and slashes correctly):

    <connector> -coreserverurl="https://<hostIP>/vmanage-server/"

    where

    <connector> is the path and filename of the connector file executable, and

    <hostIP> is the IP address (not name) of the Intigua 3.7 server host.

    For example:

    C:\vlink-win-win32_x64-Release-3.2.exe -coreserverurl="https://10.10.1.1/vmanage-server/"

    If the endpoint is already listed in the Intigua Console endpoint list, and you still need to locally install the connector (for example, there is a temporary access problem), you must add to the above command: -coreid "<ID>" , replacing <ID> with the ID displayed in the endpoint's Server core ID column in the endpoint list (some of the ID may be hidden; to get the whole string, triple-click it and copy).

    The connector is installed, and initiates communication with Intigua 3.7.

  4. To test that the connector has been properly installed, check that the Intigua service is running:
    • In Windows:
      • Service name: vAgentManager
      • Display Name: Intigua vAgentManager Service
      • Process name: vlinkservice64.exe
    • In Linux, run:
      • /etc/init.d/intigua status

When installing the Intigua connector as part of creating a base image, some cleanups should be made before snapshotting the base image. Stop the Intigua service, and delete the following files:

  • Files in the directory where connector installation was initiated
    • post_install_log.txt
    • status.bin
    • vlink_installer_*.txt
  • In Windows: C:\Program Files\..... (all log files) and in Linux: /usr/loca/intigua/.... (all log files)
    • vAgentManager/channel/status/*.txt
    • vAgentManager/log/*.txt
    • vAgentManager/PackageManager/vlink/log/connector_stdout.txt

 

 

Related articles

Comments

0 comments

Please sign in to leave a comment.