Install > Installing maintenance > WebSphere Commerce

Use WebSphere Commerce Update Installer ANT scripts to update the Social Commerce EAR

You can use the UpdateEAR script to install or uninstall Social Commerce fixes to the Social Commerce EAR in a running WebSphere Commerce server. The script can apply multiple applicable fixes at a time, however, the fixes that the script will pick to install are recommended fixes that are chosen by the Update Installer.

Before you begin

• Ensure that Update Installer has access to the applicable fixes in the WC_INSTALL\maintenance\socialcommerce.ear directory specified in WC_INSTALL/config/deployment/xml/updateEAR.properties. If there is no fix or the fix is invalid, the script will fail.

• The name of the Social Commerce EAR is WC_soccom.

• Verify the ownership of the UPDI_installdir and its subdirectories is wasuser_ID:wasgroup_ID, where wasuser_ID and wasgroup_ID is the wc_user and group ID that were created before installing WebSphere Commerce. If the ownership is not correct, change the, run the following command:

  chown -R wasuser_ID:wasgroup_ID UPDIDIR
  

• Ensure you are logged in as the non-root user

• Ensure that you are logged in with a Windows user ID that is a member of the Administrator group.

When the script is used for uninstalling a fix, Update Installer is able to uninstall the last installed fix if the UninstallPackageName parameter in the updateEAR.properties file is not specified. If the parameter is specified, Update Installer will try to uninstall that specific fix.

Procedure

1. Edit the WC_INSTALL/config/deployment/xml/updateEAR.properties and set appropriate values for the environment:

   UPDIDIR

   The directory where Websphere Commerce Update Installer is installed. This is a required parameter.

   For example:

   UPDIDIR=C:/Program Files/IBM/WebSphere/UpdateInstaller_Commerce
   

   UninstallPackageName

   The package name to be uninstalled. This property is optional. If the script is used to uninstall, this property indicates the package name that Websphere Commerce Update Installer uses to uninstall, If this is empty, Websphere Commerce Update Installer tries to uninstall the last fix that was installed. The default value is empty.

   For example:

   UninstallPackageName=7.0.0.0-WS-WCServer-IFJR25955.pak
   

   SkipRegenSDO

   In some unexpected situations, the automatic regeneration of your customized SDOs can fail during the EAR update. If you intend to manually regenerate and deploy the SDO after the EAR is updated, you can skip the automatic regeneration of the customized SDO by setting the skipRegenSDO parameter to true. The default value for this parameter is false.

   UpdateDB

   For Fix Packs, in order to update the database along with the fix package, set this property to true. You can manually run the updatedb script later if this property is set to false. If this property is empty, an error is displayed and the script stops.

   For APARs, set this value to false. For example:

   UpdateDB=false
   

2. Start the Social Commerce application server.

3. To install fixes on the Social Commerce EAR:

   WC_INSTALL/bin/config_ant -buildfile "../config/deployment/xml/updateEAR.xml" -DinstanceName=instance updateSocialCommerceEAR
   

4. To uninstall fixes from the Social Commerce EAR:

   WC_INSTALL/bin/config_ant -buildfile "../config/deployment/xml/updateEAR.xml" -DinstanceName=instance -Duninstall=true updateSocialCommerceEAR
   

+

Search Tips   |   Advanced Search