Maintenance Pack NB_JAV_51_5_M.tar provides an update to Veritas NetBackup (tm) Enterprise Server / Server 5.1 Java on UNIX platforms.

Article:TECH47556  |  Created: 2006-01-24  |  Updated: 2006-01-25  |  Article URL http://www.symantec.com/docs/TECH47556
Article Type
Technical Solution


Environment

Issue



Maintenance Pack NB_JAV_51_5_M.tar provides an update to Veritas NetBackup (tm) Enterprise Server / Server 5.1 Java on UNIX platforms.

Solution



JAV 5.1GA Pack NB_JAV_51_5_M README April 25, 2006
Deleted: usr/openv/java/nbjP.jar
================================================================================
This Maintenance Pack provides an update to Veritas NetBackup (tm) Java.

================================================================================


=================
PACK DEPENDENCIES
=================

-- Installation of this Maintenance Pack requires version 1.19.4.29 of
the Vrts_pack.install.

-- The UNIX client maintenance pack, NB_CLT_51_5_M, should be installed
prior to installing this maintenance pack.


I. DOWNLOAD INSTRUCTIONS
II. INSTALLATION INSTRUCTIONS
III. UNINSTALL INSTRUCTIONS
IV. DESCRIPTION OF PROBLEMS FIXED
Current Pack
NB_JAV_51_5_M

Pack History
NB_JAV_51_4_M
NB_JAV_51_3_M
NB_JAV_51_2_M
NB_JAV_51_1_M
==========================
I. DOWNLOAD INSTRUCTIONS
==========================
1) Download NB_JAV_51_5_M_<6 digit number>.tar into the /tmp directory.

where <6 digit number> is an internal tracking identifier

2) Extract NB_JAV_51_5_M_<6 digit number>.tar
/bin/tar -xvf NB_JAV_51_5_M_<6 digit number>.tar

This will create the files:
Vrts_pack.install
VrtsNB_JAV_51_5_M.postinstall
VrtsNB_JAV_51_5_M.postuninstall
VrtsNB_JAV_51_5_M.README
VrtsNB_JAV_51_5_M.tar.Z


==============================
II. INSTALLATION INSTRUCTIONS
==============================

NOTE: Click on the "Download Now" link, near the bottom of this document
prior to running either of the following installation procedures for
this pack.

For LOCAL installs:

As root ONLY on Solaris, HP-UX, Linux, Alpha or RS6000 NetBackup
Master/Media/Client machine:

1) Install Maintenance Pack binaries.

cd /tmp
/bin/sh Vrts_pack.install

Note: The subject matter on the second line of this README with
the keyword "Deleted" causes Vrts_pack.install
to delete a file if it exists. It is used exclusively by the
Vrts_pack.install script for install purposes
only and requires no actions from the user.

For REMOTE installs:

As root ONLY on Solaris, HP-UX, Linux, Alpha or RS6000 NetBackup Master Servers:

1) Install Maintenance Pack binaries.

cd /tmp
/bin/sh Vrts_pack.install

2) Update any NetBackup clients that use the NetBackup Java applications.

/usr/openv/netbackup/bin/update_clients


============================
III. UNINSTALL INSTRUCTIONS
============================
Note: This will ONLY uninstall the Maintenance Pack from your local machine.

As root:

1) Close the NetBackup user interfaces.

Make sure the NetBackup server has no active jobs running (for
example, backups, restores, or duplications).

If a database agent is being used, such as Oracle,
ensure that the database services are stopped.

2) Change directory to the patch save directory.
Substitute the pack name for ${PACK} in the following command:

cd /usr/openv/pack/${PACK}/save

3) Run the un-install script:

./Vrts_pack.uninstall

4) Verify that the pack uninstalled successfully by checking
/usr/openv/pack/pack.history.

5) If update_clients was run after the pack was originally INSTALLED,
and pack is successfully UNINSTALLED.
run update_clients

6) If necessary, restart the NetBackup and Media Manager daemons:
/usr/openv/netbackup/bin/goodies/netbackup start


==================================
IV. DESCRIPTION OF PROBLEMS FIXED
==================================
The following are descriptions of the problems fixed. Please read the entire
document before installing.

README Conventions:

Description
Describes a particular problem contained in this pack.

** Description **
Describes a problem that can lead to potential data loss. Please
read these problem descriptions carefully.

Workaround
Any available workarounds to a problem are also listed. Workarounds
can be used INSTEAD of applying the patch, however, Symantec strongly
recommends the "best practice" of being at the latest patch level.

