Ant target: RegisterInstance
RegisterInstance generates the master instance configuration XML file and registers the instance into the Configuration Manager tool. RegisterInstance can be used to regenerate the master instance configuration XML file based on the property values in the Ant properties file.
Important: This
Ant target is to be used only
as a part of WebSphere Commerce instance creation.
Note: Any customizations made in Configuration Manager or
manually to the instance.xml file will be lost
if you run this target.
The master instance configuration
file is contained in these files:
- WC_installdir/instances/instance_name/xml/instance_name.xml
- WC_userdir/instances/instance_name/xml/instance_name.xml
The instance property values are contained in these files:
- WC_installdir/instances/instance_name/properties/createInstance.properties
- WC_userdir/instances/instance_name/properties/createInstance.properties
Called by
Prerequisites
The createInstance.properties file must exist for this Ant target to work. For information about generating the properties file, see Ant targets.
Required parameters
- instance_name
- The name of the WebSphere Commerce instance with which you are working (for example, demo).
- siteAdminPassword
- The WebSphere Commerce site administrator's password.
- merchantKey
- The WebSphere Commerce site merchant key.
- dbaPassword
- The database administrator's password.
- dbUserPassword
- The WebSphere Commerce database user's password.
Example
- WC_installdir/bin/config_ant.sh -DinstanceName=instance_name -DsiteAdminPassword=siteAdminPassword -DmerchantKey=merchantKey -DdbaPassword=dbaPassword -DdbUserPassword=dbUserPassword RegisterInstance
- WC_installdir/bin/config_ant.sh -DinstanceName=instance_name -DsiteAdminPassword=siteAdminPassword -DmerchantKey=merchantKey -DdbUserPassword=dbUserPassword RegisterInstance
- WC_installdir/bin/config_ant.bat -DinstanceName=instance_name -DsiteAdminPassword=siteAdminPassword -DmerchantKey=merchantKey -DdbaPassword=dbaPassword -DdbUserPassword=dbUserPassword RegisterInstance
Recovery
- If an error
occurs, review the following log files:
- WC_installdir/instances/instance_name/logs/createInstanceANT.log
- WC_installdir/instances/instance_name/logs/createInstanceANT.err.log
- WC_userdir/instances/instance_name/logs/createInstanceANT.log
- WC_userdir/instances/instance_name/logs/createInstanceANT.err.log
- Resolve the problem.
- Run the RegisterInstance target again.