Novell Nterprise Branch Office 2.0.5 Readme

September 15, 2008

Novell® Nterprise™ Branch Office™ 2.0.5 ISO is available to customers who have Upgrade Procetion and is available on the Customer Care Portal to entitled customers after you log in. If you already have deployed Nterprise Branch Office (NBO), you can update your installation using the NetWare 6.5 Support Pack.

This document includes the following information about known issues related to NBO 2.0.software.

For best results, use the following Web browsers:

1.0 Installation Issues

1.1 On upgrading NBO to the NetWare 6.5 SP7 or SP8 Servers, do not use the image command

If you have upgraded NBO to the NetWare 6.5 SP7 or SP8 server, the ISO generated by the image command may not be bootable when installed. You can boot the server using a DOS boot disk, then execute autoexec.bat file.

Instead, use the image command on the SP6 server, then upgrade the server to SP7 or SP8.

1.2 Imaging

Make sure you remove any CDs in the appliance before beginning the imaging process (image command).

1.3 Ensure your ISO Is Valid

Occasionally, a bad CD burn results in miscellaneous installation failures. These issues are seen even when the ISO from the download site is validated and the MD5 values are correct. Sometimes the burn hardware / environment causes corruption in some cases. After burning the NBO 2.0.5 ISO to CD, check the MD5 values of the following files.

Table 1 File MD5 Values

File Name

MD5 Value

nbo_img.z

e8c8a711106331191e39f16a248b4186

sys_img.z

2c6c3b649b7cc64cbbf66b067a89daa0

\boot\boma_cd.img

f698e72635a4be84435b52de9f9741f9

1.4 Network Installation

Make sure all CDs are removed from NBO appliance during network installations of NetWare® 6.5 Support Pack 5 or upgrade to NBO 2.0.5.

1.5 Newer Files Included on ISO than NetWare 6.5 Support Pack 5

The following updates are included on the NBO ISO that were not included in NetWare 6.5 Support Pack 5:

  • server.exe – fix out of memory issues during installation

  • nwpa.nlm – fix to allow some newer hardware to install NBO

  • rsync.nlm – latest December 22, 2005 contains fixes for customer issues.

  • fatfs.nlm – Additional fixes for some SCSI configurations.

  • Script changes – Additional script changes to make IMAGE command worked from a locked NBO console and other Install from NBO CD script fixes.

1.6 Delete Previous Support Pack Backups

Before installing the NetWare 6.5 Support Pack on a NBO server, delete any previous backups on c:\nwserver\backspx, where x can be 2 to 4. This prevents the server from running out of disk space on the c: drive during the Support Pack installation, which could cause an abend.

1.7 Do Not Use the Preserve Option When Upgrading to Support Pack 5

If you are upgrading a Branch Office 2.0 appliance using Support Pack 5, do not use the Preserve option or you will lose data.Instead, use the new Support Pack Upgrade feature. Refer to TID number 10088340 where a link is provided to instructions on how to install this feature for use in installing support packs.For more information about this new feature, see “Applying NetWare Support Pack Updates” in the Nterprise Branch Office Setup Guide.

Do not use the Preserve as an upgrade process. Preserve is intended as a method of backing up, and is not supported as a means to install the patch. If you have already used the Preserve feature to install the patch, follow these steps to properly install the patch on your systems:

  1. Acquire the files config.txt, lsmldapx.nlm.lmo, and lcmldapx.nlm.lmo from the NetWare 6.5 Support Pack 5 in \products\nbo\nbo.zip.

  2. At the NBO conole, unlock the NBO by entering unlock, and then entering y to accept the terms and conditions.

  3. Save the files into your sys:\nmas directory.

  4. To install, run the script: nmasint -addmethod -boma sys:\nmas\config.txt

  5. On NBO console, type restart.

1.8 Update/INSTALLATION via GUI

The process of copying sp5.zip to the appliance via the Nterprise Branch Office Web Administrator is slow (JVM issue). To more quickly install the Support Pack via the Web Administrator and you don't want to unlock the NBO console to run NWConfig for the upgrade, copy sp5.zip to the data:\softchip directory on the appliance first and unzip the sp5.zip file in that directory before running the Upgrade option in the Web Administrator.

1.9 Vendor Partitions

NBO removes all partitions during imaging/installation even vendor specific partitions on the drive because NBO requires four partitions.

2.0 Replication Issues

2.1 Older Mac Files with Resource Forks

Rsync does not support replicating older Mac files or applications that have resource forks. When Rsync attempts to replicate these files, you receive error -23. If you have an environment where backing up these files is a requirement, you need to use the SMS features of NBO or use a local backup of Rsync.

NOTE:The newer Mac OSX has moved away from using these resource forks, but still supports resource forks.

2.2 -10 Error Messages