Additional Notes
Any additional information regarding a problem or feature is included.


=============
Current pack
=============

================================================================================
Etrack Incident = ET497277

Description:
A status 507 no longer occurs when attempting to log in to some accounts
using the Windows Java user interface.

Additional Notes:
On Windows, ensure that either the master or the user server can create the
termination event. The prior behavior assumed that the master would always
have a CreateEvent() before the user server OpenEvent(). This was a bad
assumption. If both CreateEvent(), then the second attempt behaves as if
it was an OpenEvent(), thus avoiding the race condition. (The user server
will not continue without a valid termination event.)
--------------------------------------------------------------------------------
Etrack Incident = ET492389

Description:
A change was made to the Java user interface under the Device Monitor that
enables a user to set cleaning frequency using the interface.
--------------------------------------------------------------------------------
Etrack Incident = ET398772

Description:
The NetBackup-Java Administration Console displayed the "Windows Open File
Backup" tab after selecting "Client Attributes" node in Host Properties
for NetBackup 4.5FP3 and 4.5 hosts. For pre-NetBackup 5.0 hosts, you
will not see this tab, because it remains hidden.
================================================================================

=============
Pack History
=============

NB_JAV_51_4_M
=============
================================================================================
Etrack Incident = ET293620

Description:
Previously, when you tried to resize the Global Attributes page of the
Master Server's Host Properties, the page contents turned into gibberish.
Now it does not clutter, even if you resize it to a smaller and smaller
size, the contents do not overlap.
--------------------------------------------------------------------------------
Etrack Incident = ET406959

Description:
On a Windows platform (clustered configuration) using the NetBackup-Java
Administration Console, a user could not use Vault Management.
--------------------------------------------------------------------------------
Etrack Incident = ET423661

Description:
Changes were made to eliminate the possibility of someone executing
commands as root using the bpjava. Both the interface and bpjava
were changed to support this new capability.
================================================================================

=============
NB_JAV_51_3_M
=============
Etrack Incident = ET289073

Description:
The Java GUI cannot restore from a FlashBackup-Windows policy, with a
Restore Type of "Raw Partition Backups". When the appropriate PC node is
selected in the "Directory Structure" pane on the left, the Contents pane
on the right does not show the raw partition for restore. It normally
should show the raw partition as a single file whose name is of the form
\\.\G:, where G is the drive letter of the raw partition.

Workaround:
To avoid this issue, use the NetBackup Windows Administration Console.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET288822

Description:
Cannot select "Raw Partition Backups" as a Restore Type when logged into a
client's "Backup, Archive and Restore" GUI. On the "Restore Files" tab,
the Restore Type drop-down list does not include "Raw Partition Backups"
even though the login user is authorized to perform raw partition restores.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET294502

Description:
Could not restore the image of an entire drive (for example, C:\) to an
alternate location on a Windows client. Although the option "Restore
everything to a different location (maintain existing structure)" is
selected on the General tab of the "Restore Marked Files" dialog, and a
different destination is specified, NetBackup still restores the image to
its original location. This problem also occurs when attempting to restore
files from different drives.

Workaround:
The following work-around applies to the restore of a single drive. If you
wish to restore several drives, then perform the restore operation
multiple times, once for each drive.

1) From the Restore tab, do not choose the entire drive (e.g. C:\) by
placing a checkmark in front of the drive. Instead, expand the drive and
select all of its subfolders. This will cause a slash to appear in front
the of drive (instead of a checkmark).

2) Click the Restore button and the "Restore Marked Files" dialog will
appear. Choose the option "Restore everything to a different location
(maintaining existing structure)" and specify an alternate destination.

(All NetBackup Java GUI capable NetBackup Servers and Clients)



=============
NB_JAV_51_2_M
=============

Etrack Incident = ET216492

Description:
The NetBackup-Java device monitor will not display information if a media
server is down.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET212881 ET212885

Description:
Using the NetBackup-Java GUI, the user tries to configure a shared
drive on an ACS robot. The ACS Drive ID numbers are cleared to all zeros.
If another drive already exist that is configured with zeros for each of
the ACS Drive IDs, the user would see the following error:

"Configure shared drive operation on host XXX failed:
Robot drive number in use for this robot."

Workaround:
To avoid this issue, you can use the command line.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET207419

Description:
When creating or updating a disk storage unit using the NetBackup-Java GUI,
and the path ends with a backslash, it may be corrupted when saved.

Workaround:
To avoid this issue, do not specify a storage unit path with a backslash
as the last character.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET261005

