VSERVER

VSERVER

Used in: Application Server Administration
Parent elements: VSERVERS

<VSERVER	Attribute Description Table
When adding a Virtual Server: access ="PUBLIC \| PRIVATE" *name ="string"* servicetype ="ImageServer \| FeatureServer \| MetadataServer \| QueryServer \| ExtractServer \| GeocodeServer" version =""" \| ArcMap" description ="string" frequency ="1 \| 2 \| 3 \| 4 \| 6 \| 8 \| 12 \| 24" [2] referencehour ="0 .. 23" [0] referenceminute ="0 \| 15 \| 30 \| 45" [0] type ="add" When deleting a Virtual Server: *name ="string"* type ="remove" > (m) <PSERVER... /> </VSERVER >
Bold: Attribute or child element is required. (m): Child element can be used multiple times.

Description:

Allows adding and removing an ArcIMS Virtual Server using the command line.

Restrictions:

None

Notes:

VSERVER is used to administer ArcIMS Virtual Servers from the command line. To do this, two files are used:
- An ADMINCMD XML file
- A batch file or script
The ADMINCMD XML file contains the instructions for adding, starting, stopping, and removing ArcIMS services. See the examples for proper construction of an ADMINCMD XML file.

On Windows, the batch file contains one line:

<jre directory>\java.exe com.esri.aims.admincore.cmd.Exec http://mymachine.domain.com Username Password file filename

Where:
- <jre directory>\java.exe is the location of a java.exe file. If the directory path has spaces, you must use quotes, for example, "C:\Program Files\arcGIS\ArcIMS\Jre\bin\java.exe"
- http://mymachine.domain.com is the host machine.
- Username is the user name for ArcIMS administration.
- Password is the password for ArcIMS administration.
- Filename is the full pathname and name of the ADMINCMD XML file, for example, c:\arcims\axl\admincmd.xml.
- Note: the parameter "file" must be included before the filename.
The above command can also be typed on the command line in lieu of using the batch file.

On UNIX, a script file is used. In the following example, note that the line beginning with "java -cp" is all one line:
#!/bin/csh

setenv JARHOME $AIMSHOME/Manager/lib
setenv AIMSHOST $argv[1]

java -cp $JARHOME/jaxp.jar:$JARHOME/parser.jar:$JARHOME/esri_mo10.jar: $JARHOME/esri_mo10res.jar:$JARHOME/arcims_admincore.jar:$JARHOME/arcims_admin.jar: $JARHOME/jcert.jar:$JARHOME/jnet.jar:$JARHOME/jsse.jar:$JARHOME/arcims_resadmin.jar com.esri.aims.admincore.cmd.Exec http://$AIMSHOST Username Password file $argv[2]

Where:
- $argv[1] is the hostname.
- $argv[2] is the name of the ADMINCMD XML file, for example, admincmd.xml.
- Username and Password are the username and password for ArcIMS adminstration.
- Note: the parameter "file" must be included before $argv[2].

Attribute Descriptions for VSERVER:

When adding a Virtual Server:

Attribute	Usage	Back to Top
access	Specifies whether a Virtual Server is public or private. In general, you should use "PUBLIC" for Image, Feature, ArcMap, and Metadata Servers. You should use "PRIVATE" for Query, Geocode, and Extract Servers.
description	Provides a description of the Virtual Server.
frequency	Number of times per each 24 hour period to recycle all Spatial Servers associated with this Virtual Server. Used only with Virtual Servers that are capable of recycling.
name	Specifies the Virtual Server name.
referencehour	Starting hour to begin the first recycling period each day using a 24 hour clock. "0" is midnight. Used only with Virtual Servers that are capable of recycling.
referenceminute	Starting minute to begin the first recycling period each day using a 24 hour clock. Used only with Virtual Servers that are capable of recycling.
servicetype	The Virtual Server type: ImageServer, FeatureServer, MetadataServer, ExtractServer, GeocodeServer, QueryServer. For ArcMap Server, use "ImageServer" for this attribute.
type	Use "add" to specify adding a Virtual Server.
version	Specifies whether an ImageServer is an ArcMap Image Server. For ArcMap Image Servers, use "ArcMap". For all other server types, use "".

When deleting a Virtual Server:

Attribute	Usage	Back to Top
name	Specifies the Virtual Server name.
type	Use "remove" to specify removing a Virtual Server.

Examples for VSERVER:

Example 1: When adding a new Virtual Server. This example adds an ArcMap Image Server.

Back to Top

<?xml version="1.0"?>
<ADMINCMD version="1.0">
  <PSERVERS>
    <PSERVER type="add" machine="mymachine.domain.com"/>
  </PSERVERS>
  <VSERVERS>
    <VSERVER type="add"
             name="ImageServerArcMap2"
             access="Public"
             description="ImageServer ArcMap Example"
             servicetype="ImageServer"
             version="ArcMap"
             referencehour="1"
             referenceminute="0"
             frequency="2"
    >

      <PSERVER id="mymachine.domain.com_4" threads="1"/>
      <PSERVER id="mymachine.domain.com_5" threads="1"/>
    </VSERVER>
  </VSERVERS>
</ADMINCMD>

Example 2: When removing a Virtual Server.	Back to Top
<?xml version="1.0"?> <ADMINCMD version="1.0"> <VSERVERS> <VSERVER type="remove" name="ImageServerArcMap2"/> </VSERVERS> <PSERVERS> <PSERVER type="remove" machine="mymachine.domain.com" id="mymachine.domain.com_4"/> <PSERVER type="remove" machine="mymachine.domain.com" id="mymachine.domain.com_5"/> </PSERVERS> </ADMINCMD>