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

These are the prerequisites for installing Netscape Extension Builder 4.0:

Installation Requirements

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.
 

Initial State

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.

 

System Requirements

The following table lists the hardware and software requirements for installing Netscape Extension Builder 4.0.
 

Device

Requirement

Computer/Operating system

Windows:
Intel Pentium microprocessor running Windows NT version 4.0 with Service Pack5

Solaris:
Sun SPARC running Solaris 2.6 or 2.7

Memory

96 MB minimum; 128MB recommended

Available disk space

Windows:

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

Network software

TCP/IP

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.  

 

Installing Netscape Extension Builder

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:

  1. Run the System program from the Control Panel folder.
  2. Click the Environment tab.
  3. In the System Variable list box highlight the MSDEV_INSTALLDIR.
  4. 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:

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.sh

Continue 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/nas

Enter 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/neb

 Set 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:

After setting environment variables as described in this section, you can run Netscape Extension Builder 4.0 by typing:
% neb.
 

Uninstalling NAS Software

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

To uninstall Netscape Extension Builder 4.0, perform the following steps:

  1. Very important: Copy any projects and application files you want to preserve out of the nebsubdirectory.
  2. From the Start menu, choose Settings, and then Control Panel.
  3. Open Add/Remove Programs and highlight Netscape Extension Builder 4.0.
  4. 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:

  1. Very important: Copy any projects and application files you want to preserve out of the Apps subdirectory.
  2. 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?
  3. 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?
  4. 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. 
  5. Click OK.
  6. 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:

  1. 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.
  2. Very important: Copy any projects and application files you wish to preserve out of the KIVA Apps directory.
  3. From the KIVA program group, run KIVA Uninstaller. You can also use the Add/Remove ProgramsControl Panel to uninstall NAB.
  4. When uninstallation is complete, click Finish.
  5. Run the Registry Editor by typing regedt32or regedit at the Run command.
  6. Under HKEY_LOCAL_MACHINE\SOFTWARE, delete the KIVAkey.
  7. Delete the KIVAdirectory from the drive to which it was installed.
  8. 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 .....'.
  9. 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

  10. 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

  1. Very important: Copy any projects and application files you want to preserve out of the nebdirectory.
  2. 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.