IBM(R) WebSphere(R) Digital Media Enabler, Version 5.4 Release 2, Fix Pack
1 README
This README file contains the latest information about installing WebSphere Digital Media
Enabler (hereafter referred to as WDME), as well as information that was not available for our
printed publications.
Content
This file includes the following information:
1.0 Installing the fix pack
1.1 Uninstalling the fix pack
2.0 Known problems and
workarounds
2.1 Macintosh users
2.2 Disabling the
caches
3.0 Other sources of information
3.1 Documentation library
page
3.2 Support page
4.0 Updated files
5.0 Trademarks
If you customized version 5.4.2 of WDME, you must do the following:
- Install the fix pack as described below.
- Review the list of files which were updated by
the fix pack. This list corresponds to the files copied to the backup
directory. If you have customized any of these files you may have to manually
merge the files. More information about backed up files follows in "Uninstalling
the fix pack."
- Determine changes by running a difference of your backed up files against
the 5.4.2 version of WDME.
- Manually merge the backed up files that you have customized into the WDME store
directories.
- Test your implementation.
To install the fix pack, do the following:
- Ensure that the WebSphere Application Server is running. Ensure that the
e-mail, delivery, and upload daemons are stopped.
- Save the file WDME542_fixpak_1.zip to a temporary directory.
The zip file contains the following directories for file comparison:
- 5.4.2 - Contains unchanged files to be replaced by the fix pack.
- 5.4.2.1 - Contains the fix pack files.
- Extract and run the following file in the same directory where you
initially installed WDME:
- Windows - setup.exe
- AIX - install_AIX
- Solaris - install_SUN
Note that the installation wizard will contain defaults for the
fields below.
- In the Directory Name field, type the directory in which WDME
5.4.2 was installed. For example, install_dir\WebSphere\CommerceServer\WCDM
- Click Next.
- In the WAS hostname field, type the TCP/IP hostname of your WebSphere
Application Server node. Do not include the domain name.
- In the WAS port number field, type the port number used by
WebSphere Application Server. The default is typically:
- Windows - 900
- UNIX - 2222
- In the WAS install location, type the directory where
WebSphere Application Server was installed. For example, install_dir\WebSphere\AppServer
- Click Next.
- In the WC instance name field, type the name of your WebSphere
Commerce instance. This can be found in the directory install_dir\WebSphere\CommerceServer\instances
- In the WC install location field, type the directory in which
WebSphere Commerce was installed. For example, install_dir\WebSphere\CommerceServer
- Click Next.
- In the Store directory field, type the directory of the WDME store. For example, if the WDME store directory is located in
install_dir\WebSphere\AppServer\installedApps\WC_Enterprise_App_instance_name.ear\wcstores.war\store_name,
type store_name in this field.
- Click Next. The summary displays. Click Next again to
complete the installation.
- Click Finish to exit the installation.
- Restart the e-mail, delivery and upload daemons.
Note: If you have multiple stores, you must install the fix pack for each WDME store.
1.1 Uninstalling the fix pack
The fix pack installation backs up all the files that
it replaces. Files are backed up in the following directory:
/WDME_installdir/backup/store_directoryYYYYMMDDHHMMSS
where store_directoryYYYYMMDDHHMMSS is the store name and current timestamp.
The store_directoryYYYYMMDDHHMMSS directory corresponds to the WC_Enterprise_app_instance_name.ear
directory. The directory structure of the backed up files is maintained
such that you can remove the fix pack and restore your original files by doing the
following:
Windows
- cd WDME_installdir\backup\store_directoryYYYYMMDDHHMMSS
- uninstallfixpak.bat
UNIX
- cd WDME_installdir/backup/store_directoryYYYYMMDDHHMMSS
- uninstallfixpak.sh
Note that if you have installed the fix pack for multiple stores, you must
uninstall the fix pack for each WDME store.
The following are known problems and workarounds.
2.1 Macintosh users
Media Folder collaboration using SameTime is not supported using a browser in the Mac OS (R)
environment.
2.2 Disabling the caches
You must disable both WebSphere Commerce and
WebSphere Application Server caches to allow multiple users to view the
ProductDisplay (View CD) page. Before disabling
the cache, you must delete the class files in the hostname directory.
To delete the class files, do the following:
-
Windows NT
- In Windows Explorer, go to drive:\WebSphere\AppServer\temp\WebSphere_Commerce_Server_-instance_name\WebSphere_Commerce_Enterprise_-instance_name\wcstores.war\store_name
- Delete the all the files named *.class in this directory and its
subdirectories.
-
Windows 2000
- In Windows Explorer, go to drive:\Program_Files\WebSphere\AppServer\temp\WebSphere_Commerce_Server_-instance_name\WebSphere_Commerce_Enterprise_-instance_name\wcstores.war\store_name
- Delete the all the files named *.class in this directory and it's
subdirectories.
-
AIX
- In a terminal window, go to
/usr/WebSphere/AppServer/temp/WebSphere_Commerce_Server_-instance_name/WebSphere_Commerce_Enterprise_-instance_name/wcstores.war/store_name
- Delete the all the files named *.class in this directory and it's
subdirectories.
-
Solaris
- In a terminal window, go to
/opt/WebSphere/AppServer/temp/WebSphere_Commerce_Server_-instance_name/WebSphere_Commerce_Enterprise_-instance_name/wcstores.war/store_name
- Delete the all the files named *.class in this directory and it's
subdirectories.
To disable the WebSphere Commerce cache, do the following:
- Launch the Configuration Manager:
- Windows
- Ensure that the IBM WebSphere Commerce
Configuration Manager Server service has been started by
opening the Windows Services panel and selecting IBM WebSphere Commerce
Configuration Manager Server. If the service is stopped,
right-click the service and select Start.
- Go to Start>Programs>IBM WebSphere Commerce>Configuration.
- AIX
- su - wasuser
- cd /usr/WebSphere/CommerceServer/bin
- ./config_server.sh
- Wait for the following message: Registrycreated.CMServer bound in
registry.
- Open another terminal window.
- xhost +
- su - wasuser
- DISPLAY=:0.0; export DISPLAY
- cd /usr/WebSphere/CommerceServer/bin
- ./config_client.sh &
- Solaris
- su - wasuser
- cd /opt/WebSphere/CommerceServer/bin
- ./config_server.sh
- Wait for the following message: Registrycreated.CMServer bound in
registry.
- Open another terminal window.
- xhost +
- su - wasuser
- DISPLAY=:0.0; export DISPLAY
- cd /opt/WebSphere/CommerceServer/bin
- ./config_client.sh &
- Log in.
- Navigate to hostname>instance list>instancename>Caching
Subsystem and uncheck the Enable Cache checkbox.
- Click Apply.
- Close the Configuration Server.
- Restart the WebSphere Commerce Application Server.
To disable the WebSphere Application Server dynamic caching, do
the following:
- Start WebSphere Application Server.
- Launch the Administrator's Console by doing the following:
- Windows - Go to Start>Programs>IBM WebSphere >Application Server V4.0
AE >Administrator's Console.
- AIX - From the directory /usr/WebSphere/AppServer/bin, run
./adminclient.sh hostname port
- Solaris - From the directory /opt/WebSphere/AppServer/bin, run
./adminclient.sh hostname port
- In the navigation frame, go to WebSphere Administrative
Domain>Nodes>Instance Name (for example WC_demo)>Application
Servers>WebSphere Commerce Server--Instance Name.
- From the right frame, from the Services tab, click Web
Container Service.
- Click Edit Properties.
- In the Servlet Caching tab, ensure that the Enable Servlet
Caching checkbox is unchecked and click OK.
- Click Apply.
- Restart Commerce.
3.0 Other sources or information
The following are other sources or information for WDME.
3.1 Documentation library page
You can find the latest WDME documentation at the following Web
address:
http://www-3.ibm.com/software/genservers/commerce/wdme/library/tech-lib.html
3.2 Support page
You can find WDME product support including technotes, Redbooks and software
downloads at the following Web address:
http://www.ibm.com/software/genservers/commerce/wdme/support/
4.0 Updated files
The following are the files changed for this fix pack:
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/WEB-INF/classes/store_name/dmstoreconfig_en_US.properties
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/WEB-INF/classes/store_name/dmstoretext_en_US.properties
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/WEB-INF/classes/store_name/dmstoreconfig_es_ES.properties
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/WEB-INF/classes/store_name/dmstoretext_es_ES.properties
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/WEB-INF/classes/com/ibm/commerce/digitalmedia/search/commands/MediaSearch.class
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/WEB-INF/classes/com/ibm/commerce/digitalmedia/search/commands/MediaZip.class
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/DMOrderDisplayCompleted.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/DMSubscriptionCancelMain.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/edit_registration.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/imagecart.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/shipping.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/usagequestions.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/usagequestionsall.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMAdminMediaUpdate.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMJSPFunc.inc
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMLibraryManager.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMLibraryImageDetails.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMLibraryImageInfo.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMSearchDetail.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMSearchForms.inc
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMSearchPopUp.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMSearchResult.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/DMFolderEmail.jsp
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/lightbox/jsp/
DMJSFunc.inc
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/delivery/terms_en_US.htm
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/delivery/terms_es_ES.htm
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/delivery/delivery_es_ES.properties
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/email/mailprocess.properties
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/lib/DigitalMediaCommon.jar
- .../WebSphere/AppServer/installedApps/WC_Enterprise_App_instance_name.ear/wcstores.war/store_name/common/webobjects/locale/scripts/FormChek.js
The following terms are trademarks of the International Business Machines
Corporation in the United States, or other countries, or both:
- IBM
- Lotus Notes is a trademark of Lotus Development Corporation in the United
States, or other countries, or both.
- Microsoft, Windows, Windows NT, and the Windows logo are registered
trademarks of Microsoft Corporation.
- UNIX is a registered trademark in the United States and other countries
licensed exclusively through X/Open Company Limited.
- Other company, product, and service names may be trademarks or service marks
of others.
THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM
DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT
LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING
THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.
(C) Copyright IBM Corporation 2003. All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corp.