OracleFMW MapViewer command line admin tool readme
============== Introduction ==================================================
You can use the included mvadmin.jar to issue administrative (XML) requests to
a running MapViewer instance.
Note that each admin request must be in the form of a single XML file.
Each XML file can only have one XML admin request.
This kit contains several sample XML admin requests that you can modify and
reuse. In general there are two types of MapViewer admin requests: those that
are generic (such as clearing mapping metadata and in-memory geometry data
cache) which should be sent to the /mapviewer/mapadmin end point; and
those that are related to the tile server which goes to /mapviewer/mcsadmin.
The proper end point is mentioned in each sample XML request.
Note that the included XML requests are a subset of all supported admin
requests. For a more complete list of MapViewer XML admin requests, please
visit the following Web page of your MapViewer installation.
For more generic MapViewer admin requests:
/mapviewer/admin.html
For more tile server admin requests:
/mapviewer/tilecache/mcsadmin.html
On each page you will see a number of text boxes that contain a single XML
request. Just copy and save the request you would like to send from the
command line.
============ How to use mvadmin.jar ==========================================
To use this tool, Java version 1.5 is required.
From a command line, enter "java -jar mvadmin.jar" for usage notes.
Here is a complete command (all in one line) for sending an XML request:
java -jar mvadmin.jar -u weblogic -p welcome1 \
-xml refresh-tiles.xml \
-server http://localhost:7001/mapviewer/mcsadmin
where -u and -p options specify the MapViewer admin user and password;
-xml points to the XML request file;
-server is the MapViewer server URL (ending with either /mcsadmin or /mapadmin
depending on the request type).
A successful request should generate outputs like these:
## Server URL: http://localhost:7001/mapviewer/mcsadmin
## Establishing initial contact...
## Response status code: 200
## Authenticating with the server...... done.
## Sending xml request from file: refresh-tiles.xml
## Server response:
Submitted
0
On the other hand, if your output looks like the following:
## Server URL: http://localhost:7001/mapviewer/mcsadmin
## Establishing initial contact...
## Response status code: 200
## Authenticating with the server...... done.
## Sending xml request from file: get-tile-task-status.xml
## Server response:
302 Moved Temporarily
This document you requested has moved temporarily.
It's now at http://localhost:7001/mapviewer/mvlogon.jsp.
then most likely the tool was not able to authenticate to the MapViewer
server. Please check your admin user name and password.
For questions or comments, please visit the MapViewer OTN forum here:
http://forums.oracle.com/forums/forum.jspa?forumID=727&start=0
Thanks
MapViewer team
Feb. 25 2010