+

Search Tips   |   Advanced Search

Syntax elements for the XML configuration interface command line

This topic lists the syntax elements for using the XML configuration interface command line client over an HTTP connection.


Syntax elements

For information about the XML syntax elements for a secure HTTPS connection see the topic about XML Syntax elements for using a secure connection with SSL.

Syntax element Description
xmlaccess This is the shell script. It is located in directory wp_profile_root/PortalServer/bin. Use one of the following scripts:

  • UNIX Linux : ./xmlaccess.sh

  • IBM i: xmlaccess.sh
  • Windows : xmlaccess.bat
  • z/OS : ./xmlaccess.sh

-in Specify the name of a file containing the XML request (configuration export or update) that should be processed.
-user and -password Use these elements to specify the user identification and password describing the authority under which the request should be processed. For the value for user you must specify the short user name as specified during login; full distinguished names (DN) are not supported. The XML configuration interface is only accessible to users that have the manager role on the virtual resource XML_ACCESS and the administrator role on the virtual resource PORTAL.
-askForCredential             We can use the parameter askForCredential and leave out the parameters user and password. The XML configuration interface will then prompt you for the user ID and password. The parameter askForCredential requires no value to be specified.
-useEncryptedCredentials Use this option if we want to provide the user credentials in a properties file rather than with the XML command.
-noUpdateProperties Use this option additionally with the option useEncryptedCredentials, if you do not want to have the encrypted credentials written back to the properties file.
-url Specify the URL to access the configuration servlet. This URL consists of the host name, the base URI as specified during installation (for example /wps), and the servlet extension /config.

For z/OS : Specify the URL to access the configuration servlet. This URL consists of the host name and port, the base URI as specified during installation (for example /wps), and the servlet extension /config.

-out The name of the result file that contains the XML output. This file gives a result status and thereby indicates whether the XML request was performed successfully, or what errors might have occurred. In the case of an XML export, this file contains the exported configuration. We can later use this file to re-import the exported configuration.