InfoCenter Home >
6: Administer applications >
6.6: Tools and resources quick reference >
6.6.0: About user assistance >
6.6.0.2: Command line administration >
6.6.0.2.1: XMLConfig command line interface for XML configuration >
6.6.0.2.1.1: XMLConfig - Command syntax

6.6.0.2.1.1: XMLConfig - Command syntax

This section describes the command line syntax for the XMLConfig tool.

Because setting the classpath appropriately is vital to the tool's success, WebSphere Application Server Version 3.5 contains an XMLConfig.bat (Windows NT) or XMLConfig.sh (*IX) file for starting the tool. The file is located in the bin directory of the product installation root, uses the com.ibm.websphere.xmlconfig.XMLConfig java class, and has the following command line syntax:

        { ( -import <xml data file> ) ||
[ ( -export <xml output file> [-partial <xml data file>] ) }
-adminNodeName <primary node name>
[ -nameServiceHost <host name> [ -nameServicePort <port number> ]]
[-traceString <trace spec> [-traceFile <file name>]]
[-substitute <"key1=value1[;key2=value2;[...]]">]}
In input xml file, the key(s) should appear as $key$ for substitution.
The arguments include:
-adminNodeName
Required argument specifies the node containing the administrative server to which you are connecting. The argument value must match the node name given in the topology tree on the Topology tab of the WebSphere Administrative Console.
-import || -export || -export -partial
Required argument specifies the operation to perform -- an import or export. Unless you also specify the parameter -partial, the export will be treated as a full export.
-nameServiceHost, -nameServicePort
Optional arguments specify the hostname of the machine containing the name service, and the port by which to communicate with the name service. The default value of -nameServicePort is 900.
-traceString
Optional argument specifies the WebSphere Application Server internal code to trace.
For more information, see the traceString section of the trace help.
-substitute
Optional argument specifies the variables to be substituted. For example:
-substitute "NODE_NAME=admin_node;APP_SERVER=default_server"

This argument substitutes any occurrence of $NODE_NAME$ with admin_node and any occurrence of $APP_SERVER$ with default_server that is found in the input XML file.

If the substitution string contains semicolons, use $semiColon$ to separate it from the ";" delimiter. On UNIX platforms, be sure to add an escape character to each dollar sign ($) within the substitution string (for example, \$semiColon\$).

The following examples demonstrate correct syntax. 'Node1' is the name by which the node containing the administrative server is administered.
Import operation:
XMLConfig -adminNodeName Node1 -import import.xml
Full export operation:
XMLConfig -adminNodeName Node1 -export export.xml
Partial export operation:
XMLConfig -adminNodeName Node1 -export export.xml -partial imput.xml
Go to previous article: XMLConfig command line interface for XML configuration Go to next article: XMLConfig - Example of a full export

 

 
Go to previous article: XMLConfig command line interface for XML configuration Go to next article: XMLConfig - Example of a full export