Basic XML command line syntax
The basic command line syntax for the XML configuration interface is as follows.
xmlaccess -user user_ID -password password -url myhost:10039/wps/config -in input_file.xml -out result_file.xml
All data, including the user ID and password, are sent to the server unencrypted. Therefore only connect to xmlaccess.sh from inside a protected intranet where we can be sure the HTTP connection is not compromised. In all other networks use a secure HTTPS connection to connect to xmlaccess.sh.
Prompting for credentials: Use the parameter askForCredential and leave out the parameters user and password. xmlaccess.sh will then prompt you for the user ID and password. This can be useful in security sensitive environments, as the user credentials are not visible on the console or in the process view. The parameter askForCredential requires no value to be specified. Example:
xmlaccess -askForCredential -url myhost:10039/wps/config -in input_file.xml -out result_file.xml
Placing the credentials in a properties file: We can also place the credentials in a properties file and use the option useEncryptedCredentials. This option reads the encrypted or unencrypted credentials from the properties file, and then saves the file back using the encrypted password. If we do not want to write the properties file back with the encrypted credentials, use the additional flag noUpdateProperties. In this case use the PropFilePasswordEncoder utility to encrypt the password in the properties file. This option reads the following properties out of the file:
- For the user ID: com.ibm.SOAP.loginUserid = userID
- For the password: com.ibm.SOAP.loginPassword = password
An example of a command line is as follows
xmlaccess -in Export.xml -useEncryptedCredentials myProperties.properties -url portal.example.com:10039/wps/config
Virtual portals: If we have virtual portals in the configuration, we can access a virtual portal by its host name or its URL mapping context. Example for accessing a virtual portal by its URL mapping context:
xmlaccess -user user_ID -password password -url myhost:10039/wps/config/URL_mapping_context_of_the_VP -in input_file.xml -out result_file.xml
Example for accessing a virtual portal by its host name:
xmlaccess -user user_ID -password password -url my_VP_host:10039/wps/config -in input_file.xml -out result_file.xml
See also