home *** CD-ROM | disk | FTP | other *** search
/ OpenStep (Enterprise) / OpenStepENTCD.toast / OEDEV / DOC / README.TXT
Encoding:
Text File  |  1996-09-09  |  7.8 KB  |  199 lines
  1. This document describes some steps that you need to take after 
  2. you install OPENSTEP Enterprise for Windows 4.1. It also describes:
  3.  
  4. • Changes made to environment variables during installation
  5. • How to start and stop OPENSTEP processes manually
  6. • How to uninstall OPENSTEP manually
  7. • Some issues related to Enterprise Objects Framework
  8.  
  9.  
  10. After Installation
  11. ==================
  12.  
  13. If you have installed Enterprise Objects Framework, you should also install 
  14. the appropriate client libraries for the databases that you intend to connect 
  15. with.
  16.  
  17. With the exception of the Enterprise Objects Framework Reference, which is in 
  18. Windows Help, all Enterprise Objects documentation is provided in PDF only. If
  19. you need a PDF reader, you can download one from the following World Wide Web
  20. site:
  21.  
  22.      http://www.adobe.com/acrobat/
  23.  
  24.  
  25.  
  26. Changes to Environment Variables
  27. ================================
  28.  
  29. When Configure Environment Variables is selected in the Choose Options dialog 
  30. box, the setup program makes the following changes to your System Environment 
  31. Variables. You can view these variables in the System Control Panel:
  32.  
  33. • $NEXT_ROOT shows the drive and directory where the root OPENSTEP directory 
  34.   is located. (Make sure there is a trailing slash.)
  35.  
  36. • For developer installations, "Lib" includes the resolved paths for
  37.   NextDeveloper/Libraries and LocalDeveloper/Libraries (both relative to
  38.   $NEXT_ROOT).
  39.  
  40. • "Path" includes the resolved paths for NextLibrary/Executables and, for
  41.   developer installations, LocalDeveloper/Executables,
  42.   NextDeveloper/Executables, and NextDeveloper/Executables/Utilities (all 
  43.   paths are relative to $NEXT_ROOT).
  44.  
  45. Note:  The paths that identify the various OPENSTEP directories in "Lib" and 
  46. "Path" must come before the corresponding Microsoft directory definitions.
  47.  
  48.  
  49.  
  50. Starting OPENSTEP Processes Manually
  51. ====================================
  52.  
  53. During installation you can request that the various processes needed by 
  54. OPENSTEP be started automatically when you log in. The installer does this 
  55. by creating entries for each of those processes in your Startup (Common) 
  56. program group. If you elected to start these processes manually, you must 
  57. locate and start them.
  58.  
  59. The two processes that you must start first are services called MachD and 
  60. nmserver. To start these services, open a Bourne shell (by selecting the 
  61. icon in the OPENSTEP Enterprise program group). Then type the following:
  62.  
  63.     cd $NEXT_ROOT/NextLibrary/System
  64.     machd -install
  65.     nmserver -install
  66.  
  67. To start the remaining two OPENSTEP runtime processes, locate them in 
  68. the file system (using File Manager or Explorer) and then start them by 
  69. double-clicking. Start them in the following order:
  70.  
  71. • $NEXT_ROOT/NextLibrary/System/WindowServer.exe
  72. • $NEXT_ROOT/NextLibrary/Frameworks/AppKit.framework/Resources/pbs.exe
  73.  
  74.  
  75.  
  76. Stopping OPENSTEP Processes Manually
  77. ====================================
  78.  
  79. To stop OPENSTEP processes--a step required when uninstalling OPENSTEP, 
  80. described below--first locate the Startup (Common) group containing the 
  81. processes (using the Program Manager for Windows 3.51 or the Start menu 
  82. for Windows 4.0). Then select or double-click these two processes in the 
  83. following order:
  84.  
  85.    • Pasteboard Server (pbs.exe)
  86.    • Window Server (WindowServer.exe)
  87.  
  88. To stop the OPENSTEP services, open a Bourne shell (by selecting the icon 
  89. in the OPENSTEP Enterprise program group). Then type the following:
  90.  
  91.     cd $NEXT_ROOT/NextLibrary/System
  92.     machd -remove
  93.     nmserver -remove
  94.  
  95. For each process, a message will inform you that the process is already 
  96. running and will inquire whether you wish to terminate it. Respond Yes 
  97. to each message. If you have Microsoft Visual C++, you can also use the 
  98. Pview program's Kill Process function to terminate processes. Terminate 
  99. them in the same order as listed above.
  100.  
  101.  
  102.  
  103. Uninstalling OPENSTEP for Windows Manually
  104. ===========================================
  105.  
  106. Because OPENSTEP installs all of its files underneath a single 
  107. directory identified by the $NEXT_ROOT environment variable, uninstallation 
  108. is a fairly straightforward process. Essentially, you delete the OPENSTEP 
  109. files, remove any icons that appear in the Program Manager, and clean up 
  110. your Environment Variables.
  111.  
  112.  
  113. Delete OPENSTEP Files
  114. ---------------------
  115.  
  116. 1. Because the installer may not be able to overwrite running processes, 
  117.    first quit any OPENSTEP or D'OLE applications you're running. Then stop 
  118.    OPENSTEP processes as described in the section "Stopping OPENSTEP 
  119.    Processes Manually," above.
  120.  
  121. 2. Locate the OPENSTEP root directory. This directory is identified by the
  122.    $NEXT_ROOT environment variable. If you are unsure what the root directory 
  123.    is, open the System control panel and look in the System Environment 
  124.    Variables section.
  125.  
  126. 3. Using the Windows NT File Manager or Explorer programs, select the 
  127.    OPENSTEP root directory.
  128.  
  129. 4. Press Delete, or choose Delete from the File menu. A series of message 
  130.    boxes appears, asking you to confirm that you want to delete the selected
  131.    directory and all its contents. Click Yes (or Yes to All) to all messages.
  132.  
  133. The File Manager deletes each of the files and directories underneath the 
  134. selected directory, and then it deletes the directory itself.
  135.  
  136.  
  137. Delete OPENSTEP Icons from Program Groups (Windows NT 3.51)
  138. -----------------------------------------------------------
  139.  
  140. 1. Select--but do not open--the OPENSTEP Enterprise program group 
  141.    icon in the Program Manager.
  142.  
  143. 2. Press Delete, or choose Delete from the File menu. In the Delete 
  144.    confirmation dialog that appears, click Yes.
  145.  
  146. 3. Double-click the Startup (Common) group icon in the Program Manager.
  147.  
  148. 4. If the Startup (Common) group contains icons labeled "MachD", 
  149.    "Mach nmserver," "WindowServer," or "Pasteboard Server," select each 
  150.    icon in turn and press Delete. In the Delete confirmation dialog that 
  151.    appears, click Yes.
  152.  
  153.  
  154. Delete OPENSTEP Icons from Program Groups (Windows NT 4.0) 
  155. ----------------------------------------------------------
  156.  
  157. 1. Choose the Taskbar option from Settings on the Start menu.
  158.  
  159. 2. Select the Start Menu Programs display of the Taskbar Properties window.
  160.  
  161. 3. Click the Remove button on the Customize Start Menu section. 
  162.  
  163. 4. In the Remove Shortcuts/Folders window, select OPENSTEP Enterprise,
  164.    click Remove, and then click Yes to the confirmation message.
  165.  
  166. 5. In the same window, open the Startup program group by clicking the "+"  
  167.    symbol. Then select the icons labeled "MachD", Mach nmserver," 
  168.    "WindowServer," or "Pasteboard Server." For each icon, press Delete 
  169.    and click Yes to the subsequent Delete confirmation dialog.
  170.  
  171.  
  172. Clean up Environment Variables
  173. ------------------------------
  174.  
  175. 1. Locate and open the Control Panel window.
  176.  
  177. 2. Within the Control Panel window, double-click the System icon.
  178.  
  179. 3. The System dialog box appears. This dialog box is where you can alter 
  180.    the environment variable settings that Windows NT uses.
  181.  
  182. 4. Select $NEXT_ROOT in the System Environment Variables section. Click 
  183.    Delete.
  184.  
  185. 5. If developer software was installed, select the "Lib" system-environment 
  186.    variable definition. Highlight that portion of the definition 
  187.    corresponding to the OPENSTEP "Lib" directories listed in "Changes to 
  188.    Environment Variables," above, and press the Delete key (do not click 
  189.    Delete). Click Set to register the change.
  190.  
  191. 6. Select the "Path" system-environment variable definition. Highlight those
  192.    portions of the definition that identifies directories corresponding to 
  193.    the OPENSTEP "Path" directories listed in "Changes to Environment 
  194.    Variables," above, and press the Delete key (do not click Delete). 
  195.    Click Set to register the change.
  196.  
  197. 7. Click OK in the System dialog.
  198.  
  199. This completes the manual uninstallation process.