home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1999 March / PCWK3A99.iso / Unixware / INFO / ARCSERVE / RELNOTES / RELNOTES.TXT < prev   
Encoding:
Text File  |  1998-08-19  |  57.2 KB  |  1,553 lines
  1. ----------------------------------------------------------------------------
  2.  
  3. SCO ARCserve/Open from Cheyenne
  4. Release and Installation Notes
  5.  
  6. Table of Contents
  7.  
  8. About this book
  9. Chapter 1: New features in SCO ARCserve/Open Release 2.2.0
  10. Chapter 2: Installing and removing SCO ARCserve/Open products
  11. Chapter 3: Configuring SCO ARCserve/Open
  12. Chapter 4: Getting started with SCO ARCserve/Open
  13. Chapter 5: Known limitations and workarounds
  14. Appendix A: Troubleshooting
  15.  
  16. Copyright
  17.  
  18. ----------------------------------------------------------------------------
  19.  
  20.  
  21. About this book
  22. ---------------
  23.  
  24. This book provides the information you need to install and use SCO(R)
  25. ARCserve(R)/Open from Cheyenne(R) products on UnixWare(R) 7 systems. It is
  26. intended for a person who has some system administration experience.
  27.  
  28. You will find the information you need more quickly if you are familiar
  29. with:
  30.  
  31.    * How this book is organized
  32.  
  33.    * Related documentation
  34.  
  35.    * Typographical conventions
  36.  
  37.  
  38. How this book is organized
  39. --------------------------
  40.  
  41. This book describes:
  42.  
  43.    * new SCO ARCserve/Open from Cheyenne features not covered in the product
  44.      documentation.
  45.  
  46.    * the SCO ARCserve/Open products and optional products that are provided,
  47.      and information you need to know before proceeding with an
  48.      installation.
  49.  
  50.    * installing and removing SCO ARCserve/Open products.
  51.  
  52.    * configuring SCO ARCserve/Open.
  53.  
  54.    * using SCO ARCserve/Open online documentation, starting SCO
  55.      ARCserve/Open, and performing a quick backup of your system.
  56.  
  57.    * limitations and workarounds relating to the SCO ARCserve/Open products.
  58.  
  59.    * troubleshooting information for the most common problems you might
  60.      encounter while using SCO ARCserve/Open.
  61.  
  62.  
  63. Related documentation
  64. ---------------------
  65.  
  66.    * SCO ARCserve/Open Client Agent Installation Guides (online)
  67.  
  68.    * SCO ARCserve/Open User Guide (online)
  69.  
  70.    * SCO ARCserve/Open Changer Guide (online)
  71.  
  72.    * SCO ARCserve/Open Error Messages (online)
  73.  
  74.    * SCO ARCserve/Open Command Line Manual Pages (located in man Section 1)
  75.  
  76.  
  77. Typographical conventions
  78. -------------------------
  79.  
  80. This publication presents commands, filenames, keystrokes, and other special
  81. elements in these typefaces:
  82.  
  83. Example . . . . . . . . Used for:
  84.  
  85. lp or lp(1)
  86.      commands, device drivers, programs, and utilities (names, icons, or
  87.      windows); the letter in parentheses indicates the reference manual
  88.      section in which the command, driver, program, or utility is documented
  89.  
  90. /new/client.list
  91.      files, directories, and desktops (names, icons, or windows)
  92.  
  93. root  system, network, or user names
  94.  
  95. filename
  96.      placeholders (replace with appropriate name or value)
  97.  
  98. <Esc>
  99.      keyboard keys
  100.  
  101. Exit program?
  102.      system output (prompts, messages)
  103.  
  104. yes or yes
  105.      user input
  106.  
  107. ``Description''
  108.      field names or column headings (on screen or in database)
  109.  
  110. Cancel
  111.      button names
  112.  
  113. Edit  menu names
  114.  
  115. Copy  menu items
  116.  
  117. File --> Find --> Text
  118.      sequences of menus and menu items
  119.  
  120. open or open(2)
  121.      library routines, system calls, kernel functions, C keywords; the
  122.      letter in parentheses indicates the reference manual section in which
  123.      the file is documented
  124.  
  125. $HOME
  126.      environment or shell variables
  127.  
  128. SIGHUP
  129.      named constants or signals
  130.  
  131. ``adm3a''
  132.      data values
  133.  
  134. employees
  135.      database names
  136.  
  137. orders
  138.      database tables
  139.  
  140. buf   C program structures
  141.  
  142. b_b.errno
  143.      structure members
  144.  
  145. ----------------------------------------------------------------------------
  146.  
  147.  
  148. Chapter 1
  149.  
  150. New features in SCO ARCserve/Open Release 2.2.0
  151.  
  152. This chapter describes new features for SCO ARCserve/Open from Cheyenne
  153. Release 2.2.0 that are not discussed in the SCO ARCserve/Open documentation,
  154. including:
  155.  
  156.    * bar code reading for autochangers,
  157.  
  158.    * SNMP message traps, and
  159.  
  160.    * support for backing up and restoring NDS trees.
  161.  
  162.  
  163. Bar code reading
  164. ----------------
  165.  
  166. SCO ARCserve/Open is now equipped to read bar code labels for tape
  167. cartridges that are accessed through tape autochangers. This feature helps
  168. reduce the initialization time that is typically associated with high
  169. capacity changers.
  170.  
  171. This section describes:
  172.  
  173.    * how bar code reading works
  174.  
  175.    * enabling and disabling bar code reading
  176.  
  177.  
  178. How bar code reading works
  179. --------------------------
  180.  
  181. When bar code reading is enabled through the SCO ARCserve/Open Device
  182. Manager, the autochanger scans for labels on each loaded cartridge tape.
  183. When a new bar code label is encountered, the corresponding tape is inserted
  184. in the tape drive and the label and the tape's volume header are read.
  185.  
  186. This information is then stored in files in the bar code tape database
  187. directory, /usr/lib/ARCserve/tapedb. A separate file is created for each
  188. unique tape label that is read.
  189.  
  190. ----------------------------------------------------------------------------
  191. NOTE: This bar code tape database is completely separate from the other SCO
  192. ARCserve/Open databases. The SCO ARCserve/Open database server process does
  193. not access any part of the bar code tape database.
  194. ----------------------------------------------------------------------------
  195.  
  196. If the changer scans a tape label that has already been encountered, the
  197. tape information is extracted from the database, saving the need to insert
  198. the tape into the tape drive.
  199.  
  200. ----------------------------------------------------------------------------
  201. NOTE: When using the bar code reading feature, all formatting and erasing of
  202. tapes must be accomplished using the options on the changer-specific Device
  203. Management menu, as opposed to the standard Device Management menu. (Note
  204. that, depending on whether you select a single drive or a changer in the
  205. list of available devices, the Device Management menu and the toolbar toggle
  206. between the standard and changer-specific options.)
  207.  
  208. It you do not use the changer-specific Device Management menu in this case,
  209. the tape database is not updated to reflect the new state of the tape.
  210.  
  211. In addition, it is recommended that you only remove tapes from the changer
  212. using the changer-specific Device Management menu, so that the tapes'
  213. information is properly removed from the tape database.
  214. ----------------------------------------------------------------------------
  215.  
  216.  
  217. Enabling and disabling bar code reading
  218. ---------------------------------------
  219.  
  220. To enable or disable bar code reading for an individual changer:
  221.  
  222.   1. Select Device Management from the Quick Access window.
  223.  
  224.   2. Select Device Group Configuration.
  225.  
  226.   3. Select the SCSI ID for the desired changer.
  227.  
  228.   4. Select Changer.
  229.  
  230.   5. Select Enable or Disable in the ``Bar Code Reading'' field.
  231.  
  232. Note that, by default, bar code reading is disabled.
  233.  
  234.  
  235. SNMP message traps
  236. ------------------
  237.  
  238. Simple Network Management Protocol (SNMP) traps are now supported in SCO
  239. ARCserve/Open. This feature allows warnings and error messages from SCO
  240. ARCserve/Open and Client Agent workstations to be ``trapped'' to a
  241. centralized network management console, allowing administrators to manage
  242. their systems more efficiently.
  243.  
  244. HP(R) OpenView(R) on both UNIX(R) and Microsoft(R) Windows(R) systems is 
  245. certified for use with SCO ARCserve/Open. However, you should be able to 
  246. send SCO ARCserve/Open message traps to any network management station on 
  247. which you can load the SCO ARCserve/Open MIB.
  248.  
  249. ----------------------------------------------------------------------------
  250. NOTE: SCO ARCserve/Open's activity log still receives all warnings and error
  251. messages when using SNMP message traps.
  252. ----------------------------------------------------------------------------
  253.  
  254. See also:
  255.  
  256.    * ``Setting up to use SNMP message traps with SCO ARCserve/Open''
  257.  
  258.    * ``Customizing SNMP message severity levels''
  259.  
  260.  
  261. Setting up to use SNMP message traps with SCO ARCserve/Open
  262. -----------------------------------------------------------
  263.  
  264. To use SNMP to trap messages from SCO ARCserve/Open, you must:
  265.  
  266.   1. Configure SNMP on the SCO ARCserve/Open server to include the SNMP
  267.      community name and the IP address or host name of the network
  268.      management station you are using.
  269.  
  270.   2. Load the SCO ARCserve/Open Management Information Bases (MIB) file on
  271.      the network management station.
  272.  
  273.   3. Turn on the SNMP trap feature for each relevant SCO ARCserve/Open
  274.      function -- Backup, Restore, Merge, and Scan.
  275.  
  276.  
  277. Configuring SNMP on the SCO ARCserve/Open server
  278. ------------------------------------------------
  279.  
  280. To enable SCO ARCserve/Open to send SNMP traps, you must first configure the
  281. SNMP configuration files on your UnixWare 7 system to include:
  282.  
  283.    * the SNMP community name, and
  284.  
  285.    * the IP address of the network management station on which you would
  286.      like to receive and display SCO ARCserve/Open messages. (You can also
  287.      specify the system's associated host name, as defined in the /etc/hosts
  288.      file.)
  289.  
  290.      An IP address or host name must be entered for each console on which
  291.      you want to receive the messages.
  292.  
  293. To specify the SNMP community name (i.e., the session name), edit the
  294. /etc/netmgt/snmpd.comm file. It is recommended that you specify a community
  295. name of ``public''. Use the format specified in the comments at the top of
  296. the snmpd.comm file.
  297.  
  298. ----------------------------------------------------------------------------
  299. CAUTION: It is very important that the SNMP community name is present in
  300. /etc/netmgt/snmpd.comm.
  301. ----------------------------------------------------------------------------
  302.  
  303. To specify the network management station to which you want the SCO
  304. ARCserve/Open traps sent, edit the /etc/netmgt/snmpd.trap file. Supply the
  305. management station's IP address (or host name), using the format specified
  306. in the comments at the top of the snmpd.trap file.
  307.  
  308.  
  309. Loading the SCO ARCserve/Open MIB file
  310. --------------------------------------
  311.  
  312. The SCO ARCserve/Open MIB file is called ARCserve.mib and is located in the
  313. /usr/lib/ARCserve directory.
  314.  
  315. This MIB file must be loaded onto your network management station before it
  316. can interpret the SCO ARCserve/Open trap messages. Refer to your network
  317. management station documentation for information on how to do this.
  318.  
  319.  
  320. Turning on SNMP message traps
  321. -----------------------------
  322.  
  323. Before SNMP messages can be sent to the network management console, you must
  324. enable them within SCO ARCserve/Open.
  325.  
  326. SNMP messages can be enabled (or disabled) for the Backup, Restore, Scan,
  327. and Merge Managers, on a per-manager basis:
  328.  
  329.   1. Select the desired Manager from the SCO ARCserve/Open Quick Access
  330.      window.
  331.  
  332.   2. Select the Reporter option from the Manager-specific menu (i.e, Backup
  333.      menu, Restore menu, and so forth).
  334.  
  335.   3. In the ``Message Type'' field, toggle SNMP alerts on or off.
  336.  
  337. By default, SNMP messages for all Managers are disabled.
  338.  
  339. To enable SNMP messages for all of these Managers, you must perform the
  340. above steps in each Manager window. Or, you can selectively enable traps for
  341. only the Managers you desire.
  342.  
  343.  
  344. Customizing SNMP message severity levels
  345. ----------------------------------------
  346.  
  347. The SCO ARCserve/Open SNMP Configuration Manager allows you to change the
  348. severity level that is assigned to each trapped message.
  349.  
  350. The SNMP Configuration Manager is accessed from the Utility menu on the SCO
  351. ARCserve/Open Quick Access window.
  352.  
  353. See also:
  354.  
  355.    * ``Assigning severity levels to messages''
  356.  
  357.    * ``Configuring messages for SCO ARCserve/Open modules''
  358.  
  359.  
  360. Assigning severity levels to messages
  361. -------------------------------------
  362.  
  363. Each SNMP message can be assigned one of four severity levels:
  364.  
  365. Critical
  366.      These messages require immediate attention, such as a failed backup or
  367.      the need to load media.
  368.  
  369. Warning
  370.      These messages correspond to error or warning situations where SCO
  371.      ARCserve/Open's operation resumes without intervention.
  372.  
  373. Normal
  374.      These messages consist of standard notifications, such as the start
  375.      and/or completion of a job.
  376.  
  377. Disabled
  378.      These messages are not trapped and therefore not displayed.
  379.  
  380.  
  381. Configuring messages for SCO ARCserve/Open modules
  382. --------------------------------------------------
  383.  
  384. SCO ARCserve/Open allows you to configure messages on a module basis, where
  385. a module corresponds to a class of Client Agents associated with a
  386. particular platform.
  387.  
  388. Messages associated with a particular Client Agent can be configured using
  389. the Module menu in the SNMP Configuration Manager -- simply select the
  390. appropriate Client Agent. Client Agent modules are listed in this menu
  391. depending on whether or not the corresponding severity file exists in the
  392. /usr/lib/ARCserve/nls/C directory.
  393.  
  394.  
  395. Backing up and restoring an NDS tree
  396. ------------------------------------
  397.  
  398. SCO ARCserve/Open is now capable of backing up and restoring NetWare(R)
  399. Directory Services(TM) (NDS) trees. This section describes how to:
  400.  
  401.    * select an NDS tree for backup
  402.  
  403.    * restore an NDS tree
  404.  
  405. ----------------------------------------------------------------------------
  406. NOTE: To backup and restore a NetWare 4.x NDS tree, SCO ARCserve/Open must
  407. be running on the same server where the NDS tree was created or replicated,
  408. and the SCO ARCserve/Open server must belong to the NDS tree.
  409.  
  410. The SCO ARCserve/Open server only permits the backup and restore of its own
  411. NDS tree -- and this is the only NDS tree that is visible from the Backup
  412. and Restore Managers.
  413. ----------------------------------------------------------------------------
  414.  
  415. For more information on NDS and how it is implemented within UnixWare 7,
  416. refer to ``Administering NetWare Services (NWS)'' in the SCOhelp online
  417. documentation.
  418.  
  419.  
  420. Selecting an NDS tree for backup
  421. --------------------------------
  422.  
  423. Select the NDS tree for backup in the same way you would any other server or
  424. node.
  425.  
  426. ----------------------------------------------------------------------------
  427. NOTE: You must have admin rights to perform a backup of an NDS tree. (The
  428. admin user is the equivalent of the supervisor user in NetWare 3.x.)
  429. ----------------------------------------------------------------------------
  430.  
  431. The NDS tree (associated with the SCO ARCserve/Open server) is displayed
  432. within the server's directory tree, which is visible within the Source area
  433. of the Backup Manager window.
  434.  
  435. To back up an NDS tree:
  436.  
  437.   1. In the Source area of the Backup Manager window, expand the directory
  438.      tree associated with the local server.
  439.  
  440.      The NDS tree is displayed along with the server's existing filesystems,
  441.      as shown below:
  442.  
  443.      [Image]
  444.  
  445.   2. Select the target NDS tree that you want to backup by clicking on the
  446.      box directly to its left.
  447.  
  448.      Once selected, you see the Secured Object Login dialog box.
  449.  
  450.   3. Enter the user name and password for the selected NDS tree:
  451.  
  452.      [Image]
  453.  
  454.      The NDS user name is equivalent to the NDS context name. The NDS
  455.      context name consists of the object's full path, starting with Admin
  456.      leaf and ending at the root of the tree.
  457.  
  458.      Given the NDS structure implemented below:
  459.  
  460.      [Image]
  461.  
  462.      the syntax for entering a valid user name (NDS path) is:
  463.  
  464.         .CN=Admin.0=Cheyenne
  465.  
  466.   4. In the Destination area of the Backup Manager window, select the tape
  467.      device group and tape for the backup job.
  468.  
  469.   5. Click on the Run button to execute the backup job.
  470.  
  471.  
  472. Restoring an NDS tree
  473. ---------------------
  474.  
  475. You can use either Tape View or Tape Session to restore your NDS trees. This
  476. section outlines the steps for restoring NDS objects using the Tape Session
  477. view. For information on using Tape View, see the SCO ARCserve/Open User
  478. Guide.
  479.  
  480. ----------------------------------------------------------------------------
  481. NOTE: You will not be able to use the Tape Session view if you do not have
  482. Queue Operator permissions. If you are not a Queue Operator, you can only
  483. use the Tape View to restore from your own sessions.
  484. ----------------------------------------------------------------------------
  485.  
  486.  
  487. Finding the NDS session to restore
  488. ----------------------------------
  489.  
  490. When using the Tape Session view, you are required to select the tape
  491. session that you want restored. To locate the correct session containing the
  492. NDS information:
  493.  
  494.    * Run the Report Manager and view the SCO ARCserve/Open activity log,
  495.      called archsvr.log. This file will tell you the session you need to
  496.      use.
  497.  
  498.  
  499. Restoring the NDS tree using Tape Session
  500. -----------------------------------------
  501.  
  502. To restore an NDS tree using the Tape Session view:
  503.  
  504.   1. In the toolbar on the Restore Manager window, click on the Tape Session
  505.      button.
  506.  
  507.      SCO ARCserve/Open reads directly from your tape devices and displays
  508.      the tape groups that you are using.
  509.  
  510.   2. Select the tape that you want to use for the restore operation.
  511.  
  512.   3. Click on Source and select the session containing the NDS tree that you
  513.      want to restore.
  514.  
  515.      [Image]
  516.  
  517.   4. In the Destination area, select the NDS tree as shown below:
  518.  
  519.      [Image]
  520.  
  521.      -----------------------------------------------------------------------
  522.      NOTE: When selecting an NDS tree as your restore source, you must
  523.      select the same NDS tree as your restore destination.
  524.  
  525.      In addition, you must have admin (or supervisor) rights to the NDS tree
  526.      that you select as your restore destination.
  527.      -----------------------------------------------------------------------
  528.  
  529.      Once selected, you see the Secured Object Login dialog box.
  530.  
  531.   5. Enter the NDS user name and password to log into the selected tree. See
  532.      ``Selecting an NDS tree for backup'' for information on entering valid
  533.      user names.
  534.  
  535.   6. Click on the Run button to schedule and run the restore job.
  536.  
  537. ----------------------------------------------------------------------------
  538. NOTE: After restoring an NDS tree, you may need to run certain NDS
  539. management utilities, such as DS_Repair and DS_Install, on your
  540. NetWare-enabled UnixWare 7 server. See your UnixWare 7 NDS documentation for
  541. more information on these management utilities.
  542. ----------------------------------------------------------------------------
  543.  
  544. ----------------------------------------------------------------------------
  545.  
  546.  
  547. Chapter 2
  548.  
  549. Installing and removing SCO ARCserve/Open products
  550.  
  551. This chapter describes:
  552.  
  553.    * the SCO ARCserve/Open from Cheyenne products and product options
  554.  
  555.    * connecting tape drives before installation
  556.  
  557.    * installing SCO ARCserve/Open products
  558.  
  559.    * licensing SCO ARCserve/Open products
  560.  
  561.    * removing SCO ARCserve/Open products
  562.  
  563.  
  564. SCO ARCserve/Open products and options
  565. --------------------------------------
  566.  
  567. The following SCO ARCserve/Open products and product options are available:
  568.  
  569.    * SCO ARCserve/Open from Cheyenne Lite, the backup and restore manager
  570.      for single systems. SCO ARCserve/Open Lite is the default backup and
  571.      restore manager for UnixWare 7 SCOadmin.
  572.  
  573.    * SCO ARCserve/Open from Cheyenne, the fully-featured, high performance
  574.      data management tool for single systems and enterprise networks. (See
  575.      ``Software preview'' in the SCO ARCserve/Open User Guide for a
  576.      description of the differences between the Lite and Full products.)
  577.  
  578.    * the Changer option, providing support for leading 4mm, 8mm, and DLT
  579.      auto changers. This option requires the use of the full SCO
  580.      ARCserve/Open product.
  581.  
  582.    * Client Agents that allow SCO ARCserve/Open to manage the following
  583.      platforms:
  584.  
  585.         o multiple UNIX System platforms, including UnixWare(R) 7, SCO
  586.           UnixWare, SCO Release 3 and SCO OpenServer Release 5, IBM(R) AIX(TM),
  587.           HP-UX(R), Silicon Graphics(R) IRIX(TM), Solaris(R) SPARC(R), and 
  588.           SunSoft(TM) SunOS(TM)
  589.  
  590.         o Apple(R) Macintosh(R)
  591.  
  592.         o IBM OS/2(R)
  593.  
  594.         o Microsoft Windows, Windows 95, and Windows NT
  595.  
  596.         o Novell NetWare
  597.  
  598.    * client connection licenses, enabling management of data on remote
  599.      systems that have an SCO ARCserve/Open Client Agent installed. This
  600.      option requires the use of the full SCO ARCserve/Open product.
  601.  
  602.  
  603. Before installing: connecting your tape drives
  604. ----------------------------------------------
  605.  
  606. You must have at least one SCSI tape drive attached to the SCSI port of your
  607. system to back up and restore data using SCO ARCserve/Open.
  608.  
  609. ----------------------------------------------------------------------------
  610. NOTE: See the SCO Hardware Compatibility Handbook on the SCO World Wide Web
  611. page (www.sco.com) for the list of currently supported tape devices.
  612. ----------------------------------------------------------------------------
  613.  
  614. SCO ARCserve/Open allows you to ``group'' drives so that you can take
  615. advantage of Tape Cascading and Parallel Streaming:
  616.  
  617.    * Tape Cascading allows jobs to span to the tape in the next drive when
  618.      one tape fills up. For a job to span to another drive, both drives must
  619.      be in the same group.
  620.  
  621.    * Parallel streaming allows two or more jobs to run at the same time. To
  622.      run two jobs at the same time, you must have at least two drives, each
  623.      in a separate group.
  624.  
  625. By default, each drive is placed into a separate group. These default groups
  626. are named after the planets in our solar system, excluding Earth. (The
  627. planets are Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, and
  628. Pluto.)
  629.  
  630. Therefore, if you have two drives, one with SCSI ID 2 and one with SCSI ID
  631. 3, SCO ARCserve/Open sets up two groups called ``MARS'' and ``JUPITER''. You
  632. can then modify these tape group assignments and names using the SCO
  633. ARCserve/Open Device Manager.
  634.  
  635. For more information on tape groups, see ``Managing your Tapes and Tape
  636. Devices'' in the SCO ARCserve/Open User Guide.
  637.  
  638.  
  639. Installing SCO ARCserve/Open products
  640. -------------------------------------
  641.  
  642. Table 2-1 identifies the procedure to use to install the various SCO
  643. ARCserve/Open products:
  644.  
  645.  To install:              See:
  646.  ----------------------   -------------------------------------------------
  647.                           ``Installing SCO ARCserve/Open products from the
  648.  SCO ARCserve/Open Lite   Desktop''
  649.    or                       or
  650.  SCO ARCserve/Open        ``Installing SCO ARCserve/Open products from the
  651.                           command line''
  652.  
  653.  Client Agents            Appropriate SCO ARCserve/Open Client Agent
  654.                           Installation Guide (online)
  655.  
  656. ----------------------------------------------------------------------------
  657. NOTE: If SCO ARCserve/Open Lite is already installed on your system, you
  658. only need to add an appropriate license to upgrade to the fully-featured SCO
  659. ARCserve/Open.
  660.  
  661. The Changer option for auto changer support and the client connections for
  662. managing data on remote systems are activated by adding the appropriate
  663. licenses to your system after SCO ARCserve/Open is installed.
  664.  
  665. See ``Licensing SCO ARCserve/Open products and options'' for information on
  666. licensing SCO ARCserve/Open products and options.
  667. ----------------------------------------------------------------------------
  668.  
  669.  
  670.  
  671. Installing SCO ARCserve/Open products from the Desktop
  672. ------------------------------------------------------
  673.  
  674. To install an SCO ARCserve/Open product from the UnixWare 7 Desktop:
  675.  
  676.   1. Log in to the Desktop as owner.
  677.  
  678.   2. Insert the media containing the desired SCO ARCserve/Open product in
  679.      the CD-ROM drive.
  680.  
  681.   3. Start the Application Installer in one of these ways:
  682.  
  683.         o Run the SCOadmin launcher from the Desktop and select Application
  684.           Installer from the Software_Management folder.
  685.  
  686.         o Enter scoadmin application installer at the prompt in a graphical
  687.           terminal (xterm) window.
  688.  
  689.   4. Select the correct device (for example, CD-ROM_1) in the ``Install
  690.      From'' field.
  691.  
  692.   5. Click on Update View to see the packages that are available to install.
  693.      The SCO ARCserve/Open packages include:
  694.  
  695.      ARCserve
  696.           both the Lite and Full versions of SCO ARCserve/Open
  697.  
  698.      ARCdoc
  699.           the full online documentation for both the Lite and Full versions
  700.           of SCO ARCserve/Open
  701.  
  702.      UAGENT
  703.           the Client Agent for UnixWare 7 systems
  704.  
  705.   6. Select the desired SCO ARCserve/Open package and click on Install.
  706.  
  707.      Depending on the package you are installing, you may need to respond to
  708.      some additional prompts. Answer these prompts as appropriate for your
  709.      installation.
  710.  
  711.      Repeat this step for each package you wish to install.
  712.  
  713.   7. When you have installed all desired packages, select Exit from the
  714.      Actions menu.
  715.  
  716.      SCO ARCserve/Open is installed in the /usr/lib/ARCserve directory.
  717.  
  718.   8. The installation defines several important environment variables in the
  719.      /etc/profile and /etc/cshrc files. When you have completed the
  720.      installation, run one of the following, depending on the shell you are
  721.      using, to initialize the proper environment for running SCO
  722.      ARCserve/Open:
  723.  
  724.      source /etc/cshrc (for C-shell)
  725.  
  726.      or
  727.  
  728.      . /etc/profile (for Bourne or Korn shell)
  729.  
  730. Note the following:
  731.  
  732.    * To activate the full-featured SCO ARCserve/Open, the Changer option, or
  733.      client connections, see ``Licensing SCO ARCserve/Open products and
  734.      options''.
  735.  
  736.    * To install Client Agents, see the installation instructions in the
  737.      corresponding online documentation.
  738.  
  739.    * For information on starting SCO ARCserve/Open and using the online
  740.      documentation, see Chapter 4, ``Getting started with SCO
  741.      ARCserve/Open''.
  742.  
  743.  
  744. Installing SCO ARCserve/Open products from the command line
  745. -----------------------------------------------------------
  746.  
  747. To install an SCO ARCserve/Open product from the UnixWare 7 command line:
  748.  
  749.   1. Log in as root.
  750.  
  751.   2. Insert the media containing the desired SCO ARCserve/Open product in
  752.      the CD-ROM drive.
  753.  
  754.   3. Mount the CD-ROM drive:
  755.  
  756.      /usr/sbin/mount -rF cdfs /dev/cdrom/c0b0t#l0 /mnt
  757.  
  758.      where /mnt is the mount point directory and t# is the SCSI ID of the
  759.      CD-ROM device. For example, if your CD-ROM drive is set to a SCSI ID of
  760.      5, you would specify /dev/cdrom/c0b0t5l0.
  761.  
  762.   4. Run the pkgadd utility once for each SCO ARCserve/Open package you want
  763.      to install:
  764.  
  765.      pkgadd -d /mnt package_name.pkg
  766.  
  767.      The available packages are:
  768.  
  769.      ARCserve
  770.           both the Lite and Full versions of SCO ARCserve/Open
  771.  
  772.      ARCdoc
  773.           the full online documentation for both the Lite and Full versions
  774.           of SCO ARCserve/Open
  775.  
  776.      UAGENT
  777.           the Client Agent for UnixWare 7 systems
  778.  
  779.      For example, to install the ARCserve package, you would enter:
  780.  
  781.      pkgadd -d /mnt ARCserve.pkg
  782.  
  783.      Depending on the package you are installing, you may need to respond to
  784.      some additional prompts. Answer these prompts as appropriate for your
  785.      installation.
  786.  
  787.      SCO ARCserve/Open is installed in the /usr/lib/ARCserve directory.
  788.  
  789.   5. The installation defines several important environment variables in the
  790.      /etc/profile and /etc/cshrc files. When you have completed the
  791.      installation, run one of the following, depending on the shell you are
  792.      using, to initialize the proper environment for running SCO
  793.      ARCserve/Open:
  794.  
  795.      source /etc/cshrc (for C-shell)
  796.  
  797.      or
  798.  
  799.      . /etc/profile (for Bourne or Korn shell)
  800.  
  801. Note the following:
  802.  
  803.    * To activate the full-featured SCO ARCserve/Open, the Changer option, or
  804.      client connections, see ``Licensing SCO ARCserve/Open products and
  805.      options''.
  806.  
  807.    * To install Client Agents, see the installation instructions in the
  808.      corresponding online documentation.
  809.  
  810.    * For information on starting SCO ARCserve/Open and using the online
  811.      documentation, see Chapter 4, ``Getting started with SCO
  812.      ARCserve/Open''.
  813.  
  814.  
  815. Licensing SCO ARCserve/Open products and options
  816. ------------------------------------------------
  817.  
  818. Licenses are required to activate the functionality for the following SCO
  819. ARCserve/Open products and options:
  820.  
  821.    * SCO ARCserve/Open (full product)
  822.  
  823.    * SCO ARCserve/Open Changer Option
  824.  
  825.    * SCO ARCserve/Open Client Connections
  826.  
  827. SCO ARCserve/Open Lite does not need to be licensed.
  828.  
  829. To add licenses for your SCO ARCserve/Open products and options:
  830.  
  831.   1. As root, log in to the system where the SCO ARCserve/Open package has
  832.      been installed.
  833.  
  834.   2. Start the License Manager in one of these ways:
  835.  
  836.         o Run the SCOadmin launcher from the Desktop and select License
  837.           Manager.
  838.  
  839.         o Enter scoadmin license manager on the command line.
  840.  
  841.   3. Choose the SCO ARCserve/Open product or option that you wish to license
  842.      from the list of products.
  843.  
  844.   4. Select License --> Add.
  845.  
  846.   5. Enter the License Number, License Code, and License Data from the
  847.      Certificate of License and Authenticity (COLA) for your SCO
  848.      ARCserve/Open product or option.
  849.  
  850.   6. Click on License.
  851.  
  852. See also:
  853.  
  854.    * Chapter 6, ``Licensing and registering SCO products'' in the SCO
  855.      OpenServer Handbook
  856.  
  857.  
  858. Removing SCO ARCserve/Open products
  859. -----------------------------------
  860.  
  861. This section describes the two methods you can use to remove SCO
  862. ARCserve/Open products:
  863.  
  864.    * ``Removing SCO ARCserve/Open products from the Desktop''
  865.  
  866.    * ``Removing SCO ARCserve/Open products from the command line''
  867.  
  868.  
  869. Removing SCO ARCserve/Open products from the Desktop
  870. ----------------------------------------------------
  871.  
  872. To remove an SCO ARCserve/Open product from the UnixWare 7 Desktop:
  873.  
  874.   1. Log in to the Desktop as owner.
  875.  
  876.   2. Start the Application Installer in one of these ways:
  877.  
  878.         o Run the SCOadmin launcher from the Desktop and select Application
  879.           Installer from the Software_Management folder.
  880.  
  881.         o Enter scoadmin application installer in a graphical terminal
  882.           (xterm) window.
  883.  
  884.   3. For each SCO ARCserve/Open package you want to remove, select the
  885.      package icon in the list of currently installed applications and click
  886.      on Remove.
  887.  
  888.   4. For each package you select to remove, you see:
  889.  
  890.         Do you want to remove this package [yes,no,?,quit]
  891.  
  892.      Select y.
  893.  
  894.   5. When finished removing packages, select Exit from the Actions menu.
  895.  
  896.  
  897. Removing SCO ARCserve/Open products from the command line
  898. ---------------------------------------------------------
  899.  
  900. To remove an SCO ARCserve/Open product from the UnixWare 7 command line:
  901.  
  902.   1. Log in as root.
  903.  
  904.   2. Run the pkgrm utility once for each SCO ARCserve/Open package that you
  905.      want to remove:
  906.  
  907.      pkgrm package_name.pkg
  908.  
  909.   3. For each package you select to remove, you see:
  910.  
  911.         Do you want to remove this package [yes,no,?,quit]
  912.  
  913.      Select y.
  914.  
  915. ----------------------------------------------------------------------------
  916.  
  917.  
  918. Chapter 3
  919.  
  920. Configuring SCO ARCserve/Open
  921.  
  922. This chapter describes:
  923.  
  924.    * configuring messages that require user action to display on the system
  925.      console.
  926.  
  927.    * configuring SCO ARCserve/Open from Cheyenne to use multiple SCSI
  928.      adapters.
  929.  
  930.    * relocating the SCO ARCserve/Open database to a filesystem with more
  931.      available disk space.
  932.  
  933.  
  934. Displaying messages on the system console
  935. -----------------------------------------
  936.  
  937. By default, SCO ARCserve/Open messages that require a user to respond or
  938. perform an action (such as insert a tape in a drive) are sent to the syslogd
  939. daemon. If you want these messages to display on the system console instead,
  940. add the following lines to the /etc/syslog.conf file:
  941.  
  942.       user.alert /dev/console
  943.  
  944. This indicates that SCO ARCserve/Open uses the syslogd(1M) daemon at the
  945. ``user'' facility and sends messages at the ``alert'' priority level. For
  946. more information on syslogd(1M) and /etc/syslog.conf, see the
  947. syslog.conf(4bsd) manual page.
  948.  
  949.  
  950. Using SCO ARCserve/Open with multiple SCSI adapters
  951. ---------------------------------------------------
  952.  
  953. If your system has tape devices attached to multiple SCSI host adapters, the
  954. SCSI ID numbers used by all the tape devices must be unique or SCO
  955. ARCserve/Open will not be able to access them.
  956.  
  957. ----------------------------------------------------------------------------
  958. NOTE: Regardless of the number of host adapters in your system, SCO
  959. ARCserve/Open only recognizes a total of 7 tape devices, using SCSI ID
  960. Numbers 0 through 6.
  961. ----------------------------------------------------------------------------
  962.  
  963.  
  964. Relocating the SCO ARCserve/Open database
  965. -----------------------------------------
  966.  
  967. By default, the SCO ARCserve/Open database is located on the root
  968. filesystem. Over time, the database may grow to such a size that it starts
  969. creating space problems on the root filesystem.
  970.  
  971. You can move the database to a filesystem that has more available space:
  972.  
  973.   1. It is recommended that you back up the database,
  974.      /usr/lib/ARCserve/dbase, before moving it to a different location.
  975.  
  976.   2. Run astop.
  977.  
  978.   3. Change to the following directory:
  979.  
  980.      cd /usr/lib/ARCserve
  981.  
  982.   4. Move the database directory to a different filesystem. For example:
  983.  
  984.      mv ./dbase /<new_filesystem>/dbase
  985.  
  986.   5. Make a link to the new database directory:
  987.  
  988.      ln -s /<new_filesystem>/dbase ./dbase
  989.  
  990.   6. Run astart.
  991.  
  992. ----------------------------------------------------------------------------
  993.  
  994.  
  995. Chapter 4
  996.  
  997. Getting started with SCO ARCserve/Open
  998.  
  999. This chapter covers getting started with SCO ARCserve/Open from Cheyenne,
  1000. including the minimum steps required to make a full backup of your system.
  1001.  
  1002. Specifically, this chapter describes:
  1003.  
  1004.    * how to access the online SCO ARCserve/Open documentation.
  1005.  
  1006.    * starting and stopping both the SCO ARCserve/Open front-end and
  1007.      back-end.
  1008.  
  1009.    * performing a quick backup.
  1010.  
  1011.  
  1012. Accessing the SCO ARCserve/Open online documentation
  1013. ----------------------------------------------------
  1014.  
  1015. Full SCO ARCserve/Open documentation, including a copy of these Release and
  1016. Installation Notes, is provided online and is accessible from the SCOhelp
  1017. system.
  1018.  
  1019. ----------------------------------------------------------------------------
  1020. NOTE: The SCO ARCserve/Open online documentation set is the same for both
  1021. the SCO ARCserve/Open Lite and SCO ARCserve/Open products.
  1022. ----------------------------------------------------------------------------
  1023.  
  1024. To access the SCO ARCserve/Open online documentation, run SCOhelp and click
  1025. on the ``Backup and Restore'' link in the left navigational frame. From
  1026. here, you can access all of the SCO ARCserve/Open online documentation,
  1027. including the User Guide and the Client Agent Installation Guides.
  1028.  
  1029.  
  1030. Starting and stopping SCO ARCserve/Open
  1031. ---------------------------------------
  1032.  
  1033. The installation procedure automatically creates a script file called
  1034. S69ARCserve and places it in /etc/rc2.d. When the system is brought up in
  1035. multi-user mode, this script is invoked and automatically starts all
  1036. necessary daemons for the back-end.
  1037.  
  1038. In the event that your system appears to hang during the process of starting
  1039. the SCO ARCserve/Open daemons, bring up the system in single-user mode. When
  1040. the system is up, delete the S69ARCserve file and follow the instructions
  1041. below for starting the back-end daemons manually:
  1042.  
  1043.   1. Log in as root.
  1044.  
  1045.   2. Type astart.
  1046.  
  1047. The back-end processes (scheduler, tape server, and the database server) run
  1048. without requiring any attention from you until you stop them.
  1049.  
  1050. To start the SCO ARCserve/Open front end:
  1051.  
  1052.   1. Run the SCOadmin launcher from the Desktop.
  1053.  
  1054.   2. Select SCO ARCserve/Open Backup Manager.
  1055.  
  1056.      The SCO ARCserve/Open Quick Access window displays. From here you
  1057.      select the SCO ARCserve/Open operation that you want to perform.
  1058.  
  1059. You can also start SCO ARCserve/Open from the command line by entering:
  1060.  
  1061.        arcserve
  1062.  
  1063. To stop the SCO ARCserve/Open back-end:
  1064.  
  1065.   1. Log in as root.
  1066.  
  1067.   2. Type astop.
  1068.  
  1069. To stop the SCO ARCserve/Open front-end:
  1070.  
  1071.   1. Close all SCO ARCserve/Open manager windows.
  1072.  
  1073.   2. Select Exit from the Quick Access window File menu.
  1074.  
  1075.  
  1076. Backing up files -- the basic steps
  1077. -----------------------------------
  1078.  
  1079. Following are the basic steps for making a backup -- that is, using the
  1080. default backup options to back up your data to tape. Advanced backup options
  1081. are covered in the SCO ARCserve/Open User Guide.
  1082.  
  1083.      John has been having problems with his machine lately. He wants to make
  1084.      a quick backup of his system before anything else goes wrong.
  1085.  
  1086. Using the above example, follow these directions to back up your files:
  1087.  
  1088.   1. Put a tape in the tape drive that you want to use.
  1089.  
  1090.   2. From the Quick Access window, select Backup by clicking on the Backup
  1091.      icon.
  1092.  
  1093.   3. In the Source area, select the system to back up.
  1094.  
  1095.      [Image]
  1096.  
  1097.      See ``Software Basics'' in the SCO ARCserve/Open User Guide for more
  1098.      information on using the Browser to select your sources.
  1099.  
  1100.   4. In the Destination area, select the tape device group and the tape for
  1101.      the backup.
  1102.  
  1103.      [Image]
  1104.  
  1105.   5. Run the job.
  1106.  
  1107.      Click the Run button to schedule and run the job.
  1108.  
  1109. ----------------------------------------------------------------------------
  1110.  
  1111.  
  1112. Chapter 5
  1113.  
  1114. Known limitations and workarounds
  1115.  
  1116. This release of SCO ARCserve/Open from Cheyenne for UnixWare 7 contains
  1117. limitations, and where possible, workarounds in the following categories:
  1118.  
  1119.    * tape device locking
  1120.  
  1121.    * backups
  1122.  
  1123.    * Client Agents
  1124.  
  1125.    * SNMP message traps
  1126.  
  1127.    * command line options for SCO ARCserve/Open Lite
  1128.  
  1129.  
  1130. Tape device locking limitations
  1131. -------------------------------
  1132.  
  1133. By default, SCO ARCserve/Open locks all of the SCSI tape devices attached to
  1134. your system. Because of this, your tape devices are unavailable for use by
  1135. backup commands such as tar(1) or cpio(1), even if the devices are not
  1136. currently being used for backup or restore operations by SCO ARCserve/Open.
  1137.  
  1138. Depending on the number of tape devices available on your system, there are
  1139. two possible workarounds to this situation.
  1140.  
  1141.    * If your system contains a single SCSI tape drive, you can temporarily
  1142.      unlock the device by running astop to shut down the SCO ARCserve/Open
  1143.      backend. When you are finished using the tape drive, restart SCO
  1144.      ARCserve/Open by running astart.
  1145.  
  1146.    * If your system contains multiple tape drives, you can unlock one or
  1147.      more individual devices by editing the /usr/lib/ARCserve/tapesvr.cfg
  1148.      file and commenting out the desired devices in the Device Table
  1149.      section. Specific instructions on how to make these changes are
  1150.      documented within the tapesvr.cfg file.
  1151.  
  1152.      -----------------------------------------------------------------------
  1153.      NOTE: Any tape devices that are commented out of the tapesvr.cfg file
  1154.      are unavailable to SCO ARCserve/Open. You should only use this approach
  1155.      if you do not mind dedicating a tape device to non-SCO ARCserve/Open
  1156.      uses.
  1157.      -----------------------------------------------------------------------
  1158.  
  1159.  
  1160. Backup limitations
  1161. ------------------
  1162.  
  1163. The following limitations apply when running backup jobs:
  1164.  
  1165.    * If the tape server hangs during startup, a possible workaround may be
  1166.      to comment out all of the SCSI ID entries that are not tape devices in
  1167.      /usr/lib/ARCserve/tapesvr.cfg. The tapesvr.cfg file uses the semi-colon
  1168.      (;) as a comment character.
  1169.  
  1170.      When you have finished editing the tapesvr.cfg file, run astop to stop
  1171.      all SCO ARCserve/Open processes then run astart to restart the server.
  1172.  
  1173.    * If your system experiences problems with any NFS-mounted filesystems at
  1174.      the same time that you are running a backup job, SCO ARCserve/Open will
  1175.      not be able to determine the nature of these filesystems and will
  1176.      report a Failed to Access Source Directory error in the activity log.
  1177.  
  1178.      If, as is set by default, you do not want to back up NFS filesystems,
  1179.      you can safely ignore these error messages -- your backup jobs are
  1180.      complete. If, however, you want to include the NFS filesystems in your
  1181.      backup job, you will need to rerun the operation.
  1182.  
  1183.    * If there are two tapes with the same name in the SCO ARCserve/Open
  1184.      database that are both being used by an Auto Pilot job, the Auto Pilot
  1185.      will not correctly recycle any of its tapes.
  1186.  
  1187.      The workaround to this problem is to remove one of the tapes with the
  1188.      same name from the SCO ARCserve/Open database.
  1189.  
  1190.    * If a CD-ROM is mounted on your system and the mount point is selected
  1191.      as part of a backup job, the entire contents of the CD-ROM will be
  1192.      backed up. This is probably an unnecessary use of tape.
  1193.  
  1194.      To avoid this, either make sure that all CD-ROMs are unmounted before
  1195.      starting a backup, or do not select the CD-ROM mount point(s) for
  1196.      backup.
  1197.  
  1198. See also:
  1199.  
  1200.    * ``Client Agent limitations''
  1201.  
  1202.  
  1203. Client Agent limitations
  1204. ------------------------
  1205.  
  1206. The following limitations apply when using SCO ARCserve/Open Client Agents:
  1207.  
  1208.    * When expanding the list of Remote Clients in either the Backup or
  1209.      Restore Manager windows, it is possible that the list may not display
  1210.      all of your active remote clients. This is due to an inherent
  1211.      limitation in the design of UDP, one of the underlying network
  1212.      protocols on which SCO ARCserve/Open relies. This problem tends to
  1213.      occur most often with Macintosh systems, but may be experienced for any
  1214.      remote host.
  1215.  
  1216.      If the Remote Clients list does not display a system that you expect to
  1217.      see, verify that the machine is functioning properly and that the
  1218.      Client Agent is running. If there are no physical reasons why the
  1219.      remote host should be inaccessible by the SCO ARCserve/Open server,
  1220.      close the Remote Clients list and display it again, repeating this step
  1221.      until the desired remote host appears.
  1222.  
  1223.    * If a UNIX system Client Agent (uagent) on a remote system is stopped
  1224.      while an SCO ARCserve/Open server is running a backup job on that
  1225.      system, the backup job will never complete. Consequently, the tape
  1226.      device performing the backup remains inaccessible indefinitely.
  1227.  
  1228.      The workaround to this problem is to stop all SCO ARCserve/Open daemons
  1229.      on the SCO ARCserve/Open server by running astop, then restart the
  1230.      daemons with astart.
  1231.  
  1232.    * To back up a Windows NT 4.0 system, you must use the Windows NT Client
  1233.      Agent provided with the 2.2 release of SCO ARCserve/Open. The 2.1
  1234.      release of the Windows NT Client Agent does not work on an NT 4.0
  1235.      platform.
  1236.  
  1237.    * The Macintosh and OS/2 Client Agents can only be used with an SCO
  1238.      ARCserve/Open Release 2.2 server -- the 2.1 release of SCO
  1239.      ARCserve/Open cannot back up these platforms. All of the other
  1240.      supported Client Agents work with both SCO ARCserve/Open Release 2.1
  1241.      and 2.2.
  1242.  
  1243.    * If you run custom incremental backups on an OS/2 client, restore
  1244.      operations that require files from more than one tape session may fail
  1245.      to recover files from any session other than the most current. To work
  1246.      around this problem, we suggest that you limit restore operations to a
  1247.      single tape session at a time. You can view the SCO ARCserve/Open
  1248.      database to see the files that are contained on the tape session that
  1249.      you want to restore.
  1250.  
  1251.      Restoring files from multiple tape sessions is not a problem if you use
  1252.      Auto Pilot to back up your OS/2 clients.
  1253.  
  1254.    * There are certain types of files on NetWare systems that you can view
  1255.      and select in the Backup Manager browser but which do not actually get
  1256.      backed up. Testing seems to indicate that this is a function of a file
  1257.      having both the ``hidden'' and ``system'' attributes.
  1258.  
  1259.      After your backup job has completed, check the activity log and compare
  1260.      the number of files processed with the number of files actually written
  1261.      to tape for any discrepancies. There is no current workaround to this
  1262.      problem.
  1263.  
  1264.  
  1265. SNMP message trap limitations
  1266. -----------------------------
  1267.  
  1268. The following limitations apply when using SNMP message traps:
  1269.  
  1270.    * Currently, if you enable SNMP messages for any of the SCO ARCserve/Open
  1271.      Managers that support this functionality (i.e., Backup, Restore, Scan,
  1272.      and Merge), traps are only generated for jobs that are initiated during
  1273.      that Manager session. For example, if you enable SNMP messages for the
  1274.      Backup Manager then exit the Manager window, backup jobs that you
  1275.      create the next time you run the Backup Manager will not generate SNMP
  1276.      trap messages unless you once again enable them.
  1277.  
  1278.    * When adding a Client Agent's severity file to the
  1279.      /usr/lib/ARCserve/nls/C directory, you must also create a copy of the
  1280.      file (in the same directory) that uses an extension of .default.
  1281.      Otherwise, errors occur when selecting the Default button in the SNMP
  1282.      Configuration Manager.
  1283.  
  1284.      For example, if you want to generate SNMP message traps from a Windows
  1285.      95 Client Agent system, copy the win95-30.sev severity file from the
  1286.      Client Agent distribution to the /usr/lib/ARCserve/nls/C directory on
  1287.      the SCO ARCserve/Open server. Then, in the same directory, make a copy
  1288.      of the severity file and name it win95-30.sev.default.
  1289.  
  1290.  
  1291. SCO ARCserve/Open Lite command line limitations
  1292. -----------------------------------------------
  1293.  
  1294. If you are using SCO ARCserve/Open Lite, you must use the arcserve.cmd
  1295. utility (located in /usr/lib/ARCserve) to perform basic backup and restore
  1296. operations from the command line. This utility is useful for scheduling SCO
  1297. ARCserve/Open jobs from cron(1) or other such scheduling utilities.
  1298.  
  1299. ----------------------------------------------------------------------------
  1300. NOTE: The documented command line options for the Full version of SCO
  1301. ARCserve/Open are not available to the Lite product.
  1302. ----------------------------------------------------------------------------
  1303.  
  1304. The arcserve.cmd utility syntax is:
  1305.  
  1306.    * For backup jobs:
  1307.  
  1308.      arcserve.cmd -b [-eEgiIt] source_path
  1309.  
  1310.      where -b is for backup and source_path is what you want backed up. You
  1311.      must specify the directory to back up in source_path.
  1312.  
  1313.    * For restore jobs:
  1314.  
  1315.      arcserve.cmd -r [-deEgiInt]
  1316.  
  1317.      where -r is for restore.
  1318.  
  1319. Optional parameters include:
  1320.  
  1321. -d    destination path. If no destination path is specified, the destination
  1322.      is the current directory.
  1323.  
  1324. -h    help on usage.
  1325.  
  1326. -e    exclude certain file patterns, which must be in quotes.
  1327.  
  1328. -E    exclude certain directory patterns, which must be in quotes.
  1329.  
  1330. -g    tape group name that the job should use. If no group is specified, the
  1331.      default tape group is used (the one with the lowest SCSI ID).
  1332.  
  1333. -i    include certain file patterns, which must be in quotes.
  1334.  
  1335. -I    include certain directory patterns, which must be in quotes.
  1336.  
  1337. -n    session number to restore.
  1338.  
  1339. -s    previously saved script path.
  1340.  
  1341. -t    tape name that the job should use.
  1342.  
  1343. ----------------------------------------------------------------------------
  1344.  
  1345.  
  1346. Appendix A
  1347.  
  1348. Troubleshooting
  1349.  
  1350. This appendix describes the most common problems that you might encounter
  1351. while installing and starting SCO ARCserve/Open from Cheyenne and provides
  1352. possible solutions.
  1353.  
  1354. Most of the problems that you may encounter, especially when using SCSI host
  1355. adapters, are hardware-related.
  1356.  
  1357. Two important points to consider when tracking down hardware problems are:
  1358.  
  1359.    * Make sure your hardware is functional. This includes the host adapter
  1360.      card, the cables, and the tape drive itself. If you can, test your
  1361.      hardware by connecting it to a system that you know works.
  1362.  
  1363.    * Make sure the hardware is configured properly. This includes setting
  1364.      the proper switches on the controller card (according to the
  1365.      manufacturer's instructions) and making sure the SCSI bus is terminated
  1366.      properly at both ends.
  1367.  
  1368.  
  1369. -------------------------------------------------------------------------------
  1370.  Problem                | Solution
  1371. -------------------------------------------------------------------------------
  1372.                         | This message is normal during system startup. The
  1373.                         | software scans the SCSI bus to look for tape drives
  1374.                         | and changers. Some host adapter drivers report a
  1375.                         | NOTICE or an error if there is no device attached
  1376.                         | to a particular SCSI ID while scanning for devices.
  1377.                         |
  1378.  During system startup, | If you see these messages scrolling by after the
  1379.  I get a SCSI bus       | system is already up, immediately run astop. This
  1380.  selection timeout      | condition usually occurs when someone has switched
  1381.  error.                 | off a drive, disconnected a drive, or there is a
  1382.                         | loose SCSI cable.
  1383.                         |
  1384.                         | ---------------------------------------------------
  1385.                         | NOTE: It is a good idea to run astop before
  1386.                         | disconnecting SCSI devices.
  1387.                         | ---------------------------------------------------
  1388. ------------------------|----------------------------------------------------
  1389.                         | SCO ARCserve/Open's screens are designed to display
  1390.  When running the SCO   | optimally on systems with a VGA card capable of 256
  1391.  ARCserve/Open          | colors and with a resolution of at least 800x600.
  1392.  front-end, my windows  |
  1393.  exceed the screen size.| If you want to change the graphics resolution, make
  1394.                         | sure your VGA card supports the above resolution,
  1395.                         | then run SCOadmin video configuration manager.
  1396. ------------------------|----------------------------------------------------
  1397.                         | Make sure that all cards, cables, and devices are
  1398.                         | connected properly. If you installed a new card in
  1399.                         | your system before installing SCO ARCserve/Open,
  1400.                         | make sure it is seated properly in its slot. If
  1401.                         | that does not work, try putting the card in a
  1402.                         | different slot.
  1403.                         |
  1404.                         | Type astatus to see if the SCO ARCserve/Open
  1405.                         | tapesvr daemon is running.
  1406.                         |
  1407.                         | If you have multiple host adapter cards installed
  1408.                         | in your system, make sure your drive is connected
  1409.                         | to the first one.
  1410.                         |
  1411.                         | Make sure your SCSI bus is terminated properly.
  1412.                         | There must be two sets of terminating resistors,
  1413.                         | one at the beginning of the chain and one at the
  1414.                         | end. If you only have one drive connected to your
  1415.  I've installed SCO     | machine, then you have two devices on the SCSI bus;
  1416.  ARCserve/Open, but I'm | the host adapter card and the tape drive. Both the
  1417.  having trouble seeing  | host adapter card and the tape drive should be
  1418.  my tape drive(s).      | terminated.
  1419.                         |
  1420.                         | Make sure each SCSI device in the chain has a
  1421.                         | unique ID. If you have two tape drives attached to
  1422.                         | the SCSI bus, each with a SCSI ID of 2, chances are
  1423.                         | neither device will work. Set each drive to a
  1424.                         | unique SCSI ID.
  1425.                         |
  1426.                         | Make sure all the tape drives are turned on.
  1427.                         | Sometimes if you forget to turn on one device in a
  1428.                         | chain, the others will behave erratically.
  1429.                         |
  1430.                         | Make sure the jumper settings on your adapter board
  1431.                         | are correct. Check the documentation that came with
  1432.                         | the board to make sure the jumpers are set
  1433.                         | correctly for use with your hardware.
  1434.                         |
  1435.                         | Replace the cables you are using with ones you know
  1436.                         | are good. If the problem goes away, you know you
  1437.                         | had a bad cable.
  1438. ------------------------|----------------------------------------------------
  1439.                         | The ideal solution is to make sure your filesystem
  1440.                         | has plenty of free space.
  1441.                         |
  1442.                         | If you have tapes that are out of date, or that you
  1443.                         | no longer need, format them and re-use them. When
  1444.                         | you format a tape, the references to the files and
  1445.                         | sessions on that tape are removed from the
  1446.                         | database.
  1447.                         |
  1448.                         | You can calculate how much disk space you will need
  1449.  The SCO ARCserve/Open  | for the SCO ARCserve/Open database based on how
  1450.  database is getting    | much data you regularly back up.
  1451.  very large.            |
  1452.                         | The information that SCO ARCserve/Open records
  1453.                         | about each file that is backed up requires about 80
  1454.                         | bytes of space in the SCO ARCserve/Open database.
  1455.                         | If you back up 100,000 files every week, and re-use
  1456.                         | the same tapes each time you do it, you need about
  1457.                         | 8 MB of disk space (80x100,000) for the database.
  1458.                         |
  1459.                         | Another option is to relocate the database to a
  1460.                         | filesystem with more available disk space. See
  1461.                         | ``Relocating the SCO ARCserve/Open database'' for
  1462.                         | information on how to do this.
  1463.                         |
  1464. ----------------------------------------------------------------------------
  1465.  
  1466.  
  1467. Copyright
  1468.  
  1469. (C) 1994-1997 Cheyenne Software, Inc. All rights reserved.
  1470.  
  1471. (C) 1983-1997 The Santa Cruz Operation, Inc. All rights reserved.
  1472.  
  1473. This publication is protected under copyright laws and international
  1474. treaties.
  1475.  
  1476. Information in this document is subject to change without notice and does
  1477. not represent a commitment on the part of The Santa Cruz Operation, Inc.
  1478.  
  1479. Argus, Business/21, dbXtra, DiSCOver, Internet Way of Computing, IWoC,
  1480. Multiscreen, ODT, Open Desktop, Optimized For Internet Computing and its
  1481. logo, Panner, SCO, SCO ACE, SCO CIFS Bridge, SCO Doctor, SCO Doctor for
  1482. Networks, SCO Doctor Lite, SCO Global Access, the SCO logos, SCO MPX, SCO
  1483. MultiView, SCO Nihongo OpenServer, SCO OK, the SCO OK logo, SCO OpenServer,
  1484. SCO Open Server, SCO Portfolio, SCO POS System, SCO Premier Motif, SCO
  1485. TermLite, SCO ToolWare, SCOtopia, SCO Vision 97, SCO VisionFS, SCO Visual
  1486. Tcl, Skunkware, Tarantella, The Business Choice, The Santa Cruz Operation,
  1487. UnixWare, Universal Server, VP/ix, and Zones are trademarks or registered
  1488. trademarks of The Santa Cruz Operation, Inc. in the USA and other countries.
  1489. APC, SoftCare, and SoftTech are service marks of The Santa Cruz Operation,
  1490. Inc. Deskterm, Deskworks, IXI, IXI Desktop, the IXI logo, IXI Panorama,
  1491. Wintif, and X.desktop are trademarks or registered trademarks of IXI
  1492. Limited, a subsidiary of The Santa Cruz Operation, Inc. X.tra is a service
  1493. mark of IXI Limited. Codon, Devkit.Vision, Esprit, Kodon, PC-Connect,
  1494. SQL-Retriever, SuperVision, Super.Vision, TermVision, Term.Vision, Vision
  1495. Builder, Visionware, Visionware Direction, the Visionware logo, Visionware
  1496. SQL-Retriever, Visionware Super.Vision, the XV logo, XVision, and
  1497. X-Visionware are trademarks or registered trademarks of Visionware Limited,
  1498. a subsidiary of The Santa Cruz Operation, Inc. X/Open and UNIX are
  1499. registered trademarks and the X Device is a trademark of The Open Group in
  1500. the United States and other countries. Cheyenne and ARCserve are registered
  1501. trademarks of Cheyenne Software, Inc. Netscape, Netscape Navigator, Netscape
  1502. Communications Server, Netscape Commerce Server, Netscape Proxy Server,
  1503. Netscape FastTrack Server, Netscape Enterprise Server, Netscape SuiteSpot,
  1504. Netscape Catalog Server, Netscape News Server, Netscape Mail Server, and
  1505. Netscape Navigator Gold are trademarks of Netscape Communications
  1506. Corporation. NFS was developed by Legent Corporation (formerly Lachman
  1507. Associates, Inc.) based on LACHMAN SYSTEM V NFS. LACHMAN is a trademark of
  1508. Legent Corporation. NFS is a trademark of Sun Microsystems, Inc. TCP/IP was
  1509. developed by Legent Corporation (formerly Lachman Associates, Inc.) based on
  1510. LACHMAN SYSTEM V STREAMS TCP, a joint development of Lachman Associates and
  1511. Convergent Technologies. MPX was developed by Corollary, Inc. VP/ix is a
  1512. product developed and licensed by Phoenix Technologies, Ltd/INTERACTIVE
  1513. Systems Corporation. XRemote is a registered trademark of Network Computing
  1514. Devices, Inc. Oracle is a registered trademark of Oracle Corporation,
  1515. Redwood City, California. Java is a trademark of Sun Microsystems, Inc.
  1516. Adobe is a trademark of Adobe Systems Incorporated and is registered in the
  1517. U.S. Patent and Trademark Office. Reliant is a registered trademark of
  1518. Siemens Pyramid Information Systems, Inc. (formerly Pyramid Technology
  1519. Corporation). All other brand and product names are or may be trademarks of,
  1520. and are used to identify products or services of, their respective owners.
  1521. The Santa Cruz Operation, Inc. reserves the right to change or modify any of
  1522. the product or service specifications or features described herein without
  1523. notice. This document is for information only. SCO makes no express or
  1524. implied representations or warranties in this document.
  1525.  
  1526. The Santa Cruz Operation, Inc. and SCO Skunkware are not related to,
  1527. affiliated with or licensed by the famous Lockheed Martin Skunk Works«, the
  1528. creator of the F-117 Stealth Fighter, SR-71, U-2, VenturestarTM, DarkstarTM,
  1529. and other pioneering air and spacecraft.
  1530.  
  1531. The SCO software that accompanies this publication is commercial computer
  1532. software and, together with any related documentation, is subject to the
  1533. restrictions on US Government use as set forth below. If this procurement is
  1534. for a DOD agency, the following DFAR Restricted Rights Legend applies:
  1535.  
  1536. RESTRICTED RIGHTS LEGEND: When licensed to a U.S., State, or Local
  1537. Government, all Software produced by SCO is commercial computer software as
  1538. defined in FAR 12.212, and has been developed exclusively at private
  1539. expense. All technical data, or SCO commercial computer
  1540. software/documentation is subject to the provisions of FAR 12.211 -
  1541. "Technical Data", and FAR 12.212 - "Computer Software" respectively, or
  1542. clauses providing SCO equivalent protections in DFARS or other agency
  1543. specific regulations. Manufacturer: The Santa Cruz Operation, Inc., 400
  1544. Encinal Street, Santa Cruz, California 95060.
  1545.  
  1546. The copyrighted software that accompanies this manual is licensed to the End
  1547. User only for use in strict accordance with the two End User License
  1548. Agreements. All such Agreements should be read carefully before commencing
  1549. use of the software.
  1550.  
  1551. Document Version: SCO ARCserve/Open 2.2.0
  1552. December 1997
  1553.