How Do I Use The Command Line Utility XTNetworkXML.exe?

A real pain when doing a network scan at the branch office is the lack of an Argent GUI at the branch office.

And…

You may have only the telnet or SSH access owing to the slow network link.

But the Argent command line utility XTNetworkXML will save you a lot of hassle.

The XTNetworkXML utility is installed as part of the standard setup but you can also copy the following files manually:

  • XTNetworkXML.exe
  • XTNetworkScanner.exe
  • AppRegs.dat
  • Sample_Network_Scan.xml

The XTNetworkXML utility uses an XML control file.

Here’s the details:

METHOD

The METHOD attribute specifies the type of network scanning to use.

It can be:

  • Active Directory
  • Network Browser
  • ICMP Ping
  • Windows Cluster
  • SNMP

NOTIFY

The optional NOTIFY attribute specifies the email address to send the scanning results.

INCLUDE

Each INCLUDEs attribute specifies ones kind of server/device to find.

Active Directory

The optional attribute CONTAINER specifies the domain to scan.

If not specified, the complete network is scanned.




<XT_SCAN_NETWORK 



METHOD="Active Directory" 

CONTAINER="LDAP://cn=computers,ou=Asia,dc=domain" 

NOTIFY="Argent@SampleCompany.com">

	

<INCLUDE 	value="W200x/NT Domain Controllers"	/>

<INCLUDE 	value="W200x/NT Servers"		/>

<INCLUDE 	value="W200x/XP/NT Workstations"	/>

<INCLUDE 	value="NT Backup Controllers"		/>

<INCLUDE 	value="Printer Queues"			/>

<INCLUDE 	value="Windows 9x Systems"		/>

<INCLUDE 	value="WfW Workstations"		/>

<INCLUDE 	value="Novell Systems"			/>

<INCLUDE 	value="Unknown Systems"		        />



</XT_SCAN_NETWORK>

Network Browser

The optional attribute DOMAIN specifies the domain to scan.

If it is not specified, the complete network is scanned.




<XT_SCAN_NETWORK 



METHOD="Network Browser" 

DOMAIN="DELMAR" 

NOTIFY="Argent@SampleCompany.com">



<INCLUDE 	value="W200x/NT Domain Controllers"	/>

<INCLUDE 	value="W200x/NT Servers"		/>

<INCLUDE 	value="W200x/XP/NT Workstations"	/>

<INCLUDE 	value="NT Backup Controllers"		/>

<INCLUDE 	value="Printer Queues"			/>

<INCLUDE 	value="Windows 9x Systems"		/>

<INCLUDE 	value="WfW Workstations"		/>

<INCLUDE 	value="Novell Systems"			/>

<INCLUDE 	value="Unknown Systems"		        />



</XT_SCAN_NETWORK>

ICMP Ping

The required attribute, START, END, SUBNET, etc defines the behavior of TCP/IP network scanning.


<XT_SCAN_NETWORK 

METHOD="ICMP Ping" 

NOTIFY="Argent@SampleCompany.com" 

START="192.168.1.1" 

END="192.168.1.254" 

SUBNET="255.255.255.0" 

TIMEOUT="3" 

RETRY="1" 

THREAD="256">



<INCLUDE value="TCP/IP Addresses"			/>



</XT_SCAN_NETWORK>

Cluster

The required attribute CLUSTER specifies the cluster to scan.




<XT_SCAN_NETWORK 

METHOD="Windows Cluster" 

CLUSTER="ARGENT_CLUSTER"

NOTIFY="Argent@SampleCompany.com">

<INCLUDE 	value="Cluster Nodes"			/>

<INCLUDE 	value="Cluster Groups"			/>

<INCLUDE 	value="Cluster Networks"		/>

<INCLUDE 	value="Cluster Network Interfaces "	/>

<INCLUDE 	value="Cluster Resource "		/>



</XT_SCAN_NETWORK>

SNMP




<XT_SCAN_NETWORK 

METHOD="SNMP" 

NOTIFY="Argent@SampleCompany.com" 

OID=".1.3.6.1.2.1.1.5.0" 

PORT="161" 

COMMUNITY="PUBLIC" 

TIMEOUT="3">



<INCLUDE value="TCP/IP Addresses"			/>

</XT_SCAN_NETWORK>

XTNetworkXML Parameters

After you have customized the XML configuration file you need to specify the command line parameters

Command line syntax is as follows:

XTNetworkScanner /XML=xml_file [/GROUP=group_name] [/SERVICE] [/MAPI | /SMTP | /NOTES] [/NOTIFY=email]

Parameters

/XML=xml_file

Specifies the full path of the configuration XML file.

Additional Switches

/GROUP=group_name

Specifies the assigned network group name for the local network. Each network segment should have its own unique network group name to help organize the Master Catalog better. Used to specify the IP address for the Monitoring Engine if this is not DNS resolvable.

/NOTIFY=email

Sends an email notification of the result of the scan to the specified email account. This overrides any email given in the configuration XML file.

/MAPI

/SMTP

/NOTES

Specifies one of the three protocols for sending notification emails through the Argent Console main engine. The Argent Console main engine must have the email configured properly. If none of the switches are used, the notification will be sent as web mail.

/SERVICE

Scans for W200x services.

When the program completes successfully, the network scanning result is saved in file {MACHINE_NAME}_NETWORK.XML.

If the email option is used, user can see an email in the inbox.