ANT target: CreateInstance

CreateInstance executes all instance creation actions such as database configuration, WAS configuration, Web server configuration, Content Management configuration, generating WebSphere Commerce instance specific files and file permission settings.

If you want to skip any of the instance creation actions, you should not execute CreateInstance but should execute the subtargets selectively.

 

Calls:

 

Prerequisites:

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

The createInstance.properties file contains a complete list of properties. If change any of the property values, you can do this by modifying the createInstance.properties file located at:

 

Required parameters:

instance

The name of the WebSphere Commerce instance with which you are working (for example, demo).

AIX|Linux|Solaris|Windows:

dbaPassword

The database administrator's password. This parameter is required when:

  • (DB2) A database will be created for the new WebSphere Commerce instance

  • (Oracle) A user schema will be created for the new WebSphere Commerce instance.

This parameter is not required when using an existing database or schema for your new WebSphere Commerce instance.

dbUserPassword

The WebSphere Commerce database user's password.

siteAdminPassword

The WebSphere Commerce site administrator's password.

merchantKey

The WebSphere Commerce site merchant key.

cmDBUserPwd (required if workspaces are enabled)

The authoring server's workspace database user password.

ftpUserPwd (required if configuring remote webserver via FTP option)

The user password of the FTP account being used to configure the web server.

 

Example

 

Recovery:

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

    • AIX|Linux|Solaris|Windows:

    • I5/OS|

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

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

  2. Identify which step (Ant target) failed.

  3. Resolve the problem.

  4. Follow the recovery instructions in the failed target.

  5. Execute the rest of the targets.

The following type of error may be encountered when creating the WebSphere Commerce instance using the config_ant.sh script 

WASX7017E: Exception received while running file "/QIBM/ProdData/
CommerceServer60/config/deployment/scripts/uninstallEar.jacl";
exception information: com.ibm.websphere.management.exception.
ConfigServiceExceptioncom.ibm.websphere.management.exception.
ConnectorException org.apache.soap.SOAPException:[SOAPException: 
faultCode=SOAP-ENV:Client; msg=READ TIMED UT; targetException=
java.net.SocketTime outException: READ TIMED OUT]

WASX7309W: No "save" was performed before the script
"/QIBM/ProdData
/CommerceServer60/Config/deployment/scripts/uninstallEar.jacl"exited;

configuration changes will not be saved.

If this error is encountered...

  1. Open the following file in a text editor: WC_profiledir/properties/soap.client.props

  2. Search for the com.ibm.SOAP.requestTimeout entry, and set the value to 6000. For example, com.ibm.SOAP.requestTimeout=6000.

  3. Follow the recovery instructions in the failed target.

  4. Execute the rest of the targets.

Related concepts

ANT targets


Related Reference

ANT target: ConfigureDatabase

ANT target: ConfigureCommerceServer

ANT target: RegisterInstance

ANT target: ConfigureWebServer

ANT target: PostInstanceCreation