Remote Agent Properties
The Remote Agent Properties defines the settings for a Remote Agent.
Property Pages
Agent
Agent Address
Specify the network name or IP address of the remote computer. The adTempus service must be installed on this computer, and adTempus must be configured to run as an Agent.
Instance
If the Agent is configured to use a named instance of adTempus, specify the instance name.
Port
If the Agent is configured to use a nonstandard port, specify the port.
Optional Name
Optionally, provide a descriptive name for the Agent to be used instead of the address in the user interface.
Enable this agent
Check this box to enable the Agent.
If the Agent is not enabled, no jobs will be run on the agent.
This computer is not in the same domain as the Controller
Check this option if the Agent is not in the same domain as the Controller (or a domain with a trust relationship with the domain of the Controller). In this case you must install a server certificate for on the Agent.
Certificate Thumbprint
If the server certificate used by the Agent is not trusted by the Controller computer (e.g., it is a self-signed certificate), enter the certificate thumbprint (available from the Endpoint Configuration Tool) of the Agent's certificate to force the Controller to trust the certificate and allow the connection.
Advanced connection settings
Advanced options can be entered to accommodate special connection scenarios. No advanced options are currently defined.
Variables
The Variables page allows you to define Job Variables for this Agent. You can add new Variables, or override the values of Variables inherited from the server level.
Variables you define here will be available to all jobs assigned to this Agent. When a job runs on more than one Agent, it receives the appropriate variables on each Agent.
Job Variables can be used to accommodate differences in the file structure or environment between different Agent computers. For example, suppose you have a job that is being mirrored to three different Remote Agents. This job runs program myprogram.exe. On two of the Agents, this program is installed in folder c:\myprogram, but on the third it is installed in folder c:\program files\myprogram. Your job needs to be able to find the program in the correct folder on each of the three computers.
To accomplish this, you would create a Job Variable named "MyProgramPath" for each of the three Remote Agents, and set this variable to the correct path for that Agent. In your job, you would set the target of your Program Execution step to %MyProgramPath%\myprogram.exe. When the job is executed, adTempus will replace %MyProgramPath% with the correct path on each Agent.
Job Variable list features and tools
The Job Variable list shows variables defined for the current object as well as variables inherited from a higher level. Icons next to each variable in the list convey information about their inheritance:
|
The variable is inherited from a higher level |
|
The variable is inherited from a higher level and is locked (cannot be overridden) |
|
The variable is inherited from a higher level and has been modified at this level |
|
The variable is new at this level |
|
The variable is inherited from a higher level and must be overridden (a value provided) at this level |
|
The variable has been overridden (redefined) at a lower level. This icon only appears if you have analyzed variable usage (see below). |
When you hove the mouse pointer over the icon for an inherited variable, adTempus will show where the variable was inherited from.
Filtering the variable list
The variable list can be filtered to:
- Hide inherited variables (so you only see variables defined at this level)
- Hide variables that cannot be modified (inherited variables that are locked to prevent modification)
- Show only variables that must be overridden
Analyzing and viewing variable usage
5.0
When you click Analyze variable usage, adTempus searches for all the places where the variables are used or overridden. After this analysis is complete, new columns are added to the list to show, for each variable:
- Whether it has been overridden (redefined) at a lower level
- A count of how many times it is referenced (used)
Clicking Show variable usage opens a new window showing all the references and overrides for the variables. This is the same window shown by the Find Variable and Function References tool.
Analyze variable usage only finds references and overrides that are "below" the current level. For example, if you are viewing the variables for a job, this will find all references and overrides within the job, or within jobs that may receive variables from this jobs (jobs run by Responses or Job Triggers). If you are viewing a group, this will find all references and overrides within groups and jobs below the selected group. That is, the tool only lists places that might be affected by changes to the variables in the list.
This tool does not show other places where the variables might be used. For example if you are viewing job A and some of the variables are also used in job B, those uses will not be listed unless there is a link between job A and job B.
To find all references to a variable:
- If the variable is defined at the server level, use the Analyze variable usage tool from the variables list at the server level. This will show all uses everywhere in adTempus.
- Use the Find Variable and Function References tool to find a specific variable or all variables.
Security
The Security page is used to view or modify the security settings for this object. See the Security Editor topic for more information on editing security settings.
The following permissions apply to Remote Agents:
| Permission | Description |
| Full Control | Permission to perform all actions on the agent. |
| List/Use | Permission to schedule jobs to run on this agent. |
| View | Permission to view the properties of the agent. |
| Modify | Permission to modify the properties of the agent. |
| Delete | Permission to delete the agent. |
| Administer security | Permission to change the security settings for the agent. |
| Change owner | Permission to take ownership of the agent. |
Permission to create new agents is controlled through the Default Remote Agent Security options.
Related Concepts