home *** CD-ROM | disk | FTP | other *** search
/ Merciful 3 / Merciful_Release_3.bin / software / d / data_division_docs / datadivisiondocs02.dms / datadivisiondocs02.adf / 05 < prev    next >
Text File  |  1996-10-14  |  16KB  |  362 lines
  1.  
  2.                               Chapter Four
  3.  
  4. Installing Directory Opus 5 ..........21
  5. Technical Details of Installation ....22
  6. Installation Options .................24
  7. Serialising Directory Opus 5 .........25
  8. Running Directory Opus 5 .............26
  9.     Workbench Replacement (WBR) ......26
  10.     Potential Problems with WBR mode .27
  11.     Automatic Startup on Boot ........28
  12. Starting From Workbench ..............28
  13. Starting From the CLI ................28
  14. Tool Types,  Command Line Arguments ..29
  15.  
  16.                        Installing Directory Opus 5
  17.  
  18.   +-----------------------------------------------------------------------+
  19.   | You cannot run Directory Opus 5 directly from the master distribution |
  20.   | disk. It is designed to be run ONLY after being installed on your     |
  21.   | hard drive.                                                           |
  22.   +-----------------------------------------------------------------------+
  23.  
  24.  Installation of Opus 5 is handled by the standard Amiga Installer program
  25. and an associated script.  Do not attempt to install the program parts
  26. yourself.  For the correct operation of Opus 5, you MUST use the
  27. installation procedure provided.  Don't worry, the installer script does
  28. everything for you, offering you few choices.
  29.  
  30.  Insert the master distribution disk in your floppy disk drive and open
  31. the disk icon from your workbench screen.  Double-Click on the
  32. 'InstallOpus' icon to start the installation procedure, then follow the
  33. instructions on the screen to install Directory Opus 5.  The program,
  34. related files and directories will be installed into a new directory on
  35. your hard disk called 'Opus5 '.
  36.  
  37.  Once the installer script has done its job, Directory Opus 5 will be
  38. automatically run so that you may serialise your installed copy to
  39. complete the installation. (See Serialising Directory Opus 5 on page 25).
  40.  
  41.                              Directory Opus 5                        21
  42.  
  43.                     Technical Details of Installation
  44.  
  45.  Although there is no need for you to be concerned about the installation
  46. process, the following is a brief technical discussion about how Opus 5
  47. expects to be installed.
  48.  
  49.  
  50.  Directory Opus 5 is  designed to run ONLY from its own directory on a
  51. hard disk.  It also expects to have certain subdirectories installed under
  52. the Opus5 directory.  Briefly, these are
  53.  
  54.  Environment
  55.  
  56.  Contains the files which define the visual display characteristics for
  57. screen mode and palette etc, plus links to the other items  in the program
  58. configuration such as Button Banks and Menu selections.  An Environment
  59. file also keeps track of any default Listers you wish to open, including
  60. their position, current path and display format.  By default, on startup
  61. Opus 5 will use Environment / Default.
  62.  
  63.  Settings
  64.  
  65.  Contains the files which define most of the user-configurable options and
  66. special flags.  By default Opus 5 will use Settings / Default.
  67.  
  68.  Buttons
  69.  
  70.  Contains files detailing the various button bank and similar definitions.
  71. Note that all function definitions are stored as button banks.  This means
  72. that button banks, Lister toolbars, Lister menus, user menus, hot keys,
  73. and script files are all interchangeable.  Even graphical and textual
  74. button banks may be interchanged, but they may look slightly odd!  By
  75. default, Opus 5 will look for Buttons / Toolbar  to use as the Lister
  76. toolbar, Buttons / Lister Menu to use for the Lister menu, Buttons / User
  77. Menu for the user menu, Buttons / Scripts for the scripts, and Buttons /
  78. Hotkeys for the hotkeys.
  79.  
  80.    22                        Directory Opus 5
  81.  
  82.  Images
  83.  
  84.  Contains the various image files for toolbar and other button images.
  85. All images are stored as IFF ILBM brushes, '.info' files or anim brushes.
  86. (The default images are 22 x 14 pixels.) There may be more than one Image
  87. directory for different sets of images.
  88.  
  89.  Icons
  90.  
  91.  Contains the default icon files ('.info') used by Opus 5  when creating
  92. new drawers and associated files.
  93.  
  94.  Groups
  95.  
  96.  Contains any special Program Groups you create.
  97.  
  98.  Filetypes
  99.  
  100.  Filetypes are global to the Opus 5 system and are stored in individual
  101. files, rather than being stored in one specific configuration file.   Any
  102. Filetypes present in this directory will be loaded automatically.  Opus 5
  103. uses file notification to keep track of changes you make while it is
  104. running.  Each physical file stores only one actual Filetype definition.
  105.  
  106.  Storage
  107.  
  108.  Contains unused modules and Filetype definitions.
  109.  
  110.  Modules, Libs, C and System
  111.  
  112.  Contains various files, programs, program modules and libraries to
  113. control Opus 5 operations.
  114.  
  115.  Help, Catalogs and ARexx
  116.  
  117.  Help contains the AmigaGuide files for context sensitive Opus 5 on-line
  118. help, Catalogs contains the Locale language files for non-english
  119. versions, and ARexx contains sample ARexx scripts.
  120.  
  121.                              Directory Opus 5                        23
  122.  
  123.                            Installation Options
  124.  
  125.  Apart from allowing you to select where to install the Opus5 directory,
  126. the installer script offers you the choice of having Directory Opus 5 run
  127. automatically when you next boot up your computer.  If this is not
  128. required, choose option (d) and you may then run Directory Opus 5 from the
  129. Workbench or from the CLI at a later time.
  130.  
  131.                   We recommend that you try option (a)!
  132.  
  133.  You will be presented with choices similar to the following
  134.  
  135.      a)   Install Opus 5 as Workbench replacement
  136.      b)   Start Opus 5 on boot (own screen)
  137.      c)   Start Opus 5 Iconified
  138.      d)   Do not start Opus 5 on boot
  139.  
  140.  If you choose Option (a) , it will install Opus 5 as a default Workbench
  141. replacement, specifically, by replacing your original 'LoadWB' program in
  142. the 'C:' directory with a new version which will load Opus 5  instead of
  143. the usual Workbench program.  For safety, the original 'LoadWB' program is
  144. renamed to 'LoadWB_old'.
  145.  
  146.  Options (b) and (c) will place a small file in your SYS:WBStartup drawer
  147. which will automatically run Opus 5 when you boot your computer.
  148.  
  149.   +---------------------------------------------------------------------+
  150.   | If you have installed the 'LoadWB' program from Opus 5 and wish to  |
  151.   | boot your computer with the old workbench instead, simply hold down |
  152.   | the SHIFT key while the computer is booting.                        |
  153.   +---------------------------------------------------------------------+     
  154.      
  155.     24                       Directory Opus 5
  156.  
  157.                        Serialising Directory Opus 5
  158.  
  159.  In the program package you will find a registration card with your
  160. personal serial number.  Before you can use your new Directory Opus 5
  161. program, it must be personalised with this serial number.  When prompted,
  162. enter your serial number and other details as shown on the screen.  Select
  163. 'Register' when done and Opus 5 will be ready for use.
  164.  
  165.  This would be a good time to complete and return your registration card
  166. to the address indicated on the card.  Please remember that technical
  167. support and upgrades are only available to registered users.
  168.  
  169.  Please safeguard your personal serial number.  If you need to re-install
  170. Directory Opus 5, you will need to serialise the program again with this
  171. number.  You will also have to quote this number for technical support and
  172. upgrades.
  173.  
  174.   +--------------------------------------------------------------------+
  175.   | Be sure to enter your registration number EXACTLY as shown on your |
  176.   | registration card, including correct upper case and lower case     |
  177.   | characters as shown.                                               |
  178.   +--------------------------------------------------------------------+
  179.      
  180.                              Directory Opus 5                        25
  181.  
  182.                          Running Directory Opus 5
  183.                          
  184.  There are several ways of starting Directory Opus 5.
  185.  
  186.      *    As 'Workbench Replacement'
  187.  
  188.      *    Automatically on Boot
  189.  
  190.      *    From the Workbench
  191.  
  192.      *    From the CLI
  193.  
  194.  Each of these options is discussed below.
  195.  
  196.                        Workbench Replacement (WBR)
  197.  
  198.  This is now the preferred method for operating Directory Opus 5.  Running
  199. Opus in place of Workbench provides you with only one screen to handle
  200. with all the standard functionality of Workbench but with the extra power
  201. and ability of Opus.  Remember that if you really need it, you can open
  202. Opus Listers in Icon mode and operate the system just as with the original
  203. Workbench.
  204.  
  205.  As discussed above, when you choose to install Opus 5 to run as Workbench
  206. Replacement (WBR), we actually install a new LoadWB program in your C:
  207. directory to handle this job.  For safety, we rename your original
  208. 'LoadWB' command to 'loadWB_old' and replace it with a our  'LoadDB'
  209. program which is renamed to 'LoadWB' so as to work with a standard Amiga
  210. startup-sequence.  So, when your startup-sequence makes the call to LoadWB
  211. at the end of the script, Opus will be run instead of the normal Workbench
  212. program.
  213.  
  214.  When Opus is run from boot in WBR mode, all that really happens is that
  215. the Opus Main Window is opened on the system's default 'Workbench' screen
  216. and the standard Amiga 'Workbench' program is not run.  If you are not
  217. running Opus as WBR, we suggest that to avoid confusion you run Opus on
  218. its own screen and not on the Workbench screen.
  219.  
  220.     26                       Directory Opus 5
  221.  
  222.                     Potential Problems with WBR mode.
  223.  
  224.  After the release of Opus 5, we found that some PD utility programs would
  225. fail to operate correctly if the 'Workbench' program was not found.  In
  226. other cases, programs would not find the correct system path list or would
  227. suffer from other related problems.  After extensive testing of Opus 5.5,
  228. we believe that all these problems have now been overcome.  However, there
  229. are limits.  We have seen some PD utility programs which attempt to
  230. illegally patch some specific functions of the Workbench program in an
  231. unsupported manner.  These will not work.  If you have a problem, please
  232. remove all such utility programs from your startup-sequence, user-startup
  233. and the WBStartup drawer, boot with Opus 5, then replace the utilities one
  234. by one to find out which one causes the problem.
  235.  
  236.  When run as WBR (via LoadDB), Opus will attempt to use  the environment
  237. file named 'workbench'.  (If run as a stand alone program, the
  238. configuration named 'default' will be used unless overridden by a command
  239. line argument or Tool Type.  When running as WBR, these options are not
  240. available.)
  241.  
  242.  Also, when run as WBR, Opus will automatically run any programs in your
  243. SYS:WBStartup drawer to provide compatibility with Workbench.
  244.  
  245.  If required, you may add Command Line Arguments to the LoadWB (LoadDB)
  246. program line in your startup-sequence.  (See below.)
  247.  
  248.  Remember, if you have installed Opus 5 as Workbench replacement and wish
  249. to boot your computer with the original Workbench instead, simply hold
  250. down the SHIFT key while the computer is booting.
  251.  
  252.   +-----------------------------------------------------------------+
  253.   | If you ever wish to stop running Opus as Workbench replacement, |
  254.   | simply rename LoadWB to LoadDB and rename LoadWB_old to LoadWB. |
  255.   +-----------------------------------------------------------------+
  256.      
  257.                              Directory Opus 5                        27
  258.  
  259.                         Automatic Startup on Boot
  260.  
  261.  The modern method of starting a program on boot is to put an icon in the
  262. WBStartup drawer of your boot disk.  You could place the whole Directory
  263. Opus 5 program (and icon) in there, but this is a severe waste of space.
  264. We have provided a special icon named 'Opus5_Startup' specifically for
  265. this purpose.  If not already installed by the InstallOpus script, you
  266. will find this icon in your Opus5 drawer in the subdirectory WBStartup.
  267. To start Opus 5 when you boot your computer, simply drag this icon into
  268. the WBStartup drawer of your boot partition on your hard disk.
  269.  
  270.  The older method of starting a program from boot was to add lines to your
  271. startup-sequence or user-startup files.  We recommend that you use the
  272. WBStartup options as above instead of modifying these files.
  273.  
  274.  You can modify the startup behaviour of Opus 5 by changing the Tool Types
  275. in Opus5_Startup icon. (See page 29.)
  276.  
  277.                          Starting From Workbench
  278.  
  279.  If you have not installed Opus as WBR, the quick way to run Directory
  280. Opus 5 is from the Workbench.  Double-click on the Directory Opus 5 icon
  281. and, a few seconds later, the program will appear.  It will load the
  282. default Environment settings and appear either on its own screen or on the
  283. Workbench screen, as defined in the Environment.  You can modify the
  284. startup behaviour of Opus 5 by changing the Tool Types in the program
  285. icon. (See page 29.)
  286.  
  287.                           Starting From the CLI
  288.  
  289.  To run Directory Opus 5 from the CLI enter:-
  290.  
  291.      DOpus5:DirectoryOpus
  292.  
  293.  This assumes that you have installed the program on your hard drive using
  294. the InstallOpus script provided and that the correct assignment of
  295. 'DOpus5:' has been made.  (The InstallOpus script should have done this
  296.  
  297.     28                       Directory Opus 5
  298.  
  299. for you.)  The more technically inclined may notice that there is no RUN
  300. command on the instruction line.  Directory Opus 5 detaches itself from
  301. the CLI, leaving the CLI free to be used for other commands and ultimately
  302. allowing you to close the CLI window completely.
  303.  
  304.  Directory Opus 5 can take a series of extra command line arguments to
  305. modify the initial startup behaviour.
  306.  
  307.                    Tool Types,  Command Line Arguments
  308.  
  309.  By changing the Tool Types in either the program icon or the
  310. Opus5_Startup icon, or by using command line arguments directly, you can
  311. modify the initial startup behaviour of the program.  The Tool Types and
  312. Command Line Arguments have the following meaning :-
  313.  
  314.  ENVIRONMENT=filename
  315.  
  316.  The filename is the pathname of a special Environment file to be loaded
  317. and used.  (Note: This cannot be used with LoadDB in WBR mode.)
  318.  
  319.  CX_POPUP=yes/no
  320.  
  321.  This defines whether Opus 5 will open its main screen on startup or not.
  322. To start Opus 5 iconified, set this to No.
  323.  
  324.   +---------------------------------------------------------------------+
  325.   | CX_POPKEY is now obsolete.  The default hot key is till defined as  |
  326.   | Ctrl - left shift - left Alt but may now be defined directly in the |
  327.   | Options / Hide Method. (See page 87.)                               |
  328.   +---------------------------------------------------------------------+
  329.  
  330.  QUIET
  331.  
  332.  Tells Opus 5 not to display  the 'Loading program...' requester.
  333.  
  334.                              Directory Opus 5                        29
  335.  
  336.  STARTUP_PIC=file
  337.  
  338.  Specifies the path to a picture to be displayed while Opus 5 is loading.
  339. This picture can be a standard IFF ILBM, or if you are using Workbench 3.0
  340. or higher, any picture that you have a datatype installed for.
  341.  
  342.                              WBSTARTUP=yes/no
  343.  
  344.  Specifies whether Opus should execute the programs in your SYS:WBStartup
  345. drawer.
  346.  
  347.   +----------------------------------------------------------------------+
  348.   | ONLY use this if you are running Opus in WBR mode by executing the   |
  349.   | main program itself (DOpus5:DirectoryOpus).  When Opus is installed  |
  350.   | normally as WBR and run via LoadDB, this is automatically turned on. |
  351.   +----------------------------------------------------------------------+
  352.  
  353.  When starting Opus 5 from the CLI, the above arguments may also be used
  354. as command line switches.
  355.  
  356.  When running Opus 5 in WBR mode using LoadDB, all the above command line
  357. arguments may be used except ENVIRONMENT.  In WBR, ENVIRONMENT is always
  358. set to read the DOpus5:environment/workbench settings.
  359.  
  360.     30                       Directory Opus 5
  361.  
  362.