ANT target: ConfigureCommerceServer

The ConfigureCommerceServer executes steps to configure the WAS for the WebSphere Commerce 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.

For detailed descriptions, refer to the individual pages for the subtargets.

 

Called by:

CreateInstance

 

Calls:

• CreateProfile

• SetProcessExecution

• StartWAS

• CreateWebServerDefinition

• ModifyPluginCfgFileLocation

• ModifyHttpLogLocation

• CheckWASServerStarted

• SetServerProperties

• CreateVirtualHosts

• CreateJaasAuthData

• CreateJDBCProvider

• CreateDataSourceV5

• PrepareEAR

• PrimeInstanceXmlInTempEAR

• InstallEAR

• SetEARProperties

• RegeneratePlugin

 

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

merchantKey

The WebSphere Commerce site merchant key.

siteAdminPassword

The WebSphere Commerce site administrator's password.

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 -DmerchantKey=merchantKey -DsiteAdminPassword=siteAdminPassword -DdbaPassword=dbaPassword -DdbUserPassword=dbUserPassword ConfigureCommerceServer

• I5/OS:

  WC_installdir/bin/config_ant.sh -DinstanceName=instance -DmerchantKey=merchantKey -DsiteAdminPassword=siteAdminPassword -DdbUserPassword=dbUserPassword ConfigureCommerceServer

• Windows: WC_installdir/bin/config_ant.bat -DinstanceName=instance -DmerchantKey=merchantKey -DsiteAdminPassword=siteAdminPassword -DdbaPassword=dbaPassword -DdbUserPassword=dbUserPassword ConfigureCommerceServer

• ANT target: CreateProfile
  CreateProfile creates a new profile to host a WebSphere Commerce instance.

• ANT target: SetProcessExecution
  SetProcessExecution sets the umask attribute of the application server on non-Windows platforms.

• ANT target: StartWAS
  All WAS configuration actions require that the WAS administrative server (server1) is running. StartWAS starts the WAS administrative server.

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

• ANT target: CreateWebServerDefinition
  CreateWebServerDefinition creates a Web server definition on the WAS node for Web module bindings and Web server plugin configurations.

• ANT target: ModifyPluginCfgFileLocation
  ModifyPluginCfgFileLocation updates the plugin-cfg.xml file path in the Web server definition.

• ANT target: ModifyHttpLogLocation
  ModifyHttpLogLocation updates the access_log and error_log file paths in the Web server plug-in configuration file for IBM HTTP server only.

• ANT target: CheckWASServerStarted
  CheckWASServerStarted checks if the WAS admin server process (server1) is running.

• ANT target: SetServerProperties
  SetServerProperties sets the application server properties such as JVM properties, custom properties, and dynamic cache properties for the WebSphere Commerce instance. You might use SetServerProperties to reset or recover the application server properties.

• ANT target: CreateVirtualHosts
  CreateVirtualHosts creates all virtual hosts (and host aliases per virtual host) for mappings to the WebSphere Commerce Web modules. CreateVirtualHosts can be run multiple times.

• ANT target: CreateJaasAuthData
  CreateJaasAuthData creates the JAAS Authentication Data for the WebSphere Commerce datasource. This JAAS Authentication Data object contains the WebSphere Commerce database user ID and password.

• ANT target: CreateJDBCProvider
  CreateJDBCProvider creates the WebSphere Commerce instance's JDBC provider in the application server scope (server1).

• ANT target: CreateDataSourceV5
  CreateDataSourceV5 creates the WebSphere Commerce datasource associated with the JDBC provider. The DataSource is used by WebSphere Commerce to connect to the database.

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

• ANT target: PrimeInstanceXmlInTempEAR
  PrimeInstanceXmlInTempEAR inserts the instance configuration XML file into the deployable WebSphere Commerce EAR.

• ANT target: InstallEAR
  InstallEAR installs the installable EAR into the profile's application server (server1) and maps all EJB modules to the data sources that CreateDataSourceV5 ANT target creates. The CreateVirtualHosts ANT target creates the virtual hosts which InstallEAR maps to the virtual hosts.

• ANT target: SetEARProperties
  SetEARProperties sets the J2C Connection Factory for the resource adapters and application classloader.

• ANT target: RegeneratePlugin
  RegeneratePlugin regenerates the Web server plugin configuration file (plugin-cfg.xml) for the Web server definition. This target regenerates the Web server plugin configuration file when there is a change in the virtual host settings and should be run for any changes to the virtual host configurations.

• ANT target: AddWASService
  AddWASService adds the WebSphere Commerce application server into the Windows services list. The name of the service is "IBM WebSphere Application Server V6 - WC_instance".

• ANT target: CreateHTTPService
  If you are using a local IBM HTTP Server, the instance creation process creates a Windows service to start and stop the IBM HTTP Server configuration that is associated with that instance. CreateHTTPService creates the service that starts and stops the IBM HTTP Server configuration.

Related Concepts

ANT targets