Manually installing relays (clients) on Windows

The agent is installed on each client and operates completely independently from the master server (the master has its own agent), sending information either at regularly defined intervals or when polled by the master or any other module. As we are going to roll out the agents to some clients later on, we use this installation to install a relay for our clients, because the installation program is the same for a client or relay. A relay agent is the same type of agent as that of the client and is treated as such, but it has more functionalities. Similar to the master and console installation, the installation of the BMC Client Management agent is a simple, straightforward process carried out via the Windows Installer Service. The setup program takes you through the steps and installs the agent on your selected device. To install the relay agent, follow these steps:

1. Double-click the setup.exe file.
   The Choose Setup Language pop-up requests you to select your language for the installation procedure.
2. Select your language, in our case most probably English , then click OK .
3. Wait a few moments while InstallShield prepares the Windows Installer and the BMC Client Management configuration.
   The License Agreement dialog box appears.
4. Select the radio button to accept the license and then Next to continue.
   The Select Features dialog box appears.
5. For the agent installation you must first clear all options and then check the Client (Relay) box.
   
6. Click Next to continue.
7. In the Start Copying Files dialog box that now displays, click Next to prepare for installation.
8. Wait until the InstallShield Wizard is completely initialized, then click Next to continue.
   The Destination Folder dialog box now proposes a default installation directory.
9. You can choose to keep the default or click Browse to change the directory or create a new directory for installation.
   
10. When you are ready to continue, click Next .
    The Agent Configuration dialog box now appears with the communication settings for relays.

11. Define the following parameters for your relay:

    Parameter	Description
    HTTP Port	Define the HTTP port of your local computer. The default value for this port is 1610 for Windows computers. If you left the default settings at the master installation, also leave this value.
    Parent Name	The direct parent of our relay here is the master, therefore you must enter the name of the master server into this text box.
    Parent Port	Enter the port number of the master. If you left the default settings at the master installation also leave this value.
    Relay Enabled	Check this box to make the particular client you are about to install a relay.
    Access Control	Define whether agent communication is secured via access control. Leave the preselected option.
    Use SSL	Define whether agent communication is secured via SSL. Leave the preselected option and click Next.

    At this point in the procedure you have different options for agent communication that are explained outside this main procedure:

    • For more information about the access control options for all agent communication, see option Using Access Control for interagent communication now.
    • For more information about the SSL options for agent communication, see option Using SSL for interagent communication now.

    The Service Name dialog box appears. It allows you to define the name for the BMC Client Management agent service, the default value for the service. BMC Client Management agent is prepopulated.

12. Leave the preselected option and click Next .
13. Verify your settings in the Ready to Install window and then select Install to launch the actual installation process.
14. When installation is complete the InstallShield Wizard Completed dialog box appears to inform you if the client/relay installation was successful. Click Finish .
15. A second InstallShield Wizard Completed dialog box appears to terminate the overall BMC Client Management installation process. Click Finish to exit the wizard.You should now see the gray agent icon in your systray, indicating that the relay agent is initializing. When it is running the icon turns blue and the relay is ready for operation.