Netscape Extension Builder 4.0, Limited Release
Installation for Netscape Extension Builder 4.0, Limited Release
The following topics are described in this document:
- Installation Prerequisites
- Installation Requirements
- System Requirements
- Installing Netscape Extension Builder
- Uninstalling NAS Software
These are the prerequisites for installing Netscape Extension Builder 4.0:
- Netscape Application Server 4.0 or Netscape Application Builder 4.0 must be installed.
- Netscape Directory Server 4.0 must be running before proceeding to Netscape Extension Builder 4.0 installation.
- Uninstall any previous versions of Netscape Application Server software such as NAS 2.1, NEB 2.1 (or 3.0) and NAB 2.1 (or 3.0) prior to installing NEB 4.0.
- For more information about this release, see the release notes for Netscape Extension Builder.
- Windows NT: Install with Administrator privileges under Windows NT.
- UNIX: Log on as root before proceeding with installation.
The installation program detects previous versions of Netscape software. The following table summarizes what the installation program does, depending on the initial state of the machine where installation occurs.
Program Action
No Netscape Application Server products are currently installed (a clean install).
First install Netscape Enterprise Server (Web Server). Then install Netscape Application Server 4.0 or Netscape Application Builder 4.0. Continue with Netscape Extension Builder 4.0 installation program.
Netscape Application Builder 4.0 is installed.
Start Netscape Extension Builder 4.0 installation program. You will be prompted for Netscape Application Server 4.0 installation directory if not detected.
Netscape Application Server 4.0 is installed.
Netscape Application Server 2.1, Netscape Application Builder 2.1, or Netscape Extension Builder 2.1 or 3.0 is installed.
Uninstall these versions of products and then proceed as starting with a blank machine as described at the beginning of this table.
The following table lists the hardware and software requirements for installing Netscape Extension Builder 4.0.
Windows:
Intel Pentium microprocessor running Windows NT version 4.0 with Service Pack5Solaris:
Sun SPARC running Solaris 2.6 or 2.7
Temporary space to be available during installation
250 MB
Netscape Application Builder (optional)
120MB
Netscape Application Server
100 MB
Netscape Extension Builder
61.5 MB
Solaris:
Temporary space to be available during installation
250 MB
Netscape Application Server
100 MB
Netscape Extension Builder
61 MB
Compilation software
Windows C++ Compiler:
Microsoft Visual C++ 6.0 compiler required for C++ extensions.Solaris C++ Compiler:
Visual Workshop C++ 5.0 compiler required for C++ extensions. Note that the compiler is set to run in backward
compatibility mode 4.2. in the GNUdefaults.sun.mak file. If you are currently running Visual Workshop C++ 4.2 then this flag is ignored. In any case, no user action is required.
NOTE:You must first uninstall the following previous versions of Netscape Application Server software before proceeding: Netscape Application Server 2.1, Netscape Extension Builder 2.1 (or 3.0), and Netscape Application Builder 2.1 (or 3.0). See Uninstalling NAS Software for instructions.
During installation you are required to provide an installation key. The installation keys are as follows:
Product/Operating System
Key
NEB/NT
2261699090-4011677546
NEB/Solaris
29042757-491883709
NAS or NAB/ NT
955802486-66921301
NAS or NAB/ Solaris
145835986-3948305918
Choose the operating system on which you are installing NEB 4.0, Limited Release:
Installing Under Windows NT
Before installing Netscape Extension Builder 4.0 verify that Netscape Directory Server is running. From the Start menu, choose Settings and then Control Panel. Double-click the Services icon and verify that status of Netscape Directory Server is set to "Started."
After you start the installation program, you are presented with a series of dialog boxes that allow you to provide your product key) and customize your installation. Click Next or OK after each of the following dialog boxes to continue. To quit at any point, click Cancel.
Install Netscape Extension Builder 4.0, Limited Release
Dialog Box
Description
Welcome
Description of the installation program.
Software License Agreement
Detailed edition of the software license agreement. Please thoroughly read and understand this information before installing.
Choose Destination Location
The Destination Directory is where Setup installs the software. The default location isC:\Netscape\server4\neb. To change this location, click Browse and select another directory.
Folder Selection
Setup adds icons to a program folder that you can access from the Start Menu by choosing the Programs menu. By default, Setup installs icons into new program folders named Netscape Extension Builder 4.0.
Product Key
Enter the product key which is found on the Welcome letter you received with your software. The key you enter must be valid in order for NEB to run. Carefully enter the key and then verify the number before proceeding. Installation does not verify the key. When you click Next, Setup installs Netscape Extension Builder 4.0.
Setup Complete
This dialog appears after Netscape Extension Builder 4.0 is installed. You must reboot your machine before you can start using Netscape Extension Builder 4.0.
Set System Variables
You need to set a system variable for the C++ compiler. To do this:
- Run the System program from the Control Panel folder.
- Click the Environment tab.
- In the System Variable list box highlight the MSDEV_INSTALLDIR.
- In the Value text box near, edit the MSDEV_INSTALLER value so that it points to your Visual C++ compiler installation directory.
Verify that your PATH contains the location of the GNU tools directory installed by the NEB installation. By default it is c:\neb\gnutools_win32\bin.
Installing Under Solaris 2.6 or 2.7
Login as root while running the installation program and verify that Netscape Directory Server 4.0 (slapd) is started using the ps command (process status) before proceeding to installation. If slapd is not listed as a process running on the machine, start it using a command of this form:
/slapd-<servername>/start-slapd
where <NASroot>is the directory path of the NAS installation and <servername>is the name of the NAS server.
Install Netscape Extension Builder 4.0, Limited Release
Run the installation script.
Go to the directory on your machine where the installation files were copied. Type the following and press enter:
% ./nebInstall.sh or % sh nebInstall.shContinue with installation or proceed to verification
Type 2 to continue with installation. Or type 1 to exit Netscape Extension Builder 4.0 setup and proceed with verification.
Enter the product key for NEB
Type the product key and press ENTER. The key can be found in the Welcome letter you received with your software. The key you enter must be valid in order for NEB to run. Carefully enter the key and then verify the number before proceeding. Installation does not verify the key.
Enter the NAS install Root Directory
Type the root directory where Netscape Application Server 4.0 is installed and press ENTER. For example:
% /usr/netscape/server4/nasEnter the NEB directory
Enter the target directory for Netscape Extension Builder installation or press ENTER to accept the default. The default is:
% usr/netscape/server4/nebSet System Variables
Before you can run Netscape Extension Builder 4.0, you must set the environment variables GX_GNUKDSROOTDIR, GX_GNUKETROOTDIR, PATH, and LD_LIBRARY_PATH that define locations of the product directories. Set the following:
- GX_GNUKDSROOTDIR - set to the Netscape Application Server installation.
For example, /usr/netscape/server4/nas
- GX_GNUKETROOTDIR - set to the Netscape Extension Builder installation.
For example, /usr/netscape/server4/neb
- PATH - add the Netscape Extension Builder bin directory.
For example, /usr/netscape/server4/neb/bin
- PATH - add the GNU Tools directory.
For example, /usr/netscape/server4/neb/gnutools_solaris/bin
- LD_LIBRARY_PATH - add the Netscape Extension Builder libdirectory.
For example, /usr/netscape/server4/neb/libAfter setting environment variables as described in this section, you can run Netscape Extension Builder 4.0 by typing:
% neb.
You must uninstall any previous versions of NAS software such as NEB 2.1 (or 3.0), NAB 2.1 (or 3.0), and NAS 2.1. This document assumes that as part of installing NAS 4.0 you have already uninstalled any previous versions of NAS. For further information, refer to the Installation Guideavailable as part of the NAS 4.0 online documentation set. See the sections below for uninstalling previous versions of NEB and NAB.
Select the platform that runs the products you want to uninstall.
Uninstalling Under Windows NT
- Uninstalling Netscape Extension Builder 4.0
- Uninstalling Netscape Application Builder 3.0
- Uninstalling Netscape Extension Builder 3.0
- Uninstalling Netscape Application Builder 2.x
- Uninstalling Netscape Extension Builder 2.x
Uninstalling Netscape Extension Builder 4.0
To uninstall Netscape Extension Builder 4.0, perform the following steps:
- Very important: Copy any projects and application files you want to preserve out of the nebsubdirectory.
- From the Start menu, choose Settings, and then Control Panel.
- Open Add/Remove Programs and highlight Netscape Extension Builder 4.0.
- Click Add/Remove.
NOTE: During the uninstall process you will be prompted to Remove Shared file, Ketapp.gxr? Click Yes to All to remove all shared files. Otherwise, you will have to manually delete shared files to completely uninstall Netscape Extension Builder 4.0.
Uninstalling Netscape Application Builder 3.0
To uninstall Netscape Application Builder 3.0, perform the following steps:
- Very important: Copy any projects and application files you want to preserve out of the Apps subdirectory.
- Select Uninstaller from the Netscape Application Builder 3.0 program group in the Start menu, or choose Netscape Application Builder 3.0 from the Add/Remove Programs control panel and click Add/Remove.
A dialog box prompts you with the following message:
Are you sure you want to completely remove the selected application and all of its components?- Click Yes.
Note:If Netscape Extension Builder is installed, then clicking Yes removes Netscape Extension Builder and brings up a second dialog box, again prompting you with the following message:
Are you sure you want to completely remove the selected application and all of its components?- Click Yes to remove Netscape Application Builder.
You are prompted with the following message:
Shutting down the Orbix service. This may take a few minutes.- Click OK.
- Remove NAB or NEB entries from the appropriate environment variables, using the System control panel. These variables include PATH, INCLUDE, GX_GNUKDSROOTDIR, GX_GNUKETROOTDIR, and LIB.
Netscape Application Builder is removed from your system. You must reboot the system to complete the uninstall process. In particular, you must reboot before reinstalling Netscape Application Builder.
Uninstalling Netscape Extension Builder 3.0
To uninstall Netscape Extension Builder 3.0, follow the instructions in Uninstalling Netscape Application Builder 3.0. If Netscape Extension Builder 3.0 is installed, it will be uninstalled together with Netscape Application Builder 3.0.
Uninstalling Netscape Application Builder 2.x
To uninstall previous versions of Netscape Application Builder, perform the following steps:
- First, stop any running runtime engines:
- Close all three runtime environment windows KXSdev, KCSdev and KJSdev.
- From the ServicesControl Panel, stop the database server, Web Server, and Orbix ORB.
- Very important: Copy any projects and application files you wish to preserve out of the KIVA Apps directory.
- From the KIVA program group, run KIVA Uninstaller. You can also use the Add/Remove ProgramsControl Panel to uninstall NAB.
- When uninstallation is complete, click Finish.
- Run the Registry Editor by typing regedt32or regedit at the Run command.
- Under HKEY_LOCAL_MACHINE\SOFTWARE, delete the KIVAkey.
- Delete the KIVAdirectory from the drive to which it was installed.
- Right click the Start Menu and choose Properties. Click the Start Menu Program tab, click Advanced, and choose the Programsfolder at the bottom of the Window Explorer. Remove the folder 'KIVA .....'.
- From the SystemControl Panel, choose Environment and delete the following:
- From the PATH, delete the set of the directories that includes "KIVA":
C:\KIVA\KDS\BIN;
C:\KIVA\KDS\ORB\ORBIX\BIN;
C:\KIVA\KDS\APPS\BIN;
C:\KIVA\KES\BIN;
C:\KIVA\KES\ORB\ORBIX\BIN;
C:\KIVA\KES\APPS\BIN;NOTE:If you do not delete the KIVA directory set from the PATH, when you install your new software the new path is appended at the end of this pathname. You may receive an error message stating: "PATH is too Long"
- Similarly, delete all KIVA-related entries from the following environment variables:
BASE_CLASSPATH
CLASSPATH
IT_CONFIG_PATH
GX_INCLUDE
GX_KDSROOTDIR
INCLUDE
KDS_CLASSPATH
LIB- Reboot the machine. You must reboot the system to complete uninstallation. In particular, you must reboot before reinstalling Netscape Application Builder.
Uninstalling Netscape Extension Builder 2.x
Select Uninstallerfrom the Netscape Extension Builder 2.xprogram group in the Start menu, or choose Netscape Extension Builder 2.xfrom the Add/Remove Programs control panel and click Add/Remove.
Uninstalling Under Solaris 2.6 or 2.7
- Very important: Copy any projects and application files you want to preserve out of the nebdirectory.
- From the nebdirectory, run the following script:
bin/nebRemove.sh
Copyright © 2000, Sun Microsystems, Inc. Some preexisting portions Copyright © Netscape Communications Corporation. All rights reserved.