Skip to main content

Software  >  Lotus  >  

General install instructions for Domino Web Access (iNotes) Cumulative Hotfix

 Product documentation
 
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.
Hide details for Example of zip file contentsExample 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 A
DATA DIRECTORY FILES
NOTE 1: These files are not identified using the correct case sensitivity, Please use the case of the file you are replacing as a guide for installation.
NOTE 2: If there are files mentioned below that are not included in the zip file, then there was no change to those files and those files do not need to be replaced
NOTE 3: If there are files not mentioned below that are included in the zip file, then they must be installed as indicated in the instructions for the specific fix (example, inclusion of cpp directory)
NOTE 4: The server and the Client files MUST be installed together for the hotfixes to run normally.
Server PlatformLocationFiles that may be present
ALL PLATFORMS:
Windows
Linux
AIX
Solaris
iSeries/os400
zSeries/zLinux,z/OS
Windows:
<Domino data directory>\domino\html
UNIX:
<Domino data directory>/domino/html
iNotes6.cab
dwa*.cab
iNotes6w.cab
dwa*w.cab
inres6_en.dll
dwagss.jar
ALL PLATFORMS:
Windows
Linux
AIX
Solaris
iSeries/os400
zSeries/zLinux,z/OS
Windows:
<Domino data directory>\iNotes
UNIX:
<Domino data directory>/iNotes
Forms*.nsf
DOLS
ALL PLATFORMS:
Windows
Linux
AIX
Solaris
iSeries/os400
zSeries/zLinux,z/OS
Windows:
<Domino data directory>\domino\html\Download\Filesets
UNIX:
<Domino data directory>/domino/html/Download/Filesets



NOTE: Please see the Dols Section below for install instructions.
n_shimmer*_en.exe
n_shimmer*_en.inf
n_dolbase.exe
n_dolbase.inf
ALL PLATFORMS:
Windows
Linux
AIX
Solaris
iSeries/os400
zSeries/zLinux,z/OS
<Domino data directory>

dictionary files may be included
*.dic



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 PlatformLocationFiles
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.
ALLBefore 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.
WindowsWhen 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.


platformfile
windowsndomws.dll
ndomws.sym
ndwsaddin.exe
ndwsaddin.sym
linuxdwsaddin
libdomws.so
soldwsaddin
libdomws.so
aixdwsaddin
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.
 
Related information
Fix Central
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Messaging ApplicationsLotus iNotesGeneral
Messaging ApplicationsLotus DominoGeneralAIX, i5/OS, Linux zSeries, Solaris, z/OS
 
 

Copyright and trademark information
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.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 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

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.