Get Internet Application Status

Article
04/20/2011

Applies To: Opalis 6.3

The Get Internet Application Status object will check the availability of an internet application server. You can check the availability of an FTP, Web, Email (POP or SMTP), DNS, or custom server using the Get Internet Application Status object. Depending on the type of server that you are checking you will need to specify different configuration information. This object uses a satellite license.

The Get Internet Application Status object can be used to make sure that a server is available after a power outage or a restart.

Configuring the Get Internet Application Status Object

When configuring the Get Internet Application Status object you need to choose the type of server you are checking and then configure the Details tab.

To configure the Get Internet Application Status object

From the Objects pane, drag a Get Internet Application Status object to the active Policy.
Double-click the Get Internet Application Status object icon. The Properties dialog opens.
For information about the settings on the Details tab, the Advanced tab, and General tab, see the following tables. The settings on the Details tab are specific to the type of server that you select.
For information about the settings on the Run Behavior tab, and other tabs if applicable, see Common Tabs.

General Tab

Element	Configuration Instructions
Name	Type a descriptive name for the object.
Description	Type a detailed description of the actions of the object.
Type	Select the Type that matches the server that you want to monitor

Web (HTTP) Details Tab

Element	Configuration Instructions
URL	Type the URL that will be used to contact the web server.
Port	Select to specify a port to use to connect to the web server. The default port is 80.
Timeout	Type the number of seconds to wait for a response from the web server. If the timeout expires without a response, the server will be considered unavailable.
Check that the page contains this string	Select and type a string to search for when the page is retrieved from the web server. When this option is selected, the server is only considered available if the string can be found on the page that is specified by the URL.
Search is case sensitive	Select to make the string search case sensitive.

Email (SMTP) Details Tab

Element	Configuration Instructions
Computer	Type the name of the computer where the SMTP server is located. Type localhost to specify the Action Server where the object is running. You can also browse for the computer using the ellipsis ( ... ) button.
Port	Select to specify a port to use to connect to the SMTP server. The default port is 25.
Timeout	Type the number of seconds to wait for a response from the server. If the timeout expires without a response, the server will be considered unavailable.
Send test email	Select to send a test email using the SMTP server. When this option is selected, the server is only considered available if the email can be sent to the server.
To	Type the address to send the email to.
From	Type the address that the email is being sent from.

Email (POP3) Details Tab

Element	Configuration Instructions
Computer	Type the name of the computer where the POP3 server is located. Type localhost to specify the Action Server where the object is running. You can also browse for the computer using the ellipsis ( ... ) button.
Port	Select to specify a port to use to connect to the POP3 server. The default port is 110.
Timeout	Type the number of seconds to wait for a response from the server. If the timeout expires without a response, the server will be considered unavailable.
Test connection	Select to use a username and password to test the connection to the POP3 server. When this option is selected, the server is only considered available if the credentials are successfully used to log into the server.
Username	Type the username to use to log into the POP3 server.
Password	Type the password that is associated with the Username that you have specified.

FTP Details Tab

Element	Configuration Instructions
Computer	Type the name of the computer where the FTP server is located. Type localhost to specify the Action Server where the object is running. You can also browse for the computer using the ellipsis ( ... ) button.
Port	Select to specify a port to use to connect to the FTP server. The default port is 21.
Timeout	Type the number of seconds to wait for a response from the server. If the timeout expires without a response, the server will be considered unavailable.
Test connection	Select to use a username and password to test the connection to the FTP server. When this option is selected, the server is only considered available if the credentials are successfully used to log into the server.
Username	Type the username to use to log into the FTP server.
Password	Type the password that is associated with the Username that you have specified.

DNS Details Tab

Element	Configuration Instructions
Computer	Type the name of the computer where the DNS server is located. Type localhost to specify the Action server where the Policy is being processed. You can also browse for the computer using the ellipsis ( ... ) button. This field is not required to test the availability of a DNS server.
Use default port (53)	Select to use the default port of 53 to connect to the DNS server.
Port	Select to specify the port to use to connect to the DNS server.
Test DNS table IP Address	Select to specify a computer name and the IP address that should be associated with that IP address. When this option is selected, the server is only considered available if the IP address is assigned to the computer that you specify.

You can use a sequence of actions to test a custom Internet application that is not part of the predefined list. You can perform actions such as opening and closing a port as well as communicating with the Internet application by sending and receiving information.

To add a Custom action

Click Add or Insert . The Action Properties dialog appears.
Select the action that you want to perform and configure its properties.

For information about the settings on the Custom Details tab see the following table.
Click the Up or Down buttons to change the order of the actions.

To remove an action, select it and click Remove.

To edit an action, select it and click Edit.

Custom Details Tab

Element	Configuration Instructions
Open port	Type the port number and the computer where the Internet application resides.
Send data	Type the data that you will send to the Internet application. To specify a file that contains the data you want to send, click Send data from file.
Receive data	Click Publish as Published Data and click the name of the variable where the received data will be saved. Click Save data , specify the File where you want to save the data received from the Internet application. Click the action you want to take If the Destination File Exists.
Close port	The Open port action is required before this action.

Get Internet Application Status Published Data

The following table lists the element names and descriptions of the data published by this object. For information about the published data elements that are common to all objects, see Policy Workflow Rules.

Element Name	Description
Computer	The name of the computer where the Internet application resides.
Port	The port used to communicate with the Internet application.
Protocol	The protocol of the Internet application. For example, HTTP or FTP.
Server Greeting	The greeting message received from the Internet application. This Published Data is only available in FTP, POP3, and SMTP.
Web page	The HTML of the web page that was retrieved when in Web (HTTP) mode.
Receive variable 1	The first variable retrieved when in Custom mode.
Receive variable 2	The second variable retrieved when in Custom mode.
Receive variable 3	The third variable retrieved when in Custom mode.
Receive variable 4	The fourth variable retrieved when in Custom mode.
Receive variable 5	The fifth variable retrieved when in Custom mode.
Receive variable 6	The sixth variable retrieved when in Custom mode.
Receive variable 7	The seventh variable retrieved when in Custom mode.
Receive variable 8	The eighth variable retrieved when in Custom mode.
Receive variable 9	The ninth variable retrieved when in Custom mode.
Receive variable 10	The tenth variable retrieved when in Custom mode.