home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 30 fixes_v / 30-fixes_v.zip / ip20665.lna / README.DLN < prev   
Text File  |  1996-03-16  |  33KB  |  736 lines
  1. ===================================================
  2. Adstar(*) Distributed Storage Manager:
  3.     Lotus Notes(**) Backup Agent for OS/2(*)
  4.  
  5.  Licensed Materials - Property of IBM
  6.  (C) Copyright IBM Corporation 1990, 1996. All rights reserved.
  7.  Refer to Copyright Instructions Form Number G120-2083
  8.  
  9. Welcome to the ADSM Lotus Notes(**) Backup Agent.
  10.  
  11. This README.DLN file contains information you need for installing
  12. the ADSM Lotus Notes(**) Backup Agent as well as information that 
  13. was not available for our printed publications. 
  14.  
  15. ADSM Version 2 Release 1 Level 0.3
  16. PTF IP20665
  17. ====================================================
  18.  
  19. This README.DLN file is divided into the following categories:
  20.  
  21.       o  Before You Install the ADSM Lotus Notes(**) Backup Agent
  22.       o  Getting Help
  23.       o  Installing the ADSM Lotus Notes(**) Backup Agent
  24.       o  Late-Breaking News
  25.          - Limitations
  26.          - Document Updates
  27.          - General Information
  28.          - Known Problems
  29.          - Fix Information 
  30.       o  Trademarks
  31. ====================================================
  32.  
  33. ====================================================
  34. Before You Install the ADSM Lotus Notes(**) Backup Agent
  35. ====================================================
  36.  
  37. Software Requirements
  38. ---------------------
  39.  
  40. - OS/2(*) 2.0 or later
  41.  
  42. - Lotus Notes(**) 3.x client or Lotus Notes(**) 3.x server
  43.  
  44. - This package requires that the ADSM API for OS/2(*) be  
  45.    be installed. This API is available with ADSM OS/2(*) Client V2.
  46.  
  47.    NOTE: While this agent will run with version 1 ADSM API, use of
  48.    the latest available ADSM API version 2 package is highly recommended.
  49.    If a version 1 ADSM API library is used, it should be the latest
  50.    version 1 library available. 
  51.  
  52. - The agent can run with either a version 1 or a version 2
  53.    ADSM server. 
  54.  
  55. Hardware Requirements
  56. ----------------------
  57.  
  58. - Any appropriately configured Intel(**) 80386 or higher
  59.   hardware platform with at least 1.2 MB of disk storage
  60.   and 12 MB of memory. Recommend Intel(**) 80486 or
  61.   higher. 
  62.  
  63. Note:
  64. ----
  65.  
  66. -  For futher information on system requirements, please refer to 
  67.    ADSM Installing the Clients, version 2 (SH26-4049-00).
  68.  
  69. ====================================================
  70. Getting Help
  71. ====================================================
  72.  
  73.   To receive service and technical support for ADSM:
  74.   -----------------------------------------------
  75.  
  76.   o Contact your ADSM administrator.  This should be your first
  77.     step when having problems with ADSM.
  78.  
  79.   o Your ADSM administrator will know how to contact IBM 
  80.     for Technical Support on your behalf.
  81.  
  82.   o For the latest information about ADSM, visit the ADSM home page on
  83.      the World Wide Web. The URL is:
  84.  
  85.      http://www.storage.ibm.com/storage/software/adsm/adsmhome.htm
  86.     
  87. To participate in user discussions of ADSM:
  88.  
  89.   o Subscribe to IBM's officially supported ADSM forum on CompuServe(**).
  90.     This is located in the IBM Storage Systems Forum (GO IBMSTORAGE ADSM)
  91.  
  92.   o Subscribe to an Internet listserv forum for ADSM
  93.     This is not officially supported by IBM, but IBM support people
  94.     do participate in the discussions, along with other ADSM users.
  95.  
  96.     You can subscribe by sending a note to listserv@vm.marist.edu
  97.     that contains:
  98.  
  99.          SUBSCRIBE ADSM-L your_name
  100.  
  101.     in the messages body, where your_name is your first and last name.
  102.  
  103. IBM also supports an anonymous FTP server where you can find
  104. PTF maintenance and other ADSM-related materials.  Three other
  105. anonymous servers are unofficially maintained by non-IBM volunteers.
  106. These servers are:
  107.  
  108.        index.storsys.ibm.com      (primary - California, IBM)
  109.        ftp.rx.uni-karlsruhe.de    (mirror  - Germany)
  110.        ftp.wu-wien.ac.at          (mirror  - Austria)
  111.        ftp.cac.psu.edu            (mirror  - Pennsylvania)
  112.  
  113. ====================================================
  114. Installing the ADSM Lotus Notes(**) Backup Agent
  115. ====================================================
  116.  
  117. 1)Installation information can be found in the manual 
  118. "ADSM: Installing the Clients, Version 2 (SH26-4049-00)".  
  119. The major points, however, are given below:
  120.    
  121.    a) The ADSM API should already have been successfully
  122.         installed on your machine. The API is available with the
  123.         ADSM OS/2(*) Client, version 2.
  124.  
  125.    b) To begin installation of the agent insert the installation
  126.        diskette into the a: drive and enter 
  127.  
  128.               a:\install
  129.  
  130.   c) The installation program asks you for two directories.
  131.       The first is the directory in which the files of the agent
  132.       will reside. The second is the directory in which the 
  133.       Lotus Notes(**) notes.ini file ALREADY resides. It is extremely
  134.       important to specify the correct path for the notes.ini
  135.       directory. Errors may occur if this directory is not specified
  136.       correctly.
  137.           
  138.       Allowing the installation program to update the 
  139.       config.sys file automatically, also enables it to update
  140.       the notes.ini file automatically. If automatic update is not
  141.       chosen, then you will need to update both the notes.ini file
  142.       and the config.sys file manually.
  143.  
  144.   d) The update to the config.sys file is just a matter of including
  145.       the directory in which the agent resides in the PATH
  146.       LIBPATH, and HELP.
  147.    
  148.       The update to the notes.ini file is, essentially, to add the following
  149.       line to that file:
  150.  
  151.            AddInMenus=<pathname of the dsmnotes.dll file>
  152.    
  153.      An example would be:
  154.  
  155.            AddInMenus=c:\dsmnotes\dsmnotes.dll
  156.  
  157.      The dsmnotes.dll file is part of the agent.
  158.  
  159.    e) A list of the files belonging to the agent is as follows:
  160.  
  161.       File Name                Description
  162.  
  163.       dsmnotes.exe           executable for dsmnotes command
  164.       dsmnotes.dll            Agent dynamic link library
  165.       dsmnoted.dll            Agent resources
  166.       dsmln.hlp                Agent help file
  167.       optionsl.doc             Summary of applicable ADSM options
  168.       readme.dln              This file
  169.  
  170. 2) The ADSM Notes(**) agent should have its own dsm.opt file. This file is separate
  171. from the dsm.opt file for the ADSM Backup/Archive client. 
  172.  
  173. 3) It is likely that an ADSM Client and an ADSM Lotus Notes(**) agent will
  174. reside on the same machine. In this situation, a separate node
  175. name should be given to the ADSM Lotus Notes(**) agent. 
  176.  
  177. Installing the ADSM Lotus Notes(**) Backup Agent on OS/2(*) using CID
  178. ___________________________________________________________
  179.  
  180. CID is an OS/2(*) based set of components that allows you to automate
  181. the software installation. An administrator who wants to let
  182. users install ADSM on their local machines through a LAN,
  183. instead of diskettes, can put all of the installation files into a
  184. single directory on a remotely attached disk or file server and
  185. make the necessary changes to the response and command files. 
  186. Users can then link their workstations to theat disk or file server
  187. and perform the installation by executing the CIDINSTL command 
  188. file.
  189.  
  190. Two files (CIDINSTL.CMD and ADSMLRESP.DAT) are part of the
  191. installation package and can be edited to fit individual requirements.
  192.  
  193. To prepare for the CID installation, the administrator of the
  194. file server must do the following:
  195.  
  196. 1. Copy the ADSM Lotus Notes(**) Backup Agent diskette to the
  197.    file server. Use the COPY or XCOPY command. 
  198.  
  199. 2. Edit the CIDINSTL.CMD command file to:
  200.   - Change the InstallFilesDirectory variable so that it points
  201.     to the directory  on the file server that contains the ADSM Agent
  202.     files. 
  203.  
  204.  - Change the ErrorLog variable to the path and file name you
  205.    want to use for the error log file. 
  206.  
  207. 3. If necessary, edit the ADSMLRESP.DAT response file (which is
  208.    used in conjunction with the CIDINSTL.CMD to change the following:
  209.  
  210.    - FILE - The directory in which to install the ADSM Agent files. 
  211.    - WORK - The directory in which to install the DLL files
  212.   - COMP - The components you want installed
  213.   - CFGUPDATE - Whether you want the CONFIG.SYS file updated
  214.   - DELETEBACKUP - Whether you want to delete a backup copy
  215.      of the agent (if it has been previously installed)
  216.   - OVERWRITE - Whether you want to overwrite existing files
  217.   - SAVEBACKUP - WHether you want to save a backup copy of the
  218.     client (if it has been previously installed)
  219.  
  220. The OS/2(*) user can now attach to the remote disk or file server and
  221. start CIDINST.CMD to install the ADSM Notes(**) Backup Agent. 
  222.  
  223. This procedure assumes that the CID environment is already set up. 
  224. To start CIDINSTL.CMD, either change your working directory to its 
  225. location on the file server or add the location to the beginning of
  226. the PATH statement:
  227.  
  228.    SET PATH=X:\dsmlinst;%PATH%
  229.  
  230. ====================================================
  231. "Late-Breaking" News
  232. ====================================================
  233.  
  234. New features in level 0.3 are:
  235.  
  236. 1) Wildcard restore
  237. 2) "Verbose" option for the command line
  238. 3) New log.dsm messages
  239.  
  240. Wildcard restore
  241. ----------------
  242.  
  243.      The command line "dsmnotes restore"  function
  244. now accepts a wildcard when merging data into an
  245. existing database file. The intent of this support is to address
  246. the situation where multiple Notes(**) database files have been restored
  247. through the ADSM backup/archive client, and there is a desire to
  248. restore incremental backup copies of Notes(**) documents on top of those
  249. files.  The rules for a wildcard on this restore command are the same
  250. as those for a wildcare on a "dsmnotes incr" command. A lone asterisk
  251. indicates that all database files in the Notes(**) data directory will be
  252. processed. Subdirectories are included in the processing only with the
  253. "-subdir=yes" option. A directory path appended with an asterisk indicates
  254. that all the databases in that directory will be processed.
  255.  
  256.      The following is an example of a command that restores all the
  257. incrementally backed up notes to all the databases in the Notes(**)
  258. data directory. The restore will include every database in that directory,
  259. regardless of whether or not the file was restored from the ADSM
  260. backup/archive client, so care should be taken to ensure that a
  261. database is not inadvertantly overwritten.
  262.  
  263.       dsmnotes restore -merge=y -fromdate=01/28/96 -todate=02/03/96 *
  264.  
  265.      The following is an example of a command that restores all the
  266. incrementally backed up notes to all the database in the current
  267. directory.
  268.  
  269.      dsmnotes restore -merge=y -fromdate=01/28/96 -todate=02/03/96 .\*
  270.  
  271.      The following is an example of a command that restores all the
  272. incrementally backed up notes to the mail subdirectory in the Notes(**)
  273. data directory. It is assumed that the Notes(**) data directory is d:\notes\data.
  274.  
  275.      dsmnotes restore -merge=y -fromdate=01/28/96 -todate=02/03/96
  276.                       d:\notes\data\mail\*
  277.  
  278.  
  279. "Verbose" Option
  280. ----------------
  281.  
  282.      A new DSMNOTES option has been added to the notes.ini file the
  283. keyword is DSMNOTES_STATS. The choices of settings are:
  284.  
  285.      DSMNOTES_STATS=verbose
  286.  
  287. or
  288.  
  289.      DSMNOTES_STATS=quiet
  290.  
  291.      The default is "quiet."
  292.  
  293.      If DSMNOTES_STATS=verbose is specified in the notes.ini file,
  294. then all the "dsmnotes" command line functions will send messages
  295. to the screen, indicating the number of documents that have been
  296. transferred between the workstation and the ADSM server. The default
  297. is for no status to be shown.
  298.  
  299.      Two types of indicators may appear on the screen: (1) One or more
  300. dots ('.') may appear on the screen to indicate processing is continuing.
  301. Depending on the environment, there may be delays even between dots.
  302. For example, searches of very large Notes(**) databases for deleted documents
  303. can result in apparent delays between feedback to the user. There may
  304. also be delays when waiting for offline media to be mounted.
  305. (2) Messages will be sent to the screen to indicate document transfer.
  306. These messages may also be subject to delay due to offline media mount
  307. waits.
  308.  
  309.      It should be noted that the display of status messages will impact
  310. the performance of both an incremental backup and a restore, so if the
  311. status messages are not required, there is an advantage to turning them
  312. off.
  313.  
  314. New log.dsm Messages
  315. --------------------
  316.  
  317.     In conjunction with the new status option, there are new log messages
  318. that are writtein to the log.dsm file. Regardless of whether or not
  319. "DSMNOTES_STATS=verbose" is specified, The following new information
  320. will be written to the log.dsm file for each incremental backup:
  321.  
  322. For incremental backup of a single database:
  323.  
  324.      Summary:
  325.      Database: d:\notes\data\test\abc.nsf
  326.      Documents backed up: 100, documents deleted: 1
  327.      Total number of bytes sent: 60873
  328.      dsmnotes incr OK
  329.  
  330. For incremental backup of a multiple database (i.e. using a wildcard):
  331.  
  332.      Summary:
  333.      Database: d\notes\data\test\abc.nsf
  334.      Documents backed up: 100, documents deleted: 1
  335.      Database: d\notes\data\test\def.nsf
  336.      Documents backed up: 500, documents deleted: 1
  337.      Total number of documents backed up: 600
  338.      Total number of documents deleted: 2
  339.      Total number of bytes sent: 1256.1 KB
  340.      dsmnotes incr OK
  341.  
  342. For restoring notes to a single database:
  343.  
  344.      Summary:
  345.      Database: d:\notes\data\test\abc.nsf
  346.      Documents restored: 28, overwritten: 0, deletion stubs overwritten: 0
  347.  (dsmnotes restore OK)
  348.  
  349. For restoring notes to multiple databases (i.e. using a wildcard):
  350.  
  351.      Summary:
  352.      Database: d:\notes\data\test\abc.nsf
  353.      Documents restored: 28, overwritten: 0, deletion stubs overwritten: 0
  354.      Database: d:\notes\data\test\xyz.nsf
  355.      Documents restored: 78, overwritten: 0, deletion stubs overwritten: 0
  356.  (dsmnotes restore OK)
  357.  
  358. NOTE:  There is currently no provision to trim the log.dsm file automatically.
  359. The file should be monitored and trimmed, deleted, or archived regularly
  360. to control growth of the file.
  361.  
  362.      For both the log.dsm messages and for any status messages from
  363. the ADSM Notes(**) Agent, a "document" can be considered any object from
  364. a Notes(**) database that has either data or design information associated
  365. with it. It is this data or design information that will be backed up
  366. in a backup storage pool on the ADSM server.
  367.  
  368. Changed Message
  369. ---------------
  370.  
  371.      ANS0934W DSMNOTES_AUTO_PW set in notes.ini but no password files
  372.  
  373. Explanation: The notes.ini file contains the environment variable and
  374. setting "DSMNOTES_AUTO_PW=on", but no dsmnotes.pwd file was found.
  375. The first time this variable is set, the ADSM password must be specified
  376. once to establish the file that will contain the automatically maintained
  377. password. This specification can occur either through the "-adsmpw"
  378. option on the command line or through setting the password via the
  379. ADSM password dialog box.
  380.  
  381. System Action: Since this message is only a warning, the Notes(**) Agent
  382. will continue to process. If the ADSM server requires a password, then
  383. processing will ultimately be stopped because no password was provided.
  384. If the ADSM server does not require a password, then processing will
  385. continue.
  386.  
  387. User Response: If the password needs to be set initially for the
  388. password handler, then use either the password dialog box on the GUI
  389. interface or use the -adsmpw option on the dsmnotes command. If the
  390. automatic password handler is not needed, then remove the DSMNOTES_AUTO_PW
  391. entry from the notes.ini file or set DSMNOTES_AUTO_PW to "off".
  392.  
  393.      The above messages replaces message "ANS0934E ADSM password needed."
  394.  
  395. ====================================================
  396. Limitations:
  397. ====================================================
  398.  
  399. 1) The automatic password handler for this agent is valid for
  400. only a single ADSM server.
  401.  
  402. Performance Notes:
  403. ------------------
  404.  
  405. 1) Backing up or restoring a Notes(**) database on a notes level is 
  406. considerably slower than processing a database on a file level.
  407. Incremental back up will work best for databases that have
  408. a small percentage of changing notes over a period of time.
  409.  
  410. 2) Long merges or rebuilds can tie up a screen, if they are invoked from
  411. the Lotus Notes(**) Workspace. For such actions that are likely to take
  412. a long time, it is preferable to invoke the action from the command line.  
  413.      
  414. ====================================================
  415. Documentation Updates:
  416. ====================================================
  417.  
  418. 1) The ADSM Lotus Notes(**) Backup Agent does not offer Open Registration
  419. of an ADSM node name. The ADSM administrator should register a unique
  420. node name for the agent.
  421.  
  422. 2) Error and informational messages on agent functions executed either through
  423. the dsmnotes command or through the Notes(**) workspace can be divided into
  424. three catgories: (1) Messages from the ADSM Lotus Notes(**) agent, (2) Messages
  425. from Lotus Notes(**), and (3) message from ADSM.  Messages from the ADSM 
  426. Lotus Notes(**) agent display a message number that can be referenced in 
  427. the ADSM Messages guide. Messages from Lotus Notes(**) are prefixed with
  428. "Notes: ". These messages can be referenced in Lotus online help or other
  429. references that come with Lotus Notes(**). Messages from either ADSM or the
  430. agent have message numbers that can be referenced in the ADSM Messages
  431. manual.
  432.  
  433. 3) The option "-updateall=y/n" can be specified only if
  434. the "-merge=y" option is also specified. If the user is merging data
  435. into an existing database, then he can specify the "-updateall=y" 
  436. option to ensure that all the notes in the database are "touched"
  437. to ensure that they have the current date/time as their modification
  438. date/time.  The effect is as if someone has "cut and pasted" all
  439. the notes back into the database. An example of a dsmnotes 
  440. incremental backup command that uses this option is as follows:
  441.  
  442.      dsmnotes restore -adsmpw=pw -merge=y -updateall=y -fromdate=07/01/95
  443.                          -todate=07/15/95 mktg1.nsf
  444.  
  445. In this example, it is assumed that the database file mktg1.nsf was restored
  446. through the ADSM client, and the dsmnotes command is being used to 
  447. restore more recent backup copies of notes on top of that file. Since
  448. processing all the notes in a database can be very costly, this option should 
  449. be used only when a restored database truly needs to appear as a 
  450. recently created database.     
  451.  
  452. 4) On a "dsmnotes incr" command, an asterisk can be specified for the
  453. pathname of the database file to indicate that all database files in 
  454. the Notes(**) data directory are to be backed up incrementally. An example
  455. of the syntax is:
  456.  
  457.      dsmnotes incr -adsmpw=pw *
  458.  
  459. In addition, the -subdir=y option can be used to indicate that subdirectories
  460. should be processed as well. Some care should be taken in processing 
  461. multiple databases, however, because of performance implications.
  462.  
  463. 5) Use of the Include-Exclude list in the dsm.opt file is different from that
  464. for the ADSM Backup/Archive Client. Notes(**) database files can be excluded
  465. from an incremental backup with the following format:
  466.  
  467.       EXCLUDE  ?:\notes\mydata\abc.nsf\*
  468.  
  469.      If the database to be excluded  is in the Notes(**) data directory, then only the 
  470. database name is specified. For example,
  471.  
  472.      EXCLUDE ?:\abc.nsf\*
  473.  
  474.      If the database to be excluded is in a subdirectory of the Notes(**) data directory,
  475. then only the subdirectory name and the database name is specified. For example,
  476. for database c:\notes\data\example\abc.nsf, where the Notes(**) data directory is
  477. c:\notes\data, the statement to exclude this database is 
  478.  
  479.      EXCLUDE ?:\example\abc.nsf\*     
  480.                 or
  481.      EXCLUDE ?:\...\example\abc.nsf\* 
  482.    
  483.      The INCLUDE option, however, can be used only to include or assign managment
  484. classes to all Notes(**) databases affected by the incremental backup. For 
  485. example,
  486.  
  487.      INCLUDE ?:*   mgmt1
  488.  
  489. causes all the Notes(**) databases that are incrementally backed up to be assigned
  490. the management class "mgmt1." Individual databases cannot be assigned different
  491. management classes during a single incremental backup session. 
  492.  
  493.      Once incremental backup of a Notes(**) database begins, it is important not
  494. to change the management class on any further incremental backups of that same
  495. database.  The reason is that the management class is assigned to each note as 
  496. it is backed up.  if management classes with different "retain" values are assigned
  497. to notes belonging to the same database, then rebuilding of an entire database
  498. may not be possible.
  499.  
  500. In the include/exclude statement for the Notes(**) agent, the following should be 
  501. noted:
  502.     
  503.      - There is no drive letter as with files in a filesystem, so
  504.        the drive letter in the include/exclude statement should always be "?".
  505.  
  506.     - Use of an include statement applies to all the data in a backup session,
  507.        as noted above.
  508.  
  509.     - The include/exclude statements must include a wildcard character ('*')
  510.        to imply that the statement applies to all notes in the specified database.   
  511.  
  512. 6) The "days" option on both the dsmnotes command and the
  513.     Notes(**) workspace interface indicates periods of time back from
  514.     the current date/time. For example, "-days=1" means the past
  515.     24 hours. Thus, "-days=2" means the past 48 hours or, roughly,
  516.     the past two days. Hence, the command "dsmnotes restdel -days=1 .\abc.nsf"
  517.     means restore all the notes in the database abc.nsf in my current directory
  518.     that have been deleted within the past 24 hours.
  519.  
  520. Rebuilding databases with unsorted views
  521. _______________________________________
  522.  
  523.     It is possible that an unsorted view in a rebuilt database will show
  524. documents in a different order from what would be seen in the original
  525. database. A sorted view will not be affected.  
  526.  
  527. If an ADSM Backup/Archive Client is also Installed on the Workstation
  528. _______________________________________________________________
  529.  
  530.  
  531.      There is no interoperability between the ADSM Notes(**) agent and the ADSM
  532. backup/archive client. Hence, the agent is not aware of actions done
  533. by the backup/archive client and vice versa. 
  534.  
  535.      Even so, the user should give a nodename to his ADSM Notes(**) agent that is
  536. different from that for the ADSM client that resides on the same machine. 
  537.  
  538.      On the other hand, it is desirable to have both the ADSM Notes(**) agent
  539. and the ADSM client running on one machine (each  having a unique nodename
  540. in the appropriate dsm.opt file). The reason is that each provides capabilities
  541. that the other does not. The ADSM client is capable of backing up/restoring
  542. or archiving/retrieving an entire Notes(**) database.  The ADSM Notes(**) agent is 
  543. capable of backing up and restoring smaller pieces of data (notes). Actually,
  544. without strict control of the environment, it is possible that the agent will not
  545. be able to restore certain versions of an entire Notes(**) database. At times,
  546. either the ADSM backup/archive client or the ADSM Notes(**) agent will be a more
  547. appropriate solution. In addition, the ADSM backup/archive client can back up
  548. the files on the machine, that are not Notes(**) database files. 
  549.  
  550.      Methods can be used to take advantage of both the ADSM backup/archive
  551. client and the ADSM Notes(**) agent for a Notes(**) database.  The alternative to
  552. relying only on backup copies of notes to back up an entier database is to use
  553. both the client and agent together.  Backing up Notes(**) database files with the 
  554. ADSM backup/archive client periodically and then backing up the databases
  555. incrementally more frequently is a method to avoid restoring data that has
  556. been spread out among different media over a long period of time.  This method
  557. also helps to avoid "rolled off" data because the data backed up through the
  558. ADSM client always provides a "latest copy possible" copy of the database. 
  559.  
  560.      An example of this method would be to back up a database through the 
  561. ADSM client once a month and then incrementally back up the database once
  562. a day. 
  563.  
  564.  
  565. What Kind of Databases to Back Up Incrementally
  566.  
  567.      Maximum benefit from incrementally backing up a Notes(**) database is likely to
  568. occur with database in which only a small percentage of notes change over
  569. time. A database in which a large percentage of notes change is a better candidate
  570. for the ADSM client, which can back up an restore entire files more efficiently. 
  571.  
  572.      Incremental backup only applies to Lotus Notes(**) .NSF databases.
  573.  
  574. ====================================================
  575. Information for both ADSM Administrators and Notes(**) Users
  576. ====================================================
  577.  
  578.  
  579. Filespaces
  580.  
  581.      While the ADSM backup/archive client backs up files in filespaces
  582. to the ADSM server, the ADSM Notes(**) agent backs up notes in database to the 
  583. ADSM server.  On the ADSM server, a list of filespaces for the Notes(**) Agent
  584. nodename will show a list of the Notes(**) database that have notes backed up on 
  585. that ADSM server. 
  586.  
  587. Management Classes
  588.  
  589.      Since each note is backed up as an individual object, it is important that
  590. a single management class be assigned to all the notes in a given Notes(**) 
  591. database.  If all notes in a database are not managed the same way, then
  592. rebuilding an entire database from backup copies of single notes cannot
  593. be guaranteed. 
  594.  
  595.      For optimal control in managing backup copies of notes, a separate
  596. ADSM domain should be established for the nodes running the ADSM Notes(**) agent.
  597.  
  598. Performance Considerations
  599.  
  600.      Backup of an entire Notes(**) database through incremental backup will be
  601. significantly slower than backup of the database file through an ADSM client
  602. the first time the incremental backup of a database is taken.  The extra processing
  603. occurs because the agent needs to interface with Lotus Notes(**) to break down
  604. the contents of the database so that single notes can be restored later.  The
  605. user will need to decide whether backup/restore through the agent or through
  606. the ADSM client better serves his purposes for a particular database. 
  607.  
  608.      Since the first incremental backup of a Notes(**) database can require more
  609. processing, the user will need to decide wiether it is prudent to avoid using
  610. wildcards for an incremental backup or, rather, work with individual databases
  611. the first time around.  As for restore performance, it may be desriable for the user
  612. to back up Notes(**) database files periodically through the ADSM client (e.g. once
  613. per month) and then take more frequent incremental backups of each Notes(**)
  614. database (e.g. once per day).  The reason is that backup copies of notes might be
  615. spread to different media on the ADSM server, over time.  A very large Notes(**)
  616. database might have both very old and very recent data, whose backup data
  617. are spread out among different volujes.  The periodic backup of the entire file
  618. offers an alternative to a database rebuild that might cause multiple media
  619. mounts. 
  620.  
  621. Collocation
  622.  
  623.      Of course, ADSM collocation will also play a part in deciding the best setup for 
  624. each installation (See the ADSM Administrator's Guide for more information on 
  625. collocation).  Since collocation is beneficial when a large number of objects need 
  626. to be restored together, its use is helpful for "rebuild" and "merge" capabilities.
  627.  
  628. Restoring Deletion Stubs
  629.  
  630.      At least two versions, that is, an active version and at least one inactive version
  631. should exist in your ADSM Notes(**) agent copy group, so you can restore deletion stubs. 
  632.  
  633. What Happens Over Time
  634.  
  635.      It is the combination of the way backup copies of notes are maintained on the 
  636. ADSM server and the nature of the Notes(**) database itself that will determine if
  637. a particular version of the database can be rebuilt.
  638.  
  639.      Backup version of notes on an ADSM server are similar to backup versions of 
  640. files on an ADSM server.  For backup copies of files, the filespace in which the 
  641. copies reside correspones to a file system.  For backup coies of notes, the
  642. filespace in which a set of copies reside corresponds to a Notes(**) database.
  643.  
  644.      The way in which backup copies are maintained over time will influence the
  645. ability of a user to rebuild an entire Notes(**) database through backup coies of notes.
  646.  
  647.      To explain the concept, we will imagine a Notes(**) database that has only two 
  648. notes in it.  We will name the notes "A" and "B" Note A is update frequently. 
  649. Note B seldom changes.  assume the database is backed up incrementally.  Also
  650. assume the ADSM server keeps one active backup copy and one inactive backup
  651. copy of each notes.  On day 1, after the very first incremental backup, there
  652. is an active copy of both note A and note B on the ADSM serv.  On day 2, say 
  653. note A gets updated in the Notes(**) database, but note B does not. At the end of 
  654. day 2, the second incremental backup takes place.  Now there are 2 copies of
  655. note A and one copy of note B on the server. On day 3, notes A gets updated 
  656. again, and, after the update, an incremental backup takes place.  Since we 
  657. can keep a maximum of 2 copies of each note on the ADSM server, the backup
  658. copy of note A taken on day 2 is rolled off. 
  659.  
  660.      So, in this scenario, what can we restore? We can rebuild the database back
  661. to a "day 3" version, since we have backup copies of each note as it was on that
  662. day.  Similarly, we can rebuild the database back to a "day 2" version.  We cannot,
  663. however, rebuild a "day 1" version of the entire database because the "day 1"
  664. version of note A was rolled off and is no longer available form the ADSM server.
  665. If we wanted tor restore a "day 1" version only of note B, we could do that  
  666. because we still have a "day 1" version of note B on the server. 
  667.  
  668.      The above scenario suggest that it will be desirable to keep a particular number
  669. of backup versions of notes on the ADSM server, depending on how far back in time
  670. the user may want to rebuild a database.  Since the rules for managing these
  671. backup copies may be different from the rules for managing backup copies of 
  672. files or other data, the ADSM administrator may want to set up a separate domain
  673. with a suitable default management class specifically for Notes(**) data.  He might
  674. also want to use collocation on the ADSM server. 
  675.  
  676. ====================================================  
  677. General Information:
  678. ====================================================
  679.  
  680. A redbook on the ADSM Lotus Notes(**) Backup Agent is available.
  681. The book number is SG24-4534. 
  682.  
  683. ====================================================
  684. Known Problems:
  685. ====================================================
  686.  
  687. 1) On OS/2 Warp(*), a "dsmnotes incr" backup command that specifies 
  688. the root directory of a different drive from the current drive will 
  689. not search all the subdiretories for Notes(**) databases to back up. 
  690. For example, "dsmnotes incr -subdir=y c:\*" will not traverse
  691. subdirectories when issued from drive d. Subdirectories will be
  692. traversed, if any directory other than root is specified.
  693.  
  694. 2) Database links that are backed up through the "dsmnotes incr"
  695. command should be identifed to the command by its physical
  696. location, rather than by its link file name in the Notes(**) data
  697. directory. Directory links do not have this restriction. 
  698.  
  699. ====================================================  
  700. Fix Information:
  701. ====================================================
  702.  
  703. 1) IC12350 - When trying , through the GUI, to restore a deleted 
  704. document that was backed up on tape, the agent did not wait
  705. for the tape mount. The "days" value was also not being picked up
  706. properly.
  707.  
  708. 2) IC12649 (Internal APAR)
  709.   a) Wildcard restore
  710.   b) "Verbose" option for the command line
  711.   c) New log.dsm messages
  712.  
  713.    See "Late-Breaking News" above for details on each
  714. of these items.
  715.  
  716. ====================================================
  717. Trademarks
  718. ====================================================
  719.  
  720.  (*) - Trademark or Registered trademark of the International Business Machine
  721.          Corporation.
  722.  
  723.  (**) - The following terms are trademarks of the indicated company:
  724.  
  725.            Lotus, Lotus Notes: Lotus Development Corpporation, an IBM Company
  726.            Intel: intel Corporation
  727.            CompuServe: Compuserve
  728.            
  729.      
  730.      
  731.   
  732.      
  733.  
  734.  
  735.   
  736.