Getting started with agent rollout


The following sections guide you through the startup of all parts of the software and through your first login to the BMC Client Management console.

The following information is provided:

The BMC Client Management agent installed on the master should start up automatically. To verify this, you must proceed as follows, depending on your operating system. If your agent should not be running for any reason you can also find out how to start it. This process is also valid for the startup of the client agents, therefore you can also find a paragraph for MAC, which is not available as a master agent.

After these agents are running they are filling in their data into the Client Management database on the master.

Depending on the operating system, there are different ways to start the client agent as mentioned below.

To start the client agent on Windows

The CM agent icon should be displayed in the systray of your master server or client when the agent is running. It can be one of the following colors indicating a specific status:

  • The icon is gray gray_shield.PNG during the agent’s initialization.
  • The icon is blue blue_shield.PNG when the agent is running.
  • The icon is green green_shield.PNG or flashing green when an operation is in progress.
  • The icon is red red_shield.PNG when the agent tries to carry out an unauthorized action or access.
  • The icon turns orange orange_shield.PNG when the local device is taken over through remote control.
  • The blue icon new_resource.PNG shows a package when packages and operational rules are advertised to the client and are available for download and installation.

If you want to start a stopped agent, you need to do so via the Services window of the Control Panel. If you double-click it, a graphic agent interface opens giving the administrator(s) access to various modules and settings related to this agent. The administrator can modify settings and actions via this interface. For more information about this interface, refer to the Setting-the-Agent-Configuration-parameters topic.

Command line options

The agent can also be launched from the command line with the following options:

cmd

cmd long

Description

-v

--version

Returns the version of the agent.

-i

--install

Installs the service. This option must be used in connection with the -sn "Service Name" option.

-r

--remove

Removes the service. This option must be used in connection with the -sn "Service Name" option.

-sa

--standalone

Starts the agent as standalone.

-cw

--consolewindow

Starts with pop-up menu (for output text).

-sn

--servicename

Used to install/remove using non-default service name.

-dn

--displayname

Used to install/remove using non-default service display name.

To start the client agent on Linux

The CM agent installed on the master should start up automatically. This can be checked by typing ps -ax | grep mtxagent and pressing the Enter key. The console or terminal window should return: /usr/local/bmc-software/client-management/master/bin/mtxagent as one of the running processes in the process list that is now displayed.

To start or stop the agent type the following command into a terminal window:

service BMCClientManagementAgent start
service BMCClientManagementAgent stop

 

Command line options

The agent can also be launched from the command line with the following options:

cmd

cmd long

Description

-v

--version

Returns the version of the agent.

-sa

--standalone

Starts the agent as standalone.

To start the client agent on Mac

The CM agent installed on a Mac device should start automatically after a device reboot. This can be checked by typing ps -eaf |grep mtxagent and pressing the Enter key. The console or terminal window should return: /usr/local/bmc-software/client-management/client /bin/ as one of the running processes in the process list that is now be displayed.

If the agent does not start, type the following into a terminal window:

SystemStarter start BMCClientManagementClient

then press your Enter key. The agent starts now.

The agent can also be launched from the command line with the following options:

cmd

cmd long

Description

-v

--version

Returns the version of the agent.

-sa

--standalone

Starts the agent as standalone.