Reference > ANT targets > Ant targets: Creating and configuring targets

ANT target: CreateInstance

CreateInstance runs all instance creation actions such as database configuration, WebSphere Application Server configuration, Web server configuration, Content Management configuration, generating WCS instance specific files and file permission settings.

Prerequisites:

The createInstance.properties file must exist for this ANT target to work.

Before running this ANT target, complete the steps in Generate the createInstance.properties file.

Ant target calls

To skip any of the instance creation actions, you should not run CreateInstance but run the subtargets selectively.

• PrepareDeployment
• PrepareEAR
• ConfigureDatabase
• ConfigureCommerceServer
• ConfigureWorkspaceComponent
• RegisterInstance
• ConfigureWebServer
• PostInstanceCreation
• StopWAS

Required parameters

instance	The name of the WCS instance with which you are working (for example, demo).
dbaPassword	The database administrator's password. This parameter is required when: A database will be created for the new WCS instance A user schema will be created for the new WCS instance. This parameter is not required when using an existing database or schema for the new WCS 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	The authoring server's workspace database user password. Required if workspaces are enabled
ftpUserPwd	The user password of the FTP account being used to configure the web server. Required if configuring remote webserver via FTP option

Examples

WC_INSTALL/bin/config_ant.sh -DinstanceName=instance  \
                             -DdbaPassword=dbaPassword  \
                             -DdbUserPassword=dbUserPassword  \
                             -DsiteAdminPassword=siteAdminPassword  \
                             -DmerchantKey=merchantKey  \
                             CreateInstance


WC_INSTALL/bin/config_ant.sh -DinstanceName=instance  \
                             -DdbUserPassword=dbUserPassword  \
                             -DsiteAdminPassword=siteAdminPassword  \
                             -DmerchantKey=merchantKey  \
                             CreateInstance

Recovery

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

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

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

   • • WC_USER/instances/instance/logs/createInstanceANT.log
     • WC_USER/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. Run the rest of the targets.

When creating the WCS instance using the config_ant.sh script, you may 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:

1. Edit... WC_PROFILE/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. Run the rest of the targets.

• ANT target: PrepareDeployment
  PrepareDeployment performs various pre-instance creation configuration actions such as copying and updating the loader utility configuration files.

• ANT target: ConfigureCommerceServer
  The ConfigureCommerceServer executes steps to configure the WebSphere Application Server for the WCS instance. The target creates a profile, web server definition, virtual hosts, data source, and installs the WebSphere Commerce enterprise application. Finally, the web server plug-in configuration file is generated.

• ANT target: ConfigureDatabase
  ConfigureDatabase creates a database with schema, and populates the schema with the WebSphere Commerce bootstrap data.

• ANT target: ConfigureWorkspaceComponent
  ConfigureWorkspaceComponent is used to configure the workspaces feature on an authoring server.

• 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.

• ANT target: ConfigureWebServer
  ConfigureWebServer supports IBM HTTP Server. ConfigureWebServer can also reconfigure the Web server to restore the initial configuration.

• ANT target: PostInstanceCreation
  PostInstanceCreation performs various post instance creation configuration actions such as setting file permissions on WebSphere Commerce files.

• ANT target: PrepareEAR
  PrepareEAR prepares the instance specific temporary WebSphere Commerce EAR to be deployed.

• ANT target: StopWAS
  StopWAS stops the WAS administrative server (server1) of the WCS instance.

Related concepts

ANT targets

+

Search Tips   |   Advanced Search