home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / dommagr.zip / READ.ME < prev   
Text File  |  1996-02-02  |  17KB  |  412 lines
  1. Welcome to the ibex Domain Manager
  2. ----------------------------------
  3.  
  4. This document contains last minute information that is not contained in 
  5. the printed documentation. Please take the time to review all of this 
  6. information carefully. If there are discrepancies between the written 
  7. documentation and this document, the information in READ.ME is correct.
  8.  
  9. The build contained on this CD is defined in \IDM101\OS2\CDINST\IDMDSC.DSC.
  10.  
  11. We recommend that you read chapters 1 and 2 of the manual before installing.
  12.  
  13. To install ibex DomainManager, start \IDM101\OS2\CDINST\INSTALL.EXE.
  14. Install asks you for the following paths:
  15.  
  16.    IDM program directory  :  The path to which the iDM executables are copied to.
  17.    NOTES program dirextory:  The path to your notes executables
  18.    NOTES data directory:     The path to the Notes databases
  19.  
  20. The database IDM-UG.NSF, the Users Guide, contains the complete electronic 
  21. version of the printed manual.
  22.  
  23. ibex DomainManager packed files (.PAK) can be expanded using the standard 
  24. OS/2 UNPACK command.
  25.  
  26. Even though the CD cover booklet mentions that you can place more info on the 
  27. CD-R, we did change the format of the disk for compatibility reasons. It is
  28. no longer possible to add data to the CD.
  29.  
  30. -------------------------------------------------------------------------
  31. This README is split into the following sections:
  32. 0 - Installing over older versions of iDM
  33. 1 - Documentation Changes
  34. 2 - Program & Database Changes
  35. 3 - Bug fixes
  36. 4 - Known bugs
  37.  
  38. -------------------------------------------------------------------------
  39. 0 - Installing over older versions of iDM
  40. -------------------------------------------------------------------------
  41.  
  42. iDM allows you to change messages such that they suit your needs. We have
  43. not yet automated the procedure for copying new messages to the configuration
  44. database. Therefore, some extra care is required when updating messages
  45. from IDM-CD.NSF. We will implement an automated process in the future.
  46.  
  47. Until this has been done, please follow the instructions below.
  48.  
  49.  
  50. Installation & Configuration
  51. ----------------------------
  52. Run the installation and configuration program as outlined in the user's 
  53. guide.
  54.  
  55.  
  56. If you did change messages in iDM-CD
  57. ------------------------------------
  58. You have to save the changed messages to a temporary database, then 
  59. copy IDM-CD.NSF before starting the installation. Then follow the 
  60. procedure outlined below, and finally paste your adapted messages
  61. back and delete the duplicates.
  62.  
  63.  
  64. If you did NOT change messages in iDM-CD
  65. ----------------------------------------
  66. You have to manually copy all messages from the new IDM-CD.NTF template to
  67. your existing master IDM-CD.NSF database (the messages will be replicated
  68. to other servers from there).
  69.  
  70. Open IDM-CD in view "Messages/Language, Module". Select all messages
  71. (Ctrl-A), and delete them (Del).
  72.  
  73. Open the IDM-CD.NTF template in view "Messages/Language, Module". Select
  74. all messages (Ctrl-A), and copy them to the clipboard (Ctrl-C).
  75.  
  76. Now, re-open the IDM-CD.NSF configuration database, and paste the messages
  77. from the clipboard.
  78.  
  79.  
  80. -------------------------------------------------------------------------
  81. 1 - Documentation Changes
  82. -------------------------------------------------------------------------
  83.  
  84. Config
  85. ------
  86. CONFIG.EXE will create the ServerKeyFileName entry in NOTES.INI, if it 
  87. detects that it is not present already.
  88.  
  89. ExecuteTasks
  90. ------------
  91. Contrary to documentation, it accepts wildcard file names for post processing 
  92. (still no support for multiple files to detach in preprocessing).
  93.  
  94.  
  95. -------------------------------------------------------------------------
  96. 2 - Program & Database Enhancements
  97. -------------------------------------------------------------------------
  98.  
  99. IDM-DA
  100. ------
  101.  
  102. - IDM-DA now handles multiple Replicas of a database (with different paths)
  103.   on a single server.
  104. - Due to a version change in the API we based DA on (InterFloX), and the 
  105.   associated bug fixes, DACLEAN is no longer needed. It is no longer 
  106.   distributed with the package.
  107. - IDM-DA checks for the version of InterFloX that has been loaded in order
  108.   to avoid problems when other programs using the same API are used.
  109. - IDM-DA checks for databases that might have been scanned multiple times
  110.   if you had setup directory links in strange ways.
  111. - IDM-DA no longer uppercases all ACL entries it adds - ThIs_UsEr would
  112.   be entered as that, not as THIS_USER.
  113. - The Repository has been standardized to use the Abbreviated format for
  114.   canonical names (macros to add and delete servers have still used the
  115.   full canonicalized name which resulted in unexpected view layouts).
  116.  
  117. IDM-DA 1.1x is a significant improvement from the 1.0x versions:
  118. -  it implements a time check which greatly enhances the speed of the 
  119.    checking process (2 - 10x)
  120. -  it changed the handling of replica ID changes which makes these easier 
  121.    for the administrator and safer in general
  122. -  it changed the handling of roles in order to avoid replication conflicts
  123.    that could occur with earlier releases
  124. -  it has been "hardened" against user errors like copying and pasting 
  125.    database descriptions, double ACL entries for the same name, and has 
  126.    generally better checks for legal inputs (name lengths, character 
  127.    sets, etc.)
  128. -  more command line parameters have been implemented and documented
  129.    (see below)
  130.  
  131. There were also slight improvements done in IDM-DA.NTF/NSF: Where necessary, checks for legal input have been added.
  132.  
  133. Changing Replication IDs
  134. ------------------------
  135. Generally, a change of replication ID is NOT a simple thing and should only
  136. be done after ample consideration. If you need to do it, IDM-DA can assist
  137. you.
  138.  
  139. Once you have entered the replication ID change order on the database form, 
  140. IDM-DA will execute the change in the next run after the order has been
  141. set up.
  142.  
  143. After successful completion of the process, the repository is updated as
  144. follows:
  145. -  if the database description contains a single server, 
  146.    -  its original description with the Replica ID change order is deleted 
  147.       completely, 
  148.    -  a new description is created (which will be set to
  149.       managed no matter what your default managed state is).
  150. -  if the database description contains a list of servers,
  151.    -  the current server is removed from the server list in the now obolete
  152.       description
  153.    -  a new description is created (which will be set to
  154.       managed no matter what your default managed state is).
  155.  
  156. Whereas the single server scenario does not create any problems, the 
  157. multiserver scenario will create replication conflicts on the old description
  158. of the database: each server updates the list of servers in each document,
  159. so, this would leave you with (number of servers - 1) replication conflicts
  160. per document that is part of the database description.
  161.  
  162. Once you have confirmed that all databases have been changed, you can delete 
  163. the obsolete database description and consolidate the new database 
  164. descriptions by adding all servers to one server list, and deleting the other 
  165. database descriptions.
  166.  
  167. We are aware of the fact that more elegant solutions are possible. We are 
  168. working on these - stay tuned.
  169.  
  170.  
  171. Command Line Parameters
  172. -----------------------
  173. IDM-DA 1.10 and newer offer the following commmand line parameters:
  174.  
  175.    switch (default)        function               
  176.    ----------------------------------------------------------
  177.    /A | /A1 | /A0 (/A1)    ACL processing on/off   
  178.    /C<databasefilename>    alternate configuration database    
  179.    /D | /D1 | /D0 (/D0)    design processing on/off  
  180.    /S<databasefilename>    single database mode       
  181.    /T | /T1 | /T0 (/T1)    time check                
  182.  
  183.  
  184.    ACL Processing /A
  185.    --------------
  186.    By default turned on, this switch enables you to prevent IDM-DA from
  187.    checking ACL settings.
  188.  
  189.    Usage:   IDM-DA /A      ENABLES ACL processing (default)
  190.             IDM-DA /A1     ENABLES ACL processing (default)
  191.             IDM-DA /A0     disables ACL processing
  192.          
  193.  
  194.    Alternate Configuration Database /C
  195.    --------------------------------
  196.    By default, IDM-DA uses the default configuration database specified
  197.    during the installation, defined by the IDMCD= entry in NOTES.INI.
  198.    This switch allows you to specify another configuration database for the
  199.    current run.
  200.  
  201.    Usage:   IDM-DA                        USES IDM-CD specified in NOTES.INI (default)
  202.             IDM-DA /CTRAINING\IDM-CD.NSF  uses an alternative configuration database
  203.  
  204.  
  205.    Design Processing /D
  206.    -----------------
  207.    By default, design processing is turned off in IDA-DA. There are various 
  208.    pitfalls when enabling design tracking. Most prominent among these is 
  209.    the use of templates. Whenever an update is done using this process, 
  210.    new design notes may be entered into the database. The administrator 
  211.    would have to run IDM-DA once on one replica copy of the redesigned 
  212.    database in unmanaged (monitoring) mode to get an updated structure 
  213.    of the design, then re-set managed mode, and add all the other servers 
  214.    that carry the same replica copy.
  215.  
  216.    In addition, be prepared that if design processing is enabled, run time
  217.    of IDM-DA is roughly doubled.
  218.  
  219.    Therefore, we chose to turn this option off by default.
  220.  
  221.    Usage:   IDM-DA /D0     DISABLES design processing (default)
  222.             IDM-DA /D      enables design processing
  223.             IDM-DA /D1     enables design processing
  224.    
  225.    Single Database Processing /S
  226.    --------------------------
  227.    If this switch is specified, IDM-DA will work on the single database 
  228.    whose path and file name is specified after this switch - Useful for 
  229.    implementing specific changes to one database immediately.
  230.  
  231.    Usage:   IDM-DA               will work on all databases (default)
  232.             IDM-DA /SNAMES.NSF   will work on NAMES.NSF only
  233.          
  234.  
  235.    Time Check /T
  236.    ----------
  237.    Starting with IDM-DA 1.10, a time check is implemented. Instead of 
  238.    scanning through all documents in repository and all databases on the
  239.    server, IDM-DA checks if the repository data and/or database non-data
  240.    have changed since IDM-DA's last run. This speeds processing by orders
  241.    of magnitude, but if changes have been replicated slowly, or IDM-DA had
  242.    trouble during a run, it will NOT check changes that it didn't process
  243.    in the previous run. As a safeguard, we implemented this switch, which
  244.    allows you to turn the time check off, and have IDM-DA do a complete
  245.    "real-estate" check again.
  246.  
  247.    Usage:   IDM-DA /T      ENABLES time check (default)
  248.             IDM-DA /T1     ENABLES time check (default)
  249.             IDM-DA /T0     disables time check 
  250.    
  251.  
  252. IDM-ET
  253. ------
  254. Contrary to documentation, IDM-ET's post processing can now handle wild-
  255. card specifications. This allows you to grab several files without naming
  256. each one, or to grab files whose name is only partially known at the time
  257. you setup the task.
  258.  
  259. If you select "Generate document if above file(s) do not exist" to be Yes,
  260. ET will generate a database document or a mail announcing that no files
  261. have been found. If you select No, no document will be created in this case.
  262.  
  263. When specifying post processing delivery via database & replication, the
  264. fields form name, field name, and database name are mandatory, the field
  265. database server name is only needed if the destination database is not
  266. local, but on another server.
  267.  
  268. When specifying post processing delivery via mail, the send to field is
  269. required, subject is optional.
  270.  
  271.  
  272. ET Example Jobs
  273. ---------------
  274. In talking with customers, we found that iDM-ET is the part of iDM most 
  275. underestimated by far. In order to address this problem, we included example 
  276. IDM-ET jobs and fragments in the IDM-ET.NTF template. They will be copied 
  277. over to your initial IDM-ET.NSF database automatically. Since they are all 
  278. disabled, they will do no harm. Look at them and learn from them.
  279.  
  280. -------------------------------------------------------------------------
  281. 3 - Bug fixes
  282. -------------------------------------------------------------------------
  283.  
  284. Build 28 fixes the following problems:
  285.  
  286. Licensing:
  287. -  Domain names containing characters > CHR(127) are now supported - and these
  288.    characters are no longer case sensitive.
  289.  
  290. -  There is now an option for outfits with a large number of domains that allows
  291.    us to bypass the domain name check. Ask for this option if you do have a large
  292.    number of domains. The customer who requested the feature has > 150 domains...
  293.  
  294. CONFIG:
  295. -  removed calls to DACLEAN - no longer needed.
  296.  
  297. IDM-DA:
  298. -  kaizened internal operations - some double processing of databases has been 
  299.    prevented from happening.
  300. -  There is no need for DACLEAN anymore. The program has been removed from the 
  301.    suite.
  302.  
  303. IDM-ET:
  304. -  does no longer execute disabled jobs that share their name with an enabled
  305.    job (happened most notably with our own example, GET_SERVER_MONITOR_LOG...)
  306.  
  307. IDM-FM:
  308. -  enabled FM to process relative directory link pointers ("..").
  309.  
  310.  
  311. Build 27 fixes the following problems:
  312.  
  313. Licensing:
  314. -    The number of licenses field is now trimmed before saving it.
  315.     This has caused ET to issue a ET4830 message (too many servers 
  316.     using iDM). 
  317.  
  318. Build 26 was an internal-only build.
  319.  
  320. Build 25 fixes the following problems:
  321.  
  322. All programs:
  323. -    occasional problems when initializing notes (most often in SM)
  324. -    parameter substitution in messages: substituted texts containing
  325.     the sequences '<>' and '<...' at the very end would crash the 
  326.     logging procedure.
  327.  
  328. CONFIG:
  329. -    the progress indicator has been fixed to only show actions which 
  330.     are performed. It used to show all actions.
  331.  
  332. IDM-DA:
  333. -     IDM-DA now handles multiple Replicas of a database (with different 
  334.     paths) on a single server.
  335. -     Due to a version change in the API we based DA on (InterFloX), and 
  336.     the associated bug fixes, DACLEAN is no longer needed. It is no 
  337.     longer distributed with the package.
  338. -     IDM-DA checks for the version of InterFloX that has been loaded in 
  339.     order to avoid problems when other programs using the same API are 
  340.     used.
  341. -     IDM-DA checks for databases that might have been scanned multiple 
  342.     times if you had setup directory links in strange ways.
  343. -     IDM-DA no longer uppercases all ACL entries it adds - ThIs_UsEr 
  344.     would be entered as that, not as THIS_USER.
  345. -     The Repository has been standardized to use the Abbreviated format 
  346.     for canonical names (macros to add and delete servers have still 
  347.     used the full canonicalized name which resulted in unexpected view 
  348.     layouts).
  349. -    sensitivity to operator error has greatly been reduced
  350. -    update of replica ID now works reliably
  351. -    no more ACL entries that cannot be managed with Notes client
  352. -    roles documents replication conflicts have been omitted
  353.  
  354. IDM-ET:
  355. -    a problem with license handling has been fixed
  356. -    ET now allows to move its log database anywhere
  357. -    Occasional double starts have been prevented
  358.  
  359. IDM-FM:
  360. -    multiple documents for a single directory are now flagged and
  361.     removed
  362. -    various problems when updating the repository after handling change
  363.     requests have been fixed.
  364.  
  365.  
  366. -------------------------------------------------------------------------
  367. 4 - Known bugs
  368. -------------------------------------------------------------------------
  369.  
  370. INTER-IBEX is aware of the following bugs in Build 27:
  371.  
  372. IDM-DA:
  373. -  not actually a bug, but a conceptual problem: If you "unmanage" a 
  374.    database description in the repository that was used by a list of
  375.    servers, the first server to detect a change to this database will
  376.    delete this description and insert a new one in which only itself is 
  377.    listed. Consequently, after the deletion has replicated, all other
  378.    servers that have been in the list will no longer find a description
  379.    for this database and will treat it as a new database.
  380.  
  381. IDM-FM:
  382. -  Updates documents of unchanged directories indicating a change if 
  383.    directories contain "lots of text", i.e., a lot of files & directories,
  384.    or many long file- and directory names. The critical limit is about 14kB
  385.    of file- and directory names per directory - as soon as there are 
  386.    multiple fileListing or directoryListing fields (you can check that in
  387.    Design, Document Info). 
  388.  
  389. INSTALL:
  390. -  The installation program is not yet CID-enabled.
  391. -  Uninstalling does not clean up NOTES.INI and CONFIG.SYS.
  392.  
  393.  
  394. -------------------------------------------------------------------------
  395.  
  396. Please direct all inquiries to:
  397.  
  398. Notes:
  399.    Nick Behrmann @ IBEX @ WorldCom
  400.    Nick Behrmann @ IBEX @ LotusInt
  401.    Skip Bockoven @ IBEX @ Worldcom
  402.    Skip Bockoven @ IBEX @ LotusInt
  403.  
  404. Internet:
  405.    Skip_Bockoven@interibex.com
  406.    Nick_Behrmann@interibex.com
  407.  
  408. Phone numbers:
  409.    Nick Behrmann +1-415-572-6160 or +1-800-IBEX-IDM
  410.    Skip Bockoven +41-1-802-8680
  411.  
  412.