Updating the instance silently
After installing the WebSphere Commerce fix pack, use the silent method to update any existing instances to the same fix pack level.
Before you begin
- If you have both a staging and a production environment, you must perform the steps
that are outlined in Step 5
of Installing WebSphere Commerce fix packs to ensure that the following actions are completed:
- The environments are synchronized.
- You made note of the latest STAGLOG record.
- All other activities on the staging server are stopped before the fix pack is installed and the instance is updated.
Procedure
- Ensure that you are logged in with a user ID that is a member of the Windows Administration group.
-
Log on.
- Log on as the
root
user- If you are already signed onto the system, issue the command su - root. Do not use the command su root. This command does not load the necessary root user's profile and environment.
- Or log on as a
non-root
user that owns WC_installdir.
Note:- Ensure that the file size limit is set to unlimited. To check the current limit, type the
following in a command window: ulimit -a
If the value returned for the file size is not set to unlimited, change the limit by running the following command: ulimit -f unlimited
- Ensure that you increase the default limit of the open files parameter. Change the limit by running the following command: ulimit -n 8192
- Log on as the
- Ensure that your user has *SECOFR authority.
- Ensure that your database server is started.
-
Ensure that the WebSphere Commerceadministrative
server is started.
For example:
- If WebSphere Commerce is managed by WebSphere Application Server Deployment Manager (dmgr), start the deployment manager and all node agents. Your cluster can also be started.
- If WebSphere Commerce is not managed by WebSphere Application Server Deployment Manager (dmgr), start the WebSphere Application Server server1.
Note: During the application of maintenance to the WebSphere Commerce instance, the Update Installer stops the WebSphere Commerce application automatically. - Navigate to the UPDI_installdir/responsefiles directory
and open the install.txt file in a text editor.
Note: By default, lines with which you must provide information, start with a hashtag (
#
) character, such as:
The hashtag comments out the line. Be sure to remove the hashtags on any lines you change to ensure that they are no longer commented out.#-W update.instancename="instance_name"
Edit the following lines:
- Update the
-W maintenance.package
entry with the directory name that contains the maintenance package. - Update the
-W product.location
entry with the location of the WebSphere Commerce installation directory. - Complete one of the following steps:
- If you are updating a WebSphere Commerce instance, add the
following lines to the end of the
install.txt
file:-W update.instancename="instance_name" -W update.db="true"
-W update.exportearTimeout=interval
Note:- If you set
-W update.db="false"
, you must update the database manually. See Installing final steps. - update.exportearTimeout:
Optional: The maximum amount of allowable time (in minutes) for the export EAR process, which is exporting the WebSphere Commerce Application, to complete. If the export EAR process takes more than interval minutes, then a timeout error occurs. By default, the interval is set to 240 (minutes) but can be changed to suit your system needs. For example, -W update.exportearTimeout=360 allows for 360 minutes.
- If you set
- If you have a WebSphere Commerce Payments instance where
WebSphere Application Server security
is not enabled, add the following line to the end of the
install.txt
file:-W update.instancename="payments_instance_name"
- If you have a WebSphere Commerce Payments instance with
WebSphere Application Server security
enabled, add the following lines to the end of the install.txt file:
-W update.instancename="payments_instance_name" -W update.wassecurityenable="true" -W update.wasuserid="WAS_user" -W update.wasuserpassword="WAS_password"
Where WAS_user is a user that is defined in the user registry and WAS_password is the associated password for the user.
- If you are updating a WebSphere Commerce instance, add the
following lines to the end of the
- Update the
- Start a Qshell session by typing QSH at the command prompt.
- Run one of the following commands from the UPDI_installdir directory:
- ./update.sh -options UPDI_installdir/responsefiles/install.txt -silent
- update -options UPDI_installdir/responsefiles/install.txt
- update.bat -options UPDI_installdir/responsefiles/install.txt -silent
When the prompt returns wait for the Java process that is associated with the Update Installer to finish.
If you specified
-W update.db="true"
, the database update might take some time to complete. Check the updatedb-instance_name.log file and refer to Troubleshooting: Update Installer warning message during database update. -
Check the log files for errors. The log files are in the following directories:
- WC_installdir/logs/update
- WC_installdir/logs/update/actions/install
- Complete one of the following steps:
- If you have a WebSphere Commerce instance, restart the WebSphere Commerce application.
- If you have a WebSphere Commerce Payments instance with no security enabled, restart the WebSphere Commerce Payments application.
- If you have a WebSphere Commerce Payments instance
with security enabled, complete the following steps:
- Log in as the non-root user.
- Navigate to directory WC_installdir/payments/bin.
- Run the following command:
- ./IBMPayServer payments_instance_name payment_password
- IBMPayServer payments_instance_name payment_password
-
Check the WC_profiledir/logs/server1/SystemOut.log file
to ensure that the database version is at the same level as the EAR version.
For example, search for a message similar to the following message:
Where X is the level of fix pack installed.0000000a SystemOut O WC.SERVER: Enterprise 7.0.0.X / Database: ENT 7.0.0.X
This message indicates that the EAR version and database version are the same version. The levels are retrieved from:- EAR: WC_profiledir/installedApps/cell_name/WC_instance_name.ear/properties/version/COMMERCE.product
- Database:
SITE
Table
If the versions are not the same, contact IBM Support.
-
If you have both a staging and a production environment, you must perform the steps that are
outlined in Step 5 of Installing WebSphere Commerce fix packs to ensure that the following actions are completed:
- All the STAGLOG records inserted during fix pack installation and instance update are deleted from the staging database.
- If Access Control Policy is in a staging environment, run the stagingcopy utility.
If you encounter problems with stagingcopy, complete the following steps:- Update the STMTHEAP database configuration parameter for both staging and production server
databases, db, to a higher value. For example:
db2 update database configuration for db using stmtheap 240000
- Similarly, update the APPLHEAPSZ database configuration parameter for both staging and
production server databases, db, to a higher value. For example:
db2 update database configuration for db using applheapsz 3000
- Disconnect all users from both staging and production server databases.
- Run the stagingcopy utility.