11.18 Upgrading iPrint on a Cluster Does Not Upgrade the iPrint Clients

IMPORTANT:This issue applies only if you have configured iPrint to store its configuration on a shared NSS volume in a cluster.

NOTE:The upgrade issue is also seen on Mac operating systems. The iPrint client download from the IPP page fails because the Install IPP client link on the IPP page does not work.

On servers that store their iPrint configuration on an NSS volume, the iPrint configuration folder (/var/opt/novell/iprint/htdocs) at the root of the file system is actually a symbolic link to the NSS volume.

During a cluster upgrade to OES 11 SP2, the connection between the server being upgraded and the shared NSS volume is taken down, making the symbolic link invalid. When the upgrade process determines that the symbolic link is invalid, it overwrites the symbolic link with an actual folder on the system disk, so that when the server comes back up, the NSS volume is inaccessible. The files it contains have not been upgraded.

OES 11 SP2 restores the symbolic link to the shared NSS volume, but it doesn’t update the iPrint files. Therefore, you must manually copy the files to the shared NSS volume, while at the same time preserving the configuration settings in the iprint.ini file located there.

To address this issue, bring up the shared NSS volume where the iPrint configuration files are stored and do the following:

  1. On the upgraded server’s file system, check to make sure that the /var/opt/novell/iprint/htdocs symbolic link is provinding access to the shared NSS volume.

  2. Make a backup copy of the iprint.ini file that is located in the /var/opt/novell/iprint/htdocs folder. You use this to restore the original iprint.ini file in Step 5.

  3. (Conditional) If you are upgrading an OES 2 FCS server and you use the automatic client update feature, do the following:

    1. Open the backup copy of the iprint.ini file in a text editor.

    2. Locate the following lines:

      NovellWinVersion = 432 ;This is set by Novell, Inc.NovellWinVer2K = 432NovellWinVerXP = 432

    3. Change the version number for each client type from 432 to 438 as follows:

      NovellWinVersion = 438 ;This is set by Novell, Inc.NovellWinVer2K = 438NovellWinVerXP = 438

    4. Save the file.

  4. Copy the contents of the /var/opt/novell/iprint_client/htdocs folder to the /var/opt/novell/iprint/htdocs folder by using the following command: cp /var/opt/novell/iprint_client/htdocs/* /var/opt/novell/iprint/htdocs/ -rf

    IMPORTANT:Do not delete the contents of the /var/opt/novell/iprint/htdocs folder. Only overwrite the folder contents. The /var/opt/novell/iprint/htdocs/ folder contains additional files not found in the /var/opt/novell/iprint_client/htdocs/ folder.

  5. Replace the iprint.ini file in the /var/opt/novell/iprint/htdocs folder with the backup copy that you created in Step 3, and if applicable, modified in Step 4.

For information on upgrading iPrint on a cluster, see TID #7007954 on the Novell Support Site.