Get Internet Application Status

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. See Objects that Require Satellite Licenses for more information.

How it is used

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

Configuration

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 select the type of server:

1.	Open the Monitor Internet Application object for editing.

2.	Click General.

3.	Select the Type that matches the server that you want to monitor:

•	Web (HTTP)

•	Email (POP3)

•	Email (SMTP)

•

FTP

•

DNS

•

Custom

Web (HTTP) - Details Tab

 

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

 

Computer	Type the name of the computer where the SMTP 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.
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

 

Computer	Type the name of the computer where the POP3 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.
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

 

Computer	Type the name of the computer where the FTP 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.
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

 

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.

Custom - Details Tab

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 like opening and closing a port as well as communicating with the Internet application by sending and receiving information.

To add an action:

1.	Click Add or Insert. The Action Properties dialog appears.

2.	Select the action that you want to perform and configure its properties:

•	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, select Send data from file.

•

Receive data - Select Publish as Published Data and select the name of the variable where the received data will be saved. Select Save data, specify the File where you want to save the data received from the Internet application. You will also need to select the action you want to take If the Destination File Exists.

•	Close port - To run this action you will need to have used the Open port action before this action.

3.	Select the item created and click the Up and 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.

Alternate icon

You can change the icon that appears in the workspace for this object. To change the icon, follow the instructions in Changing the object icon.

Available Published Data

 

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 the following modes: • FTP • POP3 • 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.

Common Published Data