Run 3rd Party Application Template
The "Run 3rd Party Application" APM application monitor template demonstrates how to use a Windows script to run an executable program. The return value of the executable program is returned to Orion APM as a statistic. The Windows Script component monitor in this template is pre-configured to run the Windows notepad.exe executable program on the Orion APM server. To run a different program, you must specify a different value in the Script Arguments field.
To run an executable program locally on the Orion APM server:
Type the program name in the Script Arguments field.
To run an executable program on a remote server:
Specify all of the following arguments in the Script Arguments field:
hostname workingdirectory executablefile username password
hostname
The hostname or IP address of the remote server where the program resides.
workingdirectory
The local path or Universal Naming Convention path to a folder on the remote server that the program can use as its working directory.
executablefile
The local path or UNC path to the executable program.
username
The user name of a Windows administrator account on the remote server.
password
The password of the Windows administrator account.
Example of Running a Program Locally on the Orion APM Server
This argument runs the executable program notepad.exe on the Orion APM Server.
notepad.exe
Example of Running a Program on a Remote Server
These arguments run the executable program C:\temp\testantivirus.exe on the remotehost, and use the C:\temp folder as the working directory. The paths are in UNC syntax.
remotehost \\remotehost\c$\temp\testantivirus.exe \\remotehost\c$\temp\ Administrator Password
Example of Using Credentials Variables to Run a Program on a Remote Server
These arguments run the same executable program as the previous example, but hide the Windows administrator credentials from plain sight by substituting ${USER} and ${PASSWORD} variables. You must set the Credential field of this component to a credential with administrator rights to the remote server.
remotehost \\remotehost\c$\temp\testantivirus.exe \\remotehost\c$\temp\ ${USER} ${PASSWORD}