Chapter 2 Installation on a Windows NT Platform
The steps for installing the Java Dynamic Management Kit in a Windows NT environment
are described in these sections:
Planning Your Installation
Decide where to install the packages supplied with the Java Dynamic Management Kit,
and ensure your machines meet the installation requirements.
Upgrading from Previous Versions
If you are upgrading your Java Dynamic Management Kit from versions
3.0 or 3.2, you are not required to uninstall the earlier version. Version 4.0
has different package names and a different installation structure that allows
both old and new versions of the product to co-exist on the same machine.
However, if you are reinstalling version 4.0 of the Java Dynamic Management Kit,
you should first remove your previous installation. This procedure is described
in "Removing or Reinstalling the Java Dynamic Management Kit on a Windows NT Platform". Then you may proceed to reinstall the current
version.
Software Packages
The Java Dynamic Management Kit 4.0 is composed of four software packages
that can be installed individually. They are described in Table 2-1.
It is possible to install only certain packages on a machine, according to
your requirements. The software is packaged identically for the JDK 1.1 and
Java 2 environments, only the contents of each package differ.
Table 2-1 Software and Documentation Packages
|
Package Name
|
Package Description
|
|
Runtime
|
Contains Java Dynamic Management run-time classes. Install this package
on all machines where you intend to develop or run Java Dynamic Management agents and
manager applications.
|
|
Tools
|
Contains the Java Dynamic Management Kit tools (proxygen
and mibgen). Install this package on all machines where
you intend to develop Java Dynamic Management agents and manager applications.
|
|
Examples
|
Contains the Java source code files of the
supplied examples. Installing this package is optional.
|
|
Documentation
|
Contains all documentation for the Java Dynamic Management Kit
in HTML format. Installing this package is optional.
|
Installation Requirements
Hardware
Java Dynamic Management Kit 4.0 runs on Intel platforms with a minimum
of 32 Mbytes of RAM.
Software
The Java Dynamic Management Kit 4.0 requires the following software:
Disk Space
The following table shows the minimum disk space required for each installation.
|
Description
|
Disk Space for JDK 1.1 (Mbytes)
|
Disk Space for Java 2
(Mbytes)
|
| Runtime classes |
0.8
|
0.5
|
| Toolkit classes |
1.0
|
0.8
|
| Examples |
0.8
|
0.8
|
| Documentation |
6.8
|
5.9
|
| Total: | 9.4 | 8.0 |
The installation software will compute the disk space needed for the
packages you choose and warn you if the installation cannot be completed.
By default, the files will be installed under the C:\Program
Files directory, but you can specify a different path during the Custom installation.
Installing the Software on a Windows NT Platform
These instructions assume that you are already familiar with installing
software products on machines running a Windows NT environment, and that you
are installing from a local CD-ROM drive.
The installation process uses the Solaris Web Start WizardsTM software to simplify and speed up the installation of packages
on a Java technology-enabled platform. It is a Java class that runs in the
Java Runtime Environment, from version 1.1.6 to 1.2.2. Make sure that the java command is in your path before running the installer script.
Installing the Product Software
-
Insert the product CD-ROM into the CD-ROM drive.
-
Click the Start button on the taskbar, then choose Programs--Windows
Explorer.
-
Double-click the CD-ROM icon to see the contents of the CD-ROM and open
the folder named nt. Then choose either the 11 folder or the 12 folder according to the
Java environment in which you will use the Java Dynamic Management Kit.
You may perform both installations if you wish, they are placed in distinct
directories.
-
Open the chosen folder and double-click the setup.bat
filename or icon.
This will launch the interactive installer window from which you will
complete the installation. If you encounter problems while using the setup.bat scripts or running the installation wizard, please see "Alternate Installation Procedures" for a workaround.
-
Follow the instructions of the installation wizard to lead you through
the installation.
If you choose the Typical installation, all packages
will be installed in the default location: C:\Program Files.
If you choose the Custom installation, you can select
the packages you want to install and specify a different location. Click the "Browse"
button and then choose the path of the new installation directory.
In every case, the installation wizard will automatically create an
uninstallation wizard that can remove the exact configuration that was installed.
See "Removing or Reinstalling the Java Dynamic Management Kit on a Windows NT Platform" for details.
Note -
The installation wizard doesn't update the Windows NT registry with
information about the installed packages, it only unpacks and moves files
to your filesystem.
-
Once the installation is finished, you may want to view or copy the
documents in the docs folder at the root of the CD-ROM.
See "Printable Documents" for a description of these books. When you are
finished, eject the CD-ROM.
Alternate Installation Procedures
If you cannot launch the installation wizard, you will have to manually
copy the product files from the CD-ROM to your disk. Follow this procedure
to find the files and install them properly:
Installing from the ZIP file
-
Open the others folder at the root of the CD-ROM
-
Extract the contents of the jdmk40.zip file to
the installDir folder of your choice.
This file contains the whole file hierarchy of a full installation for
both the JDK 1.1.x and Java 2 environments. Either
delete the branches of this hierarchy that you don't need, or use an archive
utility to extract only the files you need.
Note -
This archive is not platform specific and therefore doesn't contain
the scripts for launching proxygen and mibgen in its bin directories. Instead, you have
to launch these files from their corresponding Java class: ProxyGen and MibGen, respectively.
Removing or Reinstalling the Java Dynamic Management Kit on a Windows NT Platform
You should remove the existing software packages if you are reinstalling
version 4.0 of the Java Dynamic Management Kit. If you installed the packages
with the installation wizard, there is a Java class file which you can launch
to lead you through the uninstallation procedure. Make sure that your classpath
is set up properly for your version of the java command.
Note -
Because the packages of the Java Dynamic Management Kit are not listed in the Windows
NT registry, you must go through the uninstaller to remove the software. If
you installed the software from the ZIP file, you have to delete the files
in the installation by hand.
Running the Uninstallation Wizard
-
Open a command prompt window and go to the location of the installed
software and launch the uninstallation wizard class:
C:\>cd "installDir\SUNWjdmk\jdmk4.0\JDKversion"
C:\>java uninstall_jdmk40_nt_JDKversion
|
You may have to add the current directory (.) to
your classpath to run the wizard class.
-
Choose the type of uninstallation you wish to perform and follow the
instructions.
A Full uninstall will remove all of the Java Dynamic Management Kit
packages that were installed.
A Partial uninstall will let you choose the packages
you wish to remove. You may launch this wizard again to remove the other packages
at a later date.
-
Click the "Details" button on the last screen of the wizard
to make sure the uninstallation is complete. When you are done, exit the wizard.
Setting Environment Variables in a Windows NT Environment
PATH and CLASSPATH
The CLASSPATH environment
variable tells the Java virtual machine where to find the class libraries,
such as the jdmkrt.jar file.
The PATH environment variable
specifies the location of executable files, for example, the proxygen tool and the mibgen compiler.
The tools provided in the Java Dynamic Management Kit and the programs that you compile
and run rely on the values in these variables. Modify these environment variables
according to your Java version, as shown in Table 2-2.
Table 2-2 Environment Variables for the Windows NT Environment
|
Environment Variable
|
Add
|
|
CLASSPATH
|
installDir\SUNWjdmk\jdmk4.0\1.1\lib\jdmkrt.jar;installDir\SUNWjdmk\jdmk4.0\1.1\lib\jdmktk.jar;installDir\SUNWjdmk\jdmk4.0\1.1\lib\collections.jar
|
|
or
|
installDir\SUNWjdmk\jdmk4.0\1.2\lib\jdmkrt.jar;installDir\SUNWjdmk\jdmk4.0\1.2\lib\jdmktk.jar
|
|
PATH
|
installDir\SUNWjdmk\jdmk4.0\1.1\bin
|
|
or
|
installDir\SUNWjdmk\jdmk4.0\1.2\bin
|