Space banner

   

This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

Getting started with agent rollout

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  during the agent’s initialization.
  • The icon is blue  when the agent is running.
  • The icon is green  or flashing green when an operation is in progress.
  • The icon is red  when the agent tries to carry out an unauthorized action or access.
  • The icon turns orange  when the local device is taken over through remote control.
  • The blue icon  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:

cmdcmd longDescription
-v--versionReturns the version of the agent.
-i--installInstalls the service. This option must be used in connection with the -sn "Service Name" option.
-r--removeRemoves the service. This option must be used in connection with the -sn "Service Name" option.
-sa--standaloneStarts the agent as standalone.
-cw--consolewindowStarts with pop-up menu (for output text).
-sn--servicenameUsed to install/remove using non-default service name.
-dn--displaynameUsed 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:

cmdcmd longDescription
-v--versionReturns the version of the agent.
-sa--standaloneStarts 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:

cmdcmd longDescription
-v--versionReturns the version of the agent.
-sa--standaloneStarts the agent as standalone.
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Jan Sierens

    SystemStarter is deprecated since Mac OS X v10.4 and has been removed since OS X 10.10

    See launchd and launchctl.

    Example: sudo launchctl load /Library/LaunchDaemons/BMCClientManagementAgent.plist

    Mar 14, 2019 09:03
  2. Darshana Bhangare

    Thanks for the feedback. I have updated the page.

    Sep 02, 2020 05:28