If you get a -10 error, refer to the volume:\system\rsync.log file for additional information. -10 errors are usually caused by invalid configuration of Rsync. Here are some common reasons for this error:

  • Replace volume with the actual volume name where you installed Rsync.

  • Mutual authentication or certificates aren't set up properly.

  • SSL on both corporate and NBO servers or NON-SSL on both corporate and NBO servers (they can't be different).

2.3 Mutual Authentication when NBO and Corporate are on Different networks

You might see one of the following symptoms after attempting mutual authentication:

  • Web Administrator hangs

  • The following error appears:

    Replication Authentication error.
    If authentication failures persist, it may be because of stressed WAN conditions. Use Manual authentication instead.
    

Your NBO and corporate servers are probably on different networks, NBO requires an NDS replica on the corporate server for mutual authentication to function; otherwise, you should use manual authentication as the error message indicates.

2.4 User Objects Lost During Upgrade in Non-Rsync Environments

By default, eDirectory data is backed up automatically once every 24 hours. If you make any directory changes and then perform an upgrade using the Preserve option before the backup process has been run again, you will lose those changes. This includes the creation or modification of user objects.

If you are going to perform a Support Pack upgrade, be sure that you either manually back up the directory before performing the upgrade, or that you perform the upgrade after the regularly scheduled directory backup, which by default is 6 p.m.

To back up the directory, run Rsync. Doing so places a current backup copy of eDirectory on the admin volume.For related information, refer to TID number 10088340.

2.5 NetWare to NetWare Rsync is not supported

Rsync is only supported in configurations where NBO communicates to a NetWare, Linux or Windows server.

3.0 Administration Issues

3.1 Auditing

Defaults in auditing don't report as much as the auditing in the previous version. Make the following changes to the NBO 2.0.5 auditing:

  1. Unlock the NBO console.

  2. At the system console, load audetext.nlm.

  3. Login as supervisor.appuser (tab between fields, don't press Enter until you have entered the password).

  4. Choose Add Schema Extensions.

  5. Exit the utility.

  6. Restart and unlock the NBO.

  7. Using iManager (with the Nsure audit plug-in), log in to NBO as supervisor.

  8. Go to eDirectory > Modify Object, and browse to the server object.

  9. Go to the Nsure Audit tab and enable the needed events.

    WARNING:Don't use the Select All option; otherwise; the network is flooded with audit traffic.

  10. In the NBO Web Administrator, enable Nsure Audit.

3.2 eDirectory 8.8 Support

If eDirectory 8.8 is on the corporate server side, eDirectory 8.8 functions fine with NBO 2.0.5. NBO is not designed to function with eDirectory 8.8 installed at the NBO office.

3.3 GroupWise 6.5

Groupwise 6.5 is the post office that is part of the base image installed on the NBO.

3.4 JVM and NBO Administration

The product has been designed to work with the Microsoft JVM. However the JVM is not available from Microsoft any more. You must have previously downloaded it. The Sun JVM 1.3x and 1.4x work with a few issues:

  • You might need to login twice,

  • You might not be able to tab between fields,

  • Screens may not draw out correctly.

Refresh your screen to resolve these or other problems with JVM.

The NBO Web Administrator does not function with any Sun JVM 1.5 or higher. This is a non-issue for the end users and affects only the administrator of the NBO.

3.5 Lan Setting Modifications

In the Web Administrator, certain NICs do not work and the appliance doesn't completely cycle.

To resolve this, unlock the console and finish the inputting the settings on the other console. Toggle back to the NBO console and type “lock” to relock the console.

3.6 Macintosh Clients

If you use the NBO 2.0.5 overlay to image a new appliance, Mac OS9 and OSx clients cannot login. To resolve this, you must image the appliance using the shipped NBO 2.0.0, and then update to 2.0.5 via the Web Administrator or NWConfig SP5 upgrade with the appliance unlocked.

3.7 NetStorage/NetIdentity

Logging in to NBO SP5 presents the standard login screen. You must browse to the NetStorage page to see the NetIdentity login screen.

3.8 Printing Issues

NBO only supports iPrint Windows clients.

3.9 Version Information

NBO 2.0.5 on the NBO console will have a 4th digit incriminated (such as NBO 2.0.5.1) each time you unlock the console. This can be used to monitor how many times the console has been unlocked.

3.10 Virtual Team Owners Cannot Add Web Links to their Virtual Team Pages

Virtual team owner accounts have to be configured to allow them to edit the link gadget. To resolve this issue, NBO supervisors must log in to the portal administrator and modify virtual team owner settings.

3.11 VMWare

NBO 2.0.5 installs on VMWARE ESX and GSX. There are no known issues.

4.0 Central Office Issues

4.1 Newer NetWare 6.5 Updates Included in NBO 2.0.5

The rsync.nlm dated December 22, 2005 are newer than the updates included in NetWare 6.5 Support Pack 5. You can update your NetWare server with these newer versions via installation from the nbo_appliance\central_office\netware\install.exe on the NBO 2.0.5 CD.

4.2 OES Linux

4.2.1 Linux OES Corporate server

SimplePassword NMAS™ Login Method is not installed by default on OES Linux servers. Without this method, users cannot authenticate to NBO via NCP™.You need to install the SimplePassword NMAS Login Method by executing the following command at the server’s terminal prompt:

console:nmastinst -addmethod <admin.context> <treename> /opt/novell/nmasmthd/SimplePassword/config.txt -w <password>

4.2.2 Central Office Setup

For more information on configuring Replication on NetWare, Linux, and Windows 2000/2003, refer to Novell Documentation.

5.0 Fixes in this Release

  • Improved Hardware Support: NBO 2.0.5 has newer drivers and fixes to address newer hardware platforms that previously were unable to install NBO (Symptom: Pausing for drivers, hangs or reboots during imaging process, etc.).

  • Rsync.nlm Improvement of replication with fewer error -10 and -30 timeout. rsync.nlm also includes additional customer fixes.

    NOTE:It is still possible to get error -10s in invalid setup configurations, incorrect hardware, and switch configuration issues.

  • Certificates when restoring: When restoring from floppy disk, you no longer need to reimport certificates.

  • Intruder lockout and home directories: Intruder lockout no longer renames user home directories.

  • iPrint pop up blocking resolved: The iPrint Client 4.15 or later resolves issues with pop up blocking when installing iPrint printers.

6.0 Documentation

The following sources provide information about Novell Nterprise Branch Office 2.0:

7.0 Documentation Conventions

In this documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path.

A trademark symbol (® , TM, etc.) denotes a Novell trademark; an asterisk (*) denotes a third-party trademark