 |
General install instructions for Domino Web Access (iNotes) Cumulative Hotfix
|
| | | Abstract | | Install Instructions for a Domino Web Access Hotfix. | | | | | | | | Content | Since the Domino Web Access (DWA) hotfix is a cumulative hotfix from release to release, we ship all operating systems in the same zip file. The files that are platform specific will be found in the corresponding directories, for example: w32 files can be found in the directory w32. The files that are not platform dependent will be found in the root of the directory where the files where extracted.
For specific information regarding an individual cumulative fix, see the appropriate technote for that fix. Example of zip file contents Example of zip file contents DWAHF_v8.02_229.041.zip contains: 2/18/2009 01:56 PM <DIR> aix 2/18/2009 01:56 PM <DIR> aix64 0/16/2008 06:01 PM 2,569,884 aus.dic 0/20/2008 06:59 PM 903,099 dlt.jar 2/16/2008 04:27 PM 143,348 dwa8.cab 2/16/2008 04:21 PM 91,536 dwa8res_en.dll 2/16/2008 04:30 PM 143,614 dwa8W.cab 1/07/2009 02:07 PM 13,893,632 Forms8.nsf 2/18/2009 01:57 PM <DIR> linux 1/08/2009 10:36 AM 25,791,479 n_DOLBASE.exe 1/08/2009 10:35 AM 55 n_DOLBASE.inf 1/08/2009 10:34 AM 7,325,545 n_SHIMMER8_en.exe 1/08/2009 10:34 AM 55 n_SHIMMER8_en.inf 1/08/2009 01:56 PM 16,161 readme.txt 2/18/2009 01:57 PM <DIR> sol 0/16/2008 06:02 PM 2,494,811 uk.dic 0/16/2008 06:02 PM 2,459,779 us.dic 2/18/2009 01:58 PM <DIR> w32 0/16/2008 06:05 PM 2,459,779 wpdic.dic
TABLE A describes the data directory contents of a zip file.
TABLE B describes the program directory contents of a zip file.
TABLE C outlines the installation of the hotfix. TABLE B | SERVER FILES | NOTE 1. Install all the files from the hotfix directory corresponding to your platform. The directories for the server files are w32, aix, aix64(if applicable),sol, and linux. These directories will contain the corresponding libinotes* and other important files that need to be installed in your server binaries directory. An example of another file that may be including in this directory is libdolextn*. NOTE 2. If a cpp directory is included, see cpp instructions below. | | Server Platform | Location | Files | | Windows | <Domino program directory> | ninotes.dll
ninotes.sym | | Linux | <Domino program directory> | libinotes.so | | AIX | <Domino program directory> | libinotes_r.a | | Solaris | <Domino program directory> | libinotes.so | | iSeries/os400 | <Domino program directory> | not included in zip file;
provided by System i Support Team | | zSeries/zLinux,z/OS | <Domino program directory> | not included in zip file;
provided by System z Support Team |  |  |  | TABLE C | Installation |  | NOTE: The Domino data directory and Domino program directory will vary, depending on how the server was installed. | | ALL | Before installing the hotfix, backup the current domino files to be replaced, which includes those in the Domino program directory and those in the Domino data directory. This gives us the ability to revert to the prior configuration.
1. Shut down the Domino Server.
2. Using the chart above, backup the files (for Unix systems, see also the UNIX entry in this table for additional information). This can be done by renaming the files in place. However, all templates(*.ntf if one is present in the hotfix) and databases (Forms*.nsf) should be moved from their current location to another location before replacing the new files.
3. Copy the files from the zip file (hotfix location) and place them in the above locations. | | Windows | When you copy the ninotes.dll into your Domino program directory, you should also copy the new file ninotes.sym and place the file in the same location as the ninotes.dll. This file is used by nsd to collect information should the server have problems. You should repeat the same procedure for any files found in the w32 directory (ndolextn.dll, ndolextn.sym are two files you might find in this directory). | aix,
sol,
linux | The hotfix directories for the unix server files are aix, sol, and linux. These directories contain the platform specific libinotes* and other important files that need to be installed in your Domino program directory. You should install all the files from the appropriate platform hotfix directory. An example of another file that may be included in this directory is libdolextn*.
The files are not usually compressed. However, if they are compressed with the compress command, the file will have a ".Z" extension. To uncompress, use the following commands, depending on the platform:
uncompress libinotes.so.Z (sol, linux)
uncompress libinotes_r.a.Z (aix)
At the console, login as "root" as this will be needed to backup, and to set file permissions, group permissions and execution access.
Before starting the server up, make sure the permissions, owner, and group of files replaced by this hotfix match the backup files. You might need to adjust the settings using chmod, chown, and chgrp.
Example of use:
chmod 555 libinotes.so
chown root libinotes.so
chgrp notes libinotes.so | System i
System z | For OS/400, z/OS, zLinux:
For the Domino program directory, the equivalent of ninotes (e.g., libinotes.so) will be provided by the L3 development team, and should be installed as described in the other unix platforms above.
The Domino data directory files are also installed as per the instructions for the other platforms. | DOLS Instructions:
Dols files found in this hotfix need to be installed on all operating systems. The files' locations for all platforms is universal; however, operating systems directory structures vary. If you are installing a localized hotfix, the names of the n_shimmer6_**.inf will vary, but the install process is the same.
Backup and replacement is the same as for the other Domino data directory files.
Note: Any previously installed offline subscriptions should be reinstalled onto the clients' machines so that the Forms*.nsf files are the same for both offline and online copies. This is done by selecting "install subscription" menu item when clicking the black "Go Offline" while online Combo hotfixes (HTTP and DWA) or (Notes and DWA):
If you have a need to obtain a hotfix that installs some dwa files, like ninotes.dll or libinotes*.
In this case you would not replace the libinotes* or the ninotes* files, you would use the files that where provided by the install process. However seeing that the dwa hotfixes are cumulative and they can contain fixes that reside in both the forms*.nsf files and the ninotes files. You MUST make sure the hotfix you received is combined with the DWA hotfix. Make sure that the dwa hotfix was included with the hotfix request. CPP Instructions
NOTE: Not all DWA cumulative hotfix contain cpp fixes. If there is a directory in the zip file called cpp, you should install the files from the subdirectories that match your server's operating system.
First install the Cumulative Domino Web Access Hotfix . If there is a cpp hotfix included with this hotfix, you should follow the directions below to install.
To install the CPP fixes, replace the files on the Domino server. This process will require the server to be shutdown, backing up existing files and replacing the files. On Windows, add the sym files to the directories where the executable files reside (for nsd data collection purposes). Please see the chart below outlining the files. | platform | file | | windows | ndomws.dll
ndomws.sym
ndwsaddin.exe
ndwsaddin.sym | | linux | dwsaddin
libdomws.so | | sol | dwsaddin
libdomws.so | | aix | dwsaddin
libdomws_r.a |
NOTE: If any file mentioned above is not found in the zip file,there was no changes to that file.
To install the hotfix, do as was done for the other files:
Backup the current ones to be able to revert to the prior configuration if necessary.
Before starting the server up, make sure the permission's, owner, and group of files replaced by this hotfix match the backed up files. | | | | | | | | Cross Reference information | | Segment | Product | Component | Platform | Version | Edition | | Messaging Applications | Lotus iNotes | General | | | | | Messaging Applications | Lotus Domino | General | AIX, i5/OS, Linux zSeries, Solaris, z/OS | | |
| | |
 |
| IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml. |
 |
 |
 |
| Please take a moment to complete this form to help us better serve you. |
 |
 |
 |
|
|
|
 |
 |
| Product categories: |
 |
| | Software |  |
| | Messaging Applications |  |
| | Advanced Messaging |  |
| | Lotus Domino Web Access |  |
 |
| Operating system(s): |
| |
Linux, Windows
|
 |
| Software version: |
| |
8.0.2
|
 |
| Reference #: |
| |
7015198
|
 |
| IBM Group: |
| | Software Group |
 |
| Modified date: |
| | 2009-04-30 |
 |
|