Configure a Robot for Marketplace Probes

It is recommended that marketplace probes:
uimpga-ga
It is recommended that marketplace probes:
  •  
    Run on a passive robot
     (for security reasons). Passive robots do not send messages to the hub; messages are sent only at the hub’s request. Robots can be configured as passive during installation, or converted from active mode to passive mode.
  •  
    Be run by a non-superuser.
     The marketplace user should be an OS account user. 
Marketplace probes run with the same OS permissions as the marketplace user. If a marketplace user is created with missing or invalid information then the marketplace probes will not run. If the marketplace user is changed then the marketplace probes will restart and the new marketplace user permissions will be used. 
The sections in this article explain how to configure a robot to create this restricted environment.
When robot configuration is complete, you can deploy marketplace probes to the robot.
Install a Passive Robot and Connect it to a Hub
This section contains robot installation instructions and explains how to connect the new robot to a parent hub.
Optionally, you may want to adjust robot-to-hub communication. By default, the parent hub requests messages from a passive robot every 15 seconds and allows up to 1000 messages per interval.
 
Follow these steps:
 
  1. Install a passive robot. For instructions, go to Deploy Robots and refer to the appropriate section.
    • To install a single Windows passive robot, run the installer as instructed in "Installing a Robot on Windows." The robot installer's 
      Options
       dialog allows you to select 
      Passive mode
      .
    • To install a single Unix passive robot, run the 
      nmldr 
      utility as instructed in "Installing Robots and Secondary Hubs on Linux or Solaris." When the installer asks 
      Should this robot run in passive mode?,
       reply 
      yes
      .
    • To install one or more passive robots as part of an XML bulk deployment, see "Deploying Robots in Bulk." In the XML file, add the following line for each system that will host a passive robot:
         <robot_mode>passive</robot_mode>
       
  2. Add the robot to the hub's registered robots list:
    1. In Infrastructure Manager, navigate to the hub that will manage the passive robot.
    2. Display the hub's probes, then right-click the hub probe and select 
      Configure
      .
    3. Select the 
      Robots
       tab.
    4. Right-click in the Registered Robots pane and select 
      Add Passive Robot
      .
    5. Enter the robot’s IP address and first probe port (default is 48000).
    6. Click 
      Verify
      , then click 
      OK
       to exit the dialogs.
The passive robot is installed, and its parent hub is configured to request messages from the robot. Before you deploy marketplace packages to the robot, make sure you specify the marketplace user.
Change an Active Robot to Passive Mode
This section explains how to change the mode of an existing robot, disconnect it from its hub, and reconnect it as a passive robot.
 
Follow these steps:
 
 
Note:
 You need the passive robot's IP address in this procedure.
  1. Log on to Infrastructure Manager.
  2. Change the robot from active to passive mode:
    1. In the navigation tree, locate the active robot and display its probes.
    2. Right-click the controller probe and select 
      Configure
      .
    3. In 
      Controller Configuration
      , navigate to 
      Setup
       > 
      Misc
      .
    4. Set the 
      Robot mode
       to 
      Passive - must be contacted by hub
      , then click 
      OK
      .
  3. Remove the robot from hub registered robots list:
    1. Navigate to the hub that manages the robot, then navigate to the 
      hub
       probe.
    2. Right-click the hub probe and select 
      Configure
      .
    3. Select the 
      Robots
       tab.
    4. In the 
      Registered Robots
       pane:
      • Make a note of the robot’s IP address.
      • Right-click on the robot and select 
        Remove
        .
  4. Add the passive robot to hub registered robots list:
    1. In the 
      Robots
       tab, right-click in the 
      Registered Robots
       pane and select
       Add Passive Robot
      .
    2. Enter the robot’s IP address and first probe port (default is 48000).
    3. Click 
      Verify
      , then click 
      OK
       to exit the dialogs.
The robot is now in passive mode, and its parent hub is configured to request messages from it. Before you deploy marketplace packages, you must specify the marketplace user.
Specify the Marketplace User
This section provides instructions to create a marketplace user (non-root user) that will run marketplace probes.
 
Tip:
 To simplify administration, CA recommends you create a user account specifically for this purpose, and create the same account on all systems that will run marketplace probes.
Ensure that the OS user that you use as the marketplace user has file access permissions to the marketplace probe directory. You want to verify that the marketplace user does NOT have file access to other non-marketplace probe directories, for security reasons. The marketplace probe is designed to operate as a sandbox with access permissions only to its own files.
 
 
Follow these steps:
 
  1. Log in to Admin Console.
  2. Navigate to the robot that will manage a marketplace probe and display its probes.
  3. Open the controller configuration UI.
  4. Select 
    Setup
     in the left navigation and scroll to the marketplace settings.
  5. Enter the 
    Marketplace Username
     and 
    Password
    .
     
    :
     
    The password is only required on a Windows robot. The password is visible when you enter it. The username and password are encrypted in the configuration file.
    The Windows user must have "log on as batch job" permissions.
  6. Click 
    Save
    .
The robot configuration for marketplace probe deployment is complete. If you want to adjust the hub-to-robot communication (optional), you can modify communication settings for passive robots.