Description:
When the NetBackup-Java GUI connects to a server, a process is started on
the server called bpjava-susvc. A normal user with access to this server
could send specially crafted commands to this process and have those
commands executed with root authority.

This fix is dependent on the NetBackup UNIX client patch(NB_CLT_51_2_M).
The NetBackup client patch for all UNIX platforms must be installed on all
NetBackup server and client UNIX hosts that you will be administering
(specifying in the login dialog) using the NetBackup-Java GUIs.

Workaround:
Currently, a work-around is available to circumvent this exploit by
requiring bpjava-susvc to use the no call-back feature. To enable this
feature, the NBJAVA_CONNECT_OPTION parameter must be set to 1 on the
machine where the NetBackup-Java GUI is started. This parameter is
located on UNIX platforms in /usr/openv/java/nbj.conf and on Windows
platforms in <NB Installed location>\java\<host_name>.vrtsnbuj.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET267209

Description:
With Enhanced Authentication/Authorization configured, the NetBackup-Java
administration console's Capabilities Authorization was not being honored.
One could not restrict access to certain components, such as, Policy
Management, in the console by configuring the console's auth.conf file.
This is a regression compared with the NetBackup 3.4 release.

Additional Notes:
A new NetBackup-Java GUI configuration option was implemented to facilitate
this fix - USE_NBJAUTH_WITH_ENHAUTH. The default for this is 0, meaning do
NOT use NetBackup-Java Capabilities Authorization with NetBackup Enhanced
Authorization. When set to one, both authorization methods are used. This
means that the general authorization configured with Enhanced
Authentication/Authorization can be further restricted in the NetBackup
Java console via the console's Capabilities Authorization.

On UNIX hosts, edit file nbj.conf in /usr/openv/java. On Windows hosts (if
you installed the NetBackup-Java GUI), the file is any of
<hostname>.vrtsnbuj files in <nb_install_path>\java, such as,
C:\Program Files\Veritas\java or the java folder of the installation path
you specified during the install.

On Windows hosts, it is set using a 'set' command in the .vrtsnbuj files.
You should see the pattern/other nbj.conf options when editing it.

On UNIX hosts in the nbj.conf file it is configured just as the others
in the file are configured.

This fix has no effect on use of NetBackup Access Control, for example,
when configured it takes precedence over both the Enhanced Authorization
and the NetBackup-Java Capabilities Authorization methods.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET160637

Description:
Vault's Non-vaulted Images Report in the Reports Application did not have
a way by which the user could specify a date range for the report.

Workaround:
To avoid this issue, run the Vault Non-vaulted Images Report through the
command line.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET269450

Description:
Could not list the contents of an Allen File System (AFS) backup image in
the "Restore Files" tab of the "Backup, Archive, and Restore" (BAR) pane.

Workaround:
To avoid this issue, do the following from the BAR pane:

1) Select the menu item Actions > Search Backups, or click on the Find
button.

2) Specify a file, then click Search. The list of files is then shown, and
you can browse for the restore.

Additional Notes:
After changing the Policy Type to AFS, and selecting an AFS image to view,
may need to press the Refresh button to see the AFS contents.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET275536

Description:
Vault Reports in the NetBackup-Java GUI were failing when run on Linux.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
================================================================================




=============
NB_JAV_51_1_M
=============
Etrack Incident = ET179592

Description:
Unable to create authorized users when the "Domain/Group" field contains
"/" or "\" characters in NetBackup Administration Console -> Host
Properties -> Authorization Properties. The NetBackup 5.0 Administration
Console (Java Console) returns the following message:

"The Group/Domain field contains invalid characters"

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET179529

Description:
The Cancel button on the Change/New Vault dialog does not work after
getting an error "Vault names must be unique across all vault robots...".

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET218116

Description:
This code is required for when multiple versions of the NetBackup-Java GUIs
are installed in NetBackup 6.0. It will allow for passing into the GUI a
user provided default host name for the login dialog. It is totally benign
and not used in this patch release. It just prerequisite code for
NetBackup 6.0.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
--------------------------------------------------------------------------------
Etrack Incident = ET179320

Description:
The Oracle restore browse GUI displays incorrect data in the right side
window pane. This is due to a Java exception caused when prior table
selection is retained incorrectly during a table model switch.

(All NetBackup Java GUI capable NetBackup Servers and Clients)
================================================================================


Attachments

NB_JAV_51_5_M_283112.tar (40.2 MBytes)


Legacy ID



283112


Article URL http://www.symantec.com/docs/TECH47556


Terms of use for this information are found in Legal Notices