University of Wisconsin Help Desk Knowledgebase

• Contact Us
• DoIT
• UW
• MyUW
• PEOPLE

Bucky Backup - Installing the Bucky Backup Client for Novell Netware

This document explains how to install and configure the Bucky Backup client for a Novell Netware server. If you already have the Bucky Backup client installed, then see the document Bucky Backup - Upgrading the Bucky Backup Client for Novell Netware for instructions on upgrading to the latest version of the Bucky Backup client.

The Bucky Backup client installation is comprised of the following steps:

• Bucky Backup Registration
• Preparing for the Bucky Backup Client Installation
• Installing the Bucky Backup Client
• Configuring the Bucky Backup Client

Bucky Backup Registration

In order to use the Bucky Backup service, you must register as a Bucky Backup user. During the registration process, you will create a unique node name for your computer and a password.

Preparing for the Bucky Backup Client Installation

1. Review the latest Readme file in the Bucky Backup client repository.
2. Confirm that your Netware server meets the Bucky Backup client environment prerequisites.
3. Check the list of known problems and limitations for the Bucky Backup client.

Installing the Bucky Backup Client

1. Download the latest version of the Bucky Backup client for Netware from the Bucky Backup client repository.
2. Create a tsmnw directory and move the downloaded executable into it.
3. Extract the client installation files into the tsmnw directory.
4. Move the tsmnw directory to the SYS volume of the Netware server.
5. Install the new Bucky Backup client by running nwconfig.nlm from the server console.
   1. Select Product Options->Install a product not listed
   2. Press <Esc> then <F3> to specify a path
   3. Enter the path to the installation directory SYS:tsmnw

• If you are installing the Bucky Backup client in a clustered environment, then follow the instructions in Appendix C. Installing and configuring the backup-archive client in a Novell Cluster Services (NCS) environment

Creating a Novell User Account for the Bucky Backup Client

The Bucky Backup client needs to login to eDirectory in order to perform backups and restores.

1. Create a Novell user account dedicated to the Bucky Backup client with a strong password.
2. Assign the user account supervisory object rights to the highest level container that it will backup.
   • In order to backup an entire Tree, the user account needs supervisory object rights to .[Root].
   • In order to backup a portion of a Tree, the user account needs supervisory object rights to the top of the OU.

Configuring the Bucky Backup Client

Before the Bucky Backup client can be used, communication, logging, processing, and scheduling options must be configured for the server.

1. Replace the sample dsm.smp client option file in the SYS:tivoli\tsm\client\ba directory with this dsm.smp file that has been customized for the Bucky Backup environment.
2. See IBM's creating and modifying the client options file documentation for an overview of the configuration process.
3. Copy the dsm.smp file to dsm.opt and customize the configuration for your server.

Configuring the Communication options

1. Check the Bucky Backup registration response email to find out which Bucky Backup server your node connects to.
2. Configure the Nodename, TCPPort and TCPServeraddress entries in the dsm.opt file for your node.

   Bucky Server	TCPServeraddress	TCPPort
   bucky1	buckybackup1.doit.wisc.edu	1499
   bucky2	buckybackup2.doit.wisc.edu	1500
   bucky3	buckybackup3.doit.wisc.edu	1501
   bucky4	buckybackup4.doit.wisc.edu	1502

3. See IBM's communication options documentation for more details.

Configuring Processing Options

1. Configure the domain option with the volumes that you want to backup.
   • If you choose to include NDS in the domain option, then configure the nwpwfile option to save the eDirectory credentials or be prompted for them at the start of each backup session.
2. Configure the resourceutilization option to define how many concurrent sessions the Bucky Backup server and client can use during processing.
3. Configure the passwordaccess option to determine if you want to save the Bucky Backup node password or be prompted for it at the start of each backup session.

Configuring Backup Logs

1. Configure the errorlogname and errorlogretention options to specify the name of the error log and how many days to maintain the error log before pruning it.
2. Configure the schedlogname and schedlogretention options to specify the name of the scheduler log and how many days to maintain the scheduler log before pruning it.

Creating an Include-Exclude List

1. Review IBM's include-exclude list documentation for an overview of excluding files or directories from backup.
2. Configure include and exclude options.
   • Alternatively, you can configure the inclexcl option in the dsm.opt file and store the include and exclude options in a separate config file.

Configuring the Client Scheduler

1. Review IBM's configuring the client scheduler documentation.
2. Select either the CAD-managed or traditional scheduler method.
   • If you select the CAD-managed scheduler:
     1. Configure the managedservices option for schedule in the dsm.opt file.
     2. If you elected to save the Bucky Backup client passwords with the nwpwfile and passwordaccess options in the dsm.opt file, then initialize the password files by running the commands:
        1. load dsmc.nlm query session
        2. load dsmc.nlm query tsa
        3. load dsmc.nlm query tsa nds
     3. Add the command "load sys:tivoli\tsm\client\ba\dsmcad.nlm" to the autoexec.ncf file to load the Bucky Backup client scheduler at system startup.
     4. Start the CAD-managed scheduler
        • load sys:tivoli\tsm\client\ba\dsmcad.nlm
   • If you select the traditional scheduler method:
     1. Configure the schedmode option for polling in the dsm.opt file.
     2. Configure the queryschedperiod option in the dsm.opt file.
     3. If you elected to save the Bucky Backup client passwords with the nwpwfile and passwordaccess options in the dsm.opt file, then initialize the password files by running the commands:
        1. load dsmc.nlm query session
        2. load dsmc.nlm query tsa
        3. load dsmc.nlm query tsa nds
     4. Add the command "load sys:tivoli\tsm\client\ba\dsmc.nlm schedule " to the autoexec.ncf file to launch the Bucky Backup client scheduler at system startup.
     5. Start the Bucky Backup client scheduler
        • load sys:tivoli\tsm\client\ba\dsmc.nlm schedule