OPENSTEP

Title: OPENSTEP/NT Installation FAQ
Entry Number: 2461
Creation Date: September 24, 1996
Last Updated: <<DATE>>

Keywords: NT, install, webobjects, machd, nmserver, pbs, WindowServer

NOTE: Unless otherwise stated, this information applies to NT 4.0 Gold and OPENSTEP/NT 4.1 only.  The information presented here may or may not apply to versions of NT before 4.0 gold, or OPENSTEP/NT 4.0.

NOTE: Unless otherwise stated, this information also applies to WebObjects Enterprise.

NOTE: You must performall of the following procedures as Administrator.

Q: What does the OPENSTEP/NT Distribution install on my system?

A:

- All files are installed under the directory defined by the NEXT_ROOT environment variable.

- 2 services: machd and nmserver (in OPENSTEP 4.0, these are simply programs in the common StartUp group)

- 2 programs in the common startup group:pbs and WindowServer

- environment variables either added or changed: NEXT_ROOT, Lib, Path

- Registry entries (do a search for NeXT)

Q: How do I Manually uninstall OPENSTEP/NT 4.0?

A:

1.	Quit any running OPENSTEP Applications

2.	Kill the four daemons: machd, nmserver, pbs, WindowServer.  They do not show up on the task list, so you will have to use pview or the Task Manager in NT 4.0 in order to kill them.  Alternatively, remove the programs from the StartUp folder,and reboot your machine.

3.	Remove the four daemons from the common StartUp folder.

4.	Delete the entire NEXT_ROOT directory.

5.	Remove or change the NeXT related environment variables: NEXT_ROOT, Lib, Path.

6.	(Optional) Remove any registry references to NeXT software using the Registry Editor.

Q: How do I install OPENSTEP/NT 4.1 on NT 3.51?

A: Very carefully.

Changes were made in NT 4.0 gold that broke the installation process for OPENSTEP during the 4.1 beta process.  We have fixed OPENSTEP/NT 4.1 so that it installs cleanly on NT 4.0 Gold, but this consequently broke the installation for NT 3.51.  You can still successfully instally on NT 3.51 by following these steps:

1.	Install as usual, but when asked if you want the installer to place programs in your startup folder, choose NO.  The installation will complete successfully.

2.	Place pbs and WindowServer in the common StartUp group.
pbs is in %NEXT_ROOT%\NextLibrary\Frameworks\AppKit.Framework\resources\pbs.exe
WindowServer is in %NEXT_ROOT%\NextLibrary\System\WindowServer.exe

3.	(Optional) Create a NeXT program group and create the file extension associations within File Manager.

4.	Reboot the machine.

Q: How do I Manually uninstall OPENSTEP/NT 4.1?

A:

1.	Quit any running OPENSTEP Applications

2.	Kill the four daemons: machd, nmserver, pbs, WindowServer. You must bring up the Services control panel to stop machd and nmserver. You can use pview or the NT 4.0 Task Manager to kill pbs and WindowServer. Alternatively, remove the programs from the StartUp folder,and reboot your machine.

3.	Remove machd and nmserver as services.  From the command prompt, type (replacing %NEXT_ROOT% with the actual NeXT root directory):
%NEXT_ROOT%\NextLibrary\System\machd -remove
%NEXT_ROOT%\NextLibrary\System\nmserver -remove

4.	Remove pbs and WindowServer from the common StartUp folder.

5.	Delete the entire NEXT_ROOT directory.

6.	Remove or change the NeXT related environment variables: NEXT_ROOT, Lib, Path.

7.	(Optional) Remove any registry references to NeXT software using the Registry Editor.

Q: I've installed OPENSTEP correctly, but it still won't run.  What's wrong?

A: OPENSTEP must believe your NT system has network capability in order to run.

The nmserver service must have networking enabled in order to run. You can either put your NT machine on a network, or configure RAS to work around this.  You need not connect to a service provider with RAS; just have it configured. If you have an ethernet card in your machine, removing it will make RAS configuration easier.