[Library] [Contents] [Revisions] [Prev Topic] [Next Topic] [Search] [Search Results] [Prev Topic Match] [Next Topic Match] [Notes] [List Notes] [Print] [Download] [Help]

3.4.1 Installation of OpenDoc for OS/2

 

    ___ Note _______________________________________________________________  
   |                                                                        | 
   | If you have a previous version of OpenDoc Developer's Kit 2 for OS/2   | 
   | installed on your system, you have to uninstall it previous to         | 
   | installing OpenDoc for OS/2 Version 1.0.  See "Uninstalling OpenDoc    | 
   | Developer's Kit 2 for OS/2" in topic 3.7.3 for details about how to do | 
   | this.                                                                  | 
   |                                                                        | 
   |________________________________________________________________________| 


   The following are the three ways to install products from The Developer 
   Connection Catalog: 


   1.  Select the line of the product you want to install, go to the Symbol 
       pull-down menu and select Install Product. 


   2.  Display the pop-up menu of the object by clicking mouse button two on 
       the product line and selecting Install product. 


   3.  Double-click with mouse button one on the line of the product to show 
       the product information screen. 




   To install OpenDoc for OS/2 Version 1.0 we describe the second of these 
   three methods. 


   Before installing OpenDoc for OS/2 Version 1.0 on your system, be sure to 
   check the hardware and software requirements detailed in "Installation 
   Overview of OpenDoc for OS/2 for Users" in topic 3.1. 


   1.  Select OpenDoc for OS/2 (IBM) from the IBM OS/2 (Discs 1/4) category 
       in The Developer Connection Catalog main view screen (Figure 73 in 
       topic 3.4). 


   2.  Display the pop-up menu of the object by clicking mouse button two on 
       the product line as shown in Figure 74. 




 




                                   PICTURE 71           






 
   Figure 74. Pop-Up Menu in Main View 


       The functions in this pop-up menu have the following meaning: 




 




   Help                     Shows The Developer Connection help for product. 


   Collapse category        Collapses the product category. 


   View product information Provides a brief description of the product and allows you to 
                            install or try the product. 


   Try product              Allows you to try some products from the CD-ROMs without 
                            installing them. (Not all products can be tried.) 


   Install product          Installs the product. 


   Remove product           Removes product objects previously installed by 
                            The Developer Connection. (Not all products can be removed 
                            using this method.) 








 


       The Try Product push button is not available for OpenDoc for OS/2 
       Version 1.0 (shown as gray in Figure 74). 


   3.  Select Install Product on the pop-up menu shown in Figure 74. 


   4.  If you removed disc 3 of The Developer Connection for OS/2 Volume 9 
       Special Edition CD-ROM from your CD-ROM drive, you see the pop-up 
       window (shown in Figure 75) asking you to insert disc 3 in the drive. 
       You will need to insert it, indicate the path and select OK to 
       continue. 




 


   . 


                                   PICTURE 72           






 
   Figure 75. CD-ROM Not Present 


   5.  The Installation of OpenDoc for OS/2 screen will appear (as shown in 
       Figure 76).  You should read the information provided because it 
       contains important installation information that may apply to your 
       system. 




 


   . 


                                   PICTURE 73           






 
   Figure 76. Installation of OpenDoc for OS/2 


       After reading the information on the screen, select Continue to start 
       the installation process. 


   6.  The Install screen (Figure 77) with the option Update CONFIG.SYS 
       already selected as the default will appear. 




 


   . 


                                   PICTURE 74           






 
   Figure 77. Update CONFIG.SYS 


       Do not modify this screen and select OK to continue.  This will make 
       all necessary modifications to the CONFIG.SYS file automatically 
       without further intervention.  If you prefer to review the 
       modifications before and not let the installation process 
       automatically update your CONFIG.SYS file, uncheck the Update 
       CONFIG.SYS option in Figure 77.  You will get the following warning 
       message (Figure 78). 




 


   . 


                                   PICTURE 75           






 
   Figure 78. Update CONFIG.SYS Warning 


       If you select Yes on this message, the process will create a 
       CONFIG.ADD file containing the current version of CONFIG.SYS plus the 
       modifications necessary for OpenDoc for OS/2 Version 1.0 to run on 
       your system.  To be able to use OpenDoc for OS/2 Version 1.0 on your 
       system you have to apply this modifications to the CONFIG.SYS file and 
       reboot the machine. 


   7.  On the next screen (Figure 79) select OpenDoc Base. 




 


   . 


                                   PICTURE 76           






 
   Figure 79. Install - Directories 


       To select OpenDoc Base, click on the OpenDoc Base line or select the 
       Select All button. 


       To check if you have enough disk space for the installation select the 
       Disk Space button (15 MB are needed).  This will present the window 
       shown on Figure 80.  In this window, you can change the drive where 
       you want OpenDoc for OS/2 Version 1.0 to be installed.  To do so, 
       select from the list of drives the drive where you want to install it 
       (check that the space available on that drive is greater than the 
       amount specified on the right hand side of the window).  Select the 
       Change directories to selected drive check box and select OK.  This 
       will change the Base directory indicated in Figure 79 to the drive you 
       selected.  Some files will be copied to the boot drive (the OpenDoc 
       for OS/2 INI files) even if you select a different drive for the 
       installation of OpenDoc for OS/2, so around 200 KB of free space will 
       be needed on the boot drive as well. 


        ___ Note ___________________________________________________________  
       |                                                                    | 
       | If you do not select the Change directories to selected drive      | 
       | option, the OpenDoc for OS/2 Version 1.0 files will be copied to   | 
       | the default directory (\OPENDOC in the boot drive).                | 
       |                                                                    | 
       |____________________________________________________________________| 




 


   . 


                                   PICTURE 77           






 
   Figure 80. Disk Space 


       After selecting OK in this window, you will return to the screen shown 
       in Figure 79. 


   8.  Select Install to begin the installation process (the Install - 
       progress screen will appear as shown in Figure 81). 




 


   . 


                                   PICTURE 78           






 
   Figure 81. Install - Progress 


   9.  Once the installation has finished, you will be informed of the 
       successful installation with the screen shown in Figure 82.  Select OK 
       on this window to continue. 




 


   . 


                                   PICTURE 79           






 
   Figure 82. Installation of OpenDoc for OS/2. Installation Completed 


   10. Select Exit on the Installation of OpenDoc for OS/2 screen 
       (Figure 83). 




 


   . 


                                   PICTURE 80           






 
   Figure 83. Installation Completed 


   11. The installation process will return to The Developer Connection Main 
       View screen (Figure 73 in topic 3.4) with a message informing that 
       OPENPACK Installation session ended.  Select OK on this message. 


   12. Close The Developer Connection Catalog and reboot the machine to make 
       the changes to your system effective. 




   Figure 84 lists the changes made to the CONFIG.SYS file during the 
   installation (this is not the complete content of the file, just the 
   modifications). 




 


     LIBPATH=D:\OPENDOC\EPM;D:\OPENDOC\OREXX;D:\OPENDOC\BIN; 
     SET PATH=D:\OPENDOC\EPM;D:\OPENDOC\OREXX;D:\OPENDOC\BIN; 
     SET DPATH=D:\OPENDOC\EPM;D:\OPENDOC\OREXX; 
     SET HELP=D:\OPENDOC\OREXX;D:\OPENDOC\BIN; 
     SET BOOKSHELF=D:\OPENDOC\OREXX; 
     SET SOMIR=D:\OPENDOC\BIN\OPENDOC.IR;D:\OPENDOC\OREXX\REXX.IR;D:\OPENDOC\OREXX\ORXSMP.IR; 
     SET SOMDDIR=C:\OS2\ETC\DSOM 
     SET SOMDDEBUG=10 
     SET SOMDMESSAGELOG=SOMD.LOG 
     SET SOMDPORT=4096 
     SET SOMSOCKETS=TCPIPSockets 
     SET SOMDTIMEOUT=300 
     SET AVLSVRNAME=AS 






 
   Figure 84. OpenDoc for OS/2 Version 1.0 CONFIG.SYS Changes 


   After rebooting, you should notice three new folders on your Desktop as 
   shown in Figure 85. 




 




                                   PICTURE 81           






 
   Figure 85. OpenDoc for OS/2 Folders on Desktop 


   The three folders are as follows: 


   °   OpenDoc for OS/2 


   °   OpenDoc Templates 


   °   OpenDoc Shell Plug-Ins 




   The OpenDoc for OS/2 folder contains the programs necessary for OpenDoc 
   for OS/2 Version 1.0 as shown in Figure 86. 




 




                                   PICTURE 82           






 
   Figure 86. OpenDoc for OS/2 Folder 


   The OpenDoc Templates folder (shown in Figure 87) contains the following 
   three templates: 


   °   2D Graphics 


   °   Text Part 


   °   Page Layout 






 




                                   PICTURE 83           






 
   Figure 87. OpenDoc Templates Folder 


   The OpenDoc Shell Plug-Ins folder is empty since no plug-ins have been 
   installed during this process.

[Prev Topic] [Next Topic] © Copyright IBM Corp. 1996

IBM BookManager® BookServer Copyright 1989, 1999 IBM Corporation. All rights reserved.