VSERVER

Used in

Application Server Administration  

Parent elements

VSERVERS 

Syntax

<VSERVER	Attribute Description Table
When adding a Virtual Server:      (r)access="PUBLIC | PRIVATE"      (r)name="string"      (r)servicetype="ImageServer | FeatureServer | MetadataServer | QueryServer | ExtractServer | GeocodeServer"      (r)version="[blank]"      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:      (r)name="string"      type="remove" >      (m)<PSERVER... /> </VSERVER >
(r): 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.

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
access	Specifies whether a Virtual Server is public or private. In general, you should use "PUBLIC" for Image, Feature, 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.
type	Use "add" to specify adding a Virtual Server.
version	For all server types, use "".

When deleting a Virtual Server:

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

Back to top 

Examples for VSERVER

Example 1: When adding a new Virtual Server. This example adds two Image Spatial Servers to the new Virtual Server.

<?xml version="1.0"?> <ADMINCMD version="1.0"> <!--Add two new Spatial Servers--> <PSERVERS>       <PSERVER type="add" machine="mymachine"/>       <PSERVER type="add" machine="mymachine"/> </PSERVERS> <!--Create a new Image Server--> <VSERVERS>       <VSERVER type="add" name="ImageServer2" access="Public" description="ImageServer Example" servicetype="ImageServer" version="" >             <!--Associate the new Spatial Servers to the new Image Server-->             <PSERVER id="mymachine_4" threads="2"/>             <PSERVER id="mymachine_5" threads="2"/>       </VSERVER> </VSERVERS> <!--Add and start an Image Service--> <SERVICES> <SERVICE type="add" name="world_image" axl="c:\arcims\axl\myworldservice.axl" vsname="ImageServer2" imgloc="c:\arcims\output" imgurl="http://mymachine.domain.com/output" imagememory="4" cleanup="20" imgtype="GIF" /> <SERVICE type="start" name="world_image" /> </SERVICES> </ADMINCMD>

Example 2: When removing a Virtual Server.

<?xml version="1.0"?> <ADMINCMD version="1.0">   <VSERVERS>     <VSERVER type="remove" name="ImageServer2"/>   </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>

Back to top