Manage the Application Server from the command line for ArcIMS 3.0

Summary

You can start, stop, add, and delete MapServices, Spatial Servers, and Virtual Servers from the command line.

Procedure

• To manage the ArcIMS Application Server from the command line, first open a command prompt. From the command prompt you will use the following syntax:
  
  

  Code:
  java com.esri.aims.admincore.cmd.Exec <url> <user> <pword> <options> <commands>

  
  Where:
  
  

  url = http://host_web_server - Example: http://corleone
  user = login user name
  pword = login password
  options	= cmd {used to specify an information tag follows} 
            file {a file containing predefined commands}
  commands = filename or command to process:
     SERVICE - Gets all services
     VSERVER - Gets all Virtual Servers
     PSERVER - Gets all Physical (Spatial) Servers
     STATS   - Gets stats for all Virtual Servers  

  
  
• The following examples show how to:
  
  Get Statistics:
  

  Code:
  > java com.esri.aims.admincore.cmd.Exec http://corleone admin admin cmd STATS

  
  Get Services:
  

  Code:
  > java com.esri.aims.admincore.cmd.Exec http://corleone admin admin cmd SERVICE
  

  
  Get Virtual Servers
  

  Code:
  > java com.esri.aims.admincore.cmd.Exec http://corleone admin admin cmd VSERVER
  

  
  Get Physical (Spatial) Servers
  

  Code:
  > java com.esri.aims.admincore.cmd.Exec http://corleone admin admin cmd PSERVER

  
  
• The same command line syntax can be used to process XML batch files. The following illustrates how to do this with the sample testAddandStartService.xml and testStopandRemoveService.xml files:
  
  

  Code:
  > java com.esri.aims.admincore.cmd.Exec http://corleone admin admin file testAddandStartService.xml

  
  Here is the testAddandStartService.xml file:
  
  
  <?xml version="1.0" encoding="Cp1252"?>
  <ADMINCMD VERSION="0.1">
  <SERVICES>
  <SERVICE TYPE="ADD"
  NAME="WORLD1"
  AXL="c:\ArcIMS\Axl\world.axl"
  VSNAME="ImageServer1"
  IMGLOC="c:\arcims\output"
  IMGURL="http://corleone/output"
  CLEANUP="5"
  IMGTYPE="PNG"
  />
  <SERVICE TYPE="START"
  NAME="WORLD1"
  />
  <SERVICE TYPE="ADD"
  NAME="WORLD2"
  AXL="c:\ArcIMS\Axl\world.axl"
  VSNAME="FeatureServer1"
  IMGLOC="c:\arcims\output"
  IMGURL="http://corleone/output"
  CLEANUP="5"
  IMGTYPE="PNG"
  />
  <SERVICE TYPE="START"
  NAME="WORLD2"
  />
  <SERVICE TYPE="ADD"
  NAME="WORLD3"
  AXL="c:\ArcIMS\Axl\world.axl"
  VSNAME="ImageServer1"
  IMGLOC="c:\arcims\output"
  IMGURL="http://corleone/output"
  CLEANUP="5"
  IMGTYPE="PNG"
  />
  <SERVICE TYPE="START"
  NAME="WORLD3"
  />
  <SERVICE TYPE="ADD"
  NAME="WORLD4"
  AXL="c:\ArcIMS\Axl\world.axl"
  VSNAME="FeatureServer1"
  IMGLOC="c:\arcims\output"
  IMGURL="http://corleone/output"
  CLEANUP="5"
  IMGTYPE="PNG"
  />
  <SERVICE TYPE="START"
  NAME="WORLD4"
  />
  </SERVICES>
  </ADMINCMD>
  
  
  
  

  Code:
  > java com.esri.aims.admincore.cmd.Exec http://corleone admin admin file testStopandRemoveService.xml 

  
  Here is the testStopandRemoveService.xml file:
  
  
  <?xml version="1.0" encoding="Cp1252"?>
  <ADMINCMD VERSION="0.1">
  <SERVICES>
  <SERVICE TYPE="STOP" NAME="WORLD1" />
  <SERVICE TYPE="REMOVE" NAME="WORLD1" />
  <SERVICE TYPE="STOP" NAME="WORLD2" />
  <SERVICE TYPE="REMOVE" NAME="WORLD2" />
  <SERVICE TYPE="STOP" NAME="WORLD3" />
  <SERVICE TYPE="REMOVE" NAME="WORLD3" />
  <SERVICE TYPE="STOP" NAME="WORLD4" />
  <SERVICE TYPE="REMOVE" NAME="WORLD4" />
  </SERVICES>
  </ADMINCMD>
  
  
  
  
  Click below to see the XML batch file syntax for managing:
  
  - Services (SERVICE)
  
  
  <?xml version="1.0" encoding="Cp1252"?>
  <ADMINCMD VERSION="0.1">
  <SERVICES>
  <SERVICE TYPE={ ADD | CHANGE | REMOVE | START | STOP }
  NAME="WORLD1"
  AXL={Any valid axl file e.g. "c:\ArcIMS\Axl\world.axl"}
  VSNAME={Any valid Virtual Server name e.g. ImageServer1}
  IMGLOC="c:\arcims\output"
  IMGURL="http://corleone/output"
  CLEANUP={integer number}
  IMGTYPE={ PNG | GIF | JPG }
  />
  </SERVICES>
  </ADMINCMD>
  
  
  - Physical (Spatial) Servers (PSERVER)
  
  
  <?xml version="1.0" encoding="Cp1252"?>
  <ADMINCMD VERSION="0.1">
  <PSERVERS>
  <PSERVER TYPE={ ADD | REMOVE }
  ID={ unique id for this machine - usually added for you }
  MACHINE={ any machine that has monitor running on it }
  THREADS={ integer number of threads - used for virtual servers only }
  />
  </PSERVERS>
  </ADMINCMD>
  
  
  - Spatial Servers (VSERVER)
  
  
  <?xml version="1.0" encoding="Cp1252"?>
  <ADMINCMD VERSION="0.1">
  <VSERVERS>
  <VSERVER TYPE={ ADD | CHANGE | REMOVE }
  NAME={ Name of VSERVER }
  SERVICETYPE={ any valid server component (e.g. ImageServer) }
  <PSERVER ID={ ServerID } THREADS={ n } />
  />
  </VSERVERS>
  </ADMINCMD>