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.

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:

• AIX|Linux|Solaris|Windows:

  WC_installdir/instances/instance/xml/instance.xml

• I5/OS: WC_userdir/instances/instance/xml/instance.xml

The instance property values are contained in these files:

• AIX|Linux|Solaris|Windows:

  WC_installdir/instances/instance/properties/createInstance.properties

• I5/OS: WC_userdir/instances/instance/properties/createInstance.properties

 

Called by:

CreateInstance

 

Prerequisites:

The createInstance.properties file must exist for this Ant target to work. For information on generating the properties file, see ANT targets.

 

Required parameters:

instance

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.

AIX|Linux|Solaris|Windows:

dbaPassword

The database administrator's password.

dbUserPassword

The WebSphere Commerce database user's password.

 

Example

• AIX|Linux|Solaris|WC_installdir/bin/config_ant.sh -DinstanceName=instance -DsiteAdminPassword=siteAdminPassword -DmerchantKey=merchantKey -DdbaPassword=dbaPassword -DdbUserPassword=dbUserPassword RegisterInstance

• I5/OS: WC_installdir/bin/config_ant.sh -DinstanceName=instance -DsiteAdminPassword=siteAdminPassword -DmerchantKey=merchantKey -DdbUserPassword=dbUserPassword RegisterInstance

• Windows:

  WC_installdir/bin/config_ant.bat -DinstanceName=instance -DsiteAdminPassword=siteAdminPassword -DmerchantKey=merchantKey -DdbaPassword=dbaPassword -DdbUserPassword=dbUserPassword RegisterInstance

 

Recovery:

1. If an error occurs, review the following log files:

   • AIX|Linux|Solaris|Windows:

     • WC_installdir/instances/instance/logs/createInstanceANT.log

     • WC_installdir/instances/instance/logs/createInstanceANT.err.log

   • I5/OS|

     • WC_userdir/instances/instance/logs/createInstanceANT.log

     • WC_userdir/instances/instance/logs/createInstanceANT.err.log

2. Resolve the problem.

3. Execute the RegisterInstance target again.

Related Concepts

ANT targets