Java Dynamic Management Kit 4.1 Installation Guide and Release Notes

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.8 to 1.2.2. Make sure that the java command is in your path before running the installer script.

Installing the Product Software
  1. Insert the product CD-ROM into the CD-ROM drive.

  2. Click the Start button on the taskbar, then choose Programs--Windows NT Explorer.

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

  4. 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 Procedure" for a workaround.

  5. 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 Product Software" 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 file system.


  6. 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. These printable documents are not included in the installed packages for space considerations. See "Printable Documents" for a description of the Java Dynamic Management Kit documentation set.

  7. When you are finished, eject the CD-ROM.

Alternate Installation Procedure

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
  1. Open the other folder at the root of the CD-ROM

  2. Extract the contents of the jdmk41.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 tools from their corresponding Java class: com.sun.jdmk.tools.ProxyGen and com.sun.jdmk.tools.MibGen.


Removing or Reinstalling the Product Software

You should remove the existing software packages if you are reinstalling version 4.1 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 will need to delete the files of the installation by hand.


Running the Uninstallation Wizard
  1. 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.1\JDKversion"
    C:\>java uninstall_jdmk41_nt_JDKversion
    

    You may need to add the current directory (.) to your classpath to run the wizard class.

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

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


    Note -

    The uninstallation wizard can only remove packages added during the previous installation. If packages remain after running the uninstallation wizard, you will need to delete their files by hand.