Ant target: CreateInstance
CreateInstance runs all instance creation actions such as database configuration, WebSphere Application Server configuration, Web server configuration, Content Management configuration, generating WebSphere Commerce instance-specific files and file permission settings.
Prerequisites
The createInstance.properties file must exist for this Ant target to work.
Important: Before
you run this Ant target, complete the steps in Generating the createInstance.properties file.
Note: The
Ant
targets are individually documented to help you easily recover from
a failed instance creation.
Calls
If you want to skip any of the instance creation actions, you should not run CreateInstance but run the subtargets selectively.
Required parameters
- instance_name
- The name of the WebSphere Commerce instance with which you are working (for example, demo).
- dbaPassword
- The
database administrator's password. This parameter is required
when:
- A database is created for the new WebSphere Commerce instance
- A user schema is created for the 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 you configure remote webserver via FTP option) The user password of the FTP account being used to configure the web server.
Example
- WC_installdir/bin/config_ant.sh -DinstanceName=instance_name -DdbaPassword=dbaPassword -DdbUserPassword=dbUserPassword -DsiteAdminPassword=siteAdminPassword -DmerchantKey=merchantKey CreateInstance
- WC_installdir/bin/config_ant.sh -DinstanceName=instance_name -DdbUserPassword=dbUserPassword -DsiteAdminPassword=siteAdminPassword -DmerchantKey=merchantKey CreateInstance
- WC_installdir/bin/config_ant.bat -DinstanceName=instance_name -DdbaPassword=dbaPassword -DdbUserPassword=dbUserPassword -DsiteAdminPassword=siteAdminPassword -DmerchantKey=merchantKey CreateInstance
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
- Identify which step (Ant target) failed.
- Resolve the problem.
- Follow the recovery instructions in the failed target.
- Run the rest of the targets.
Note: When you
create the WebSphere Commerce instance using the
config_ant.sh script, you can encounter an error similar to the following
sample:
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, complete the following steps:
- Open the following file in a text editor: WC_profiledir/properties/soap.client.props
- Search for the
com.ibm.SOAP.requestTimeout
entry, and set the value to 6000. For example,com.ibm.SOAP.requestTimeout=6000
- Follow the recovery instructions in the failed target.
- Run the rest of the targets.