Sun Microsystems, Inc  Sun Microsystems, Inc 

JavaTM Dynamic Management Kit 5.1


Installation Instructions

Table of Contents


Introduction

This installation guide contains instructions to install the Java Dynamic Management Kit (Java DMK) 5.1 software from a local CD-ROM drive or from an electronic download. These instructions assume that you have experience installing software on the operating system that you are using.

If you are upgrading your Java DMK from versions 4.1, 4.2 or 5.0 to version 5.1, you are not required to uninstall the earlier version. Several versions of the product can coexist on the same system, since each version has its own version number in its installation path.


System Requirements

Java DMK 5.1 is officially supported on version 1.4 of the Java 2 Platform, Standard Edition (J2SETM). However, it will also run on version 1.3 provided that certain additional software packages are installed. Java DMK will also run on the 1.5 Beta release of the J2SE platform.

This product is supported on the SolarisTM operating system, and the Linux and Microsoft Windows operating systems. However, there should not be any dependency on a particular OS or hardware platform.

See the RELEASE NOTES for details of the supported platforms and the validation performed.


Installation on a Solaris Platform

The version of Java DMK 5.1 for the Solaris operating system comprises the following packages.

Package Name

Package Description

SUNWjdmk-runtime

Contains the Java dynamic management runtime classes (jdmkrt.jar) and the runtime classes for the legacy packaging of the SNMP API (legacysnmp.jar). Install this package on all machines where you intend to develop or run Java dynamic management agents and manager applications.

SUNWjdmk-runtime-jmx

Contains the JMX runtime classes (jmx.jar), the JMX Remote API runtime classes (jmxremote.jar, and jmxremote_optional.jar), and the runtime classes for the security features (rmissl.jar, sasl.jar, and sunsasl.jar). Install this package on all machines that do not already have the latest reference implementations of the JMX and JMX Remote API specifications or the correct security features installed.

SUNWjdmk-runtime-sdk

Contains the Java dynamic management runtime classes for the Java DMK toolkit (jdmktk.jar), as well as the documentation, examples and contributions.

These packages require the following disk space:

Package Name

Disk Space (Mbytes)

Default Base Directory

SUNWjdmk-runtime

1.7

/opt

SUNWjdmk-runtime-jmx

1.0

/opt

SUNWjdmk-runtime-sdk

46.0

/opt

The installation software computes the size of the packages you want to install and warns you if your disk is full.

Installation Using the Installation Wizard

The installation process uses the Solaris Web Start WizardTM software to simplify and speed up the installation of packages on a Solaris platform. The installation wizard is a Java class that runs in the Java runtime environment, version 1.4. Make sure that the java command is in your path before you run the installation script.

If you cannot launch the installation wizard, follow the procedure "Installation Using the pkgadd Command".

If you are reinstalling the version 5.1 of the Java DMK software, you must first remove the existing software packages.

  1. If installing from a CD-ROM, insert the product CD-ROM into the CD-ROM drive. If installing from an Electronic Download, go to step 2.

  2. If installing from an Electronic Download, unpack the downloaded bundle to a location of your choice, downloadDir.

  3. Start the Java DMK installation.

    If installing from a CD-ROM:
    $ /cdrom/jdmk-5_1/solaris/install.sh

    If installing from an Electronic Download:
    $ downloadDir/jdmk-5_1/solaris/install.sh

  4. Type the root password for your system when prompted to do so by the installer.

    Solaris Web Start installer 
    To use this installer you will need to be the system's root user. 
    
    Please enter this system's root user password 
    Password: 

    This launches the interactive installer window from which you complete the installation. If you encounter problems while using the install.sh script or running the installation wizard, use the alternative installation procedure described in "Installation Using the pkgadd Command".

  5. Follow the instructions of the installation wizard to complete the installation.

    The installation wizard automatically creates an uninstallation wizard that can remove the exact configuration that is installed.

  6. (Optional) Click the Details button on the last screen of the wizard to check that the packages were successfully installed.

  7. Exit the wizard when you have completed the installation.

  8. (Optional) View the installation logs in the /var/sadm/install/logs directory.

  9. (Optional) View or copy the documents in the jdmk-5_1/docs directory.

    These printable documents are not included in the installed packages, for space considerations.

  10. If installing from a CD-ROM, when you have finished, unmount and eject the CD-ROM as follows:

Installation Using the pkgadd Command

You can use this installation procedure as an alternative to the installation wizard.

  1. If installing from a CD-ROM, insert the product CD-ROM into the CD-ROM drive. If installing from an Electronic Download, go to step 2.

  2. If installing from an Electronic Download, unpack the downloaded bundle to a location of your choice, downloadDir.

  3. Determine whether you need to specify a different base directory in which to install each package:

  4. Type the numbers corresponding to the packages you want to install.

    To install the full Java DMK, including the online documentation, type all to choose all the available packages. The installation program might prompt you with questions about package dependencies and running installation scripts. Type y to answer yes to all questions and complete the installation normally.

  5. If you used the -a none option, type the path to the base directory or directories where you want to install the packages, when prompted to do so.

    You must type an absolute path, for example:

    Enter path to package base directories [?,q] /home/username

  6. When the installation is finished, type q to quit pkgadd.

  7. (Optional) View or copy the documents in the jdmk-5_1/docs directory.

    These printable documents are not included in the installed packages, for space considerations. See Java Dynamic Management Kit 5.1 Getting Started Guide for a description of the Java DMK documentation set.

  8. When you have finished, if you installed from a CD-ROM, unmount and eject the CD-ROM as follows:

Reinstallation

If you are reinstalling version 5.1 of the Java DMK, you must first remove the existing software packages. You can then reinstall as normal.

Uninstallation Using the Uninstallation Wizard

If you installed Java DMK using the installation wizard, you must use the uninstallation wizard if you want to remove the packages, as described below.

  1. Become root user.

  2. Go to the location of the installed software and launch the uninstallation wizard.

    # cd installDir
    # java uninstall_jdmk_5_1_solaris

    You might need to add the current directory (.) to your CLASSPATH environment variable to run the wizard class.

  3. Follow the instructions of the uninstallation wizard to complete the uninstallation.

  4. (Optional) Click the Details button on the last screen of the wizard to check that the packages have been removed, and then exit the wizard.

  5. (Optional) View the uninstallation logs in the /var/sadm/install/logs directory.

If you have already tried to manually remove packages that were installed by the wizard, the Solaris Product Registry will still include Java DMK entries. To remove these entries, check to see whether the uninstallation class is still present in the installation directory. If so, invoke the uninstallation class and proceed as described above. You can then check whether the registry has been updated by using the prodreg tool.

Uninstallation Using the pkgrm Command

If you installed Java DMK using the installation wizard, you must use the uninstallation wizard if you want to remove the packages, as described above.

  1. Find out which Java DMK packages are installed on your machine, for example, by typing the following command:

    $ /bin/pkginfo | grep jdmk
    application SUNWjdmk-runtime       Java DMK 5.1 Runtime Library
    application SUNWjdmk-runtime-jmx   Java DMK 5.1 JMX libraries
    application SUNWjdmk-sdk           Java DMK 5.1 Development Tools
     

    The packages which you can remove are displayed.

  2. Become root user.

  3. Use the pkgrm command with the names of the installed packages to remove them.

    For example, if you have a full installation of the Java DMK, type the following command:

    # /usr/sbin/pkgrm SUNWjdmk-runtime SUNWjdmk-runtime-jmx SUNWjdmk-sdk 

Installation on a Microsoft Windows Platform

The version of Java DMK 5.1 for the Microsoft Windows platform comprises the following packages. The names of these packages include the number of the build of the software delivered.

Package Name

Package Description

sun-jdmk-runtime-5.1-b34.zip

Contains the Java dynamic management runtime classes (jdmkrt.jar) and the runtime classes for the legacy packaging of the SNMP API (legacysnmp.jar). Install this package on all machines where you intend to develop or run Java dynamic management agents and manager applications.

sun-jdmk-runtime-jmx-5.1-b34.zip

Contains the JMX runtime classes (jmx.jar), the JMX Remote API runtime classes (jmxremote.jar, and jmxremote_optional.jar), and the runtime classes for the security features (rmissl.jar, sasl.jar, and sunsasl.jar). Install this package on all machines that do not already have the latest reference implementations of the JMX and JMX Remote API specifications or the correct security features installed.

sun-jdmk-sdk-5.1-b34.zip

Contains the Java dynamic management runtime classes for the Java DMK toolkit (jdmktk.jar), as well as the documentation, examples and contributions.

These packages require the following disk space:

Package Name

Disk Space (Mbytes)

Default Base Directory

sun-jdmk-runtime-5.1-b34.zip

1.7

c:/Program Files

sun-jdmk-runtime-jmx-5.1-b34.zip

1.0

c:/Program Files

sun-jdmk-sdk-5.1-b34.zip

46.0

c:/Program Files

The installation software computes the size of the packages you want to install and warns you if your disk is full.

Installation Using the Installation Wizard

The installation process uses the Solaris Web Start Wizard software to simplify and speed up the installation of software on a Java technology-enabled platform. It is a Java class that runs in the Java runtime environment, version 1.4. Make sure that the java command is in your path before you run the installation script.

  1. If installing from a CD-ROM, insert the product CD-ROM into the CD-ROM drive. If installing from an Electronic Download, go to step 3.

  2. If installing from an Electronic Download, unpack the downloaded bundle to a location of your choice, downloadDir.

  3. Double-click the setup.bat file name or icon.

    This launches the interactive installer window from which you complete the installation.

  4. Follow the instructions of the installation wizard to complete the installation.

    The installation wizard automatically creates an uninstallation wizard that can remove the exact configuration that is installed.

  5. (Optional) 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 software components for space considerations.

  6. If installing from a CD-ROM, when you have finished, eject the CD-ROM.

Editing the proxygen and mibgen Scripts

Scripts are provided for launching proxygen and mibgen in the bin directories of the archive.

If you chose to install Java DMK in a directory other than the default, you must edit edit the mibgen.bat and proxygen.bat files before using them, to set the JDMK_HOME variable to your installation directory, that is, the directory containing the lib directory.

Uninstallation

If you wish to remove all of Java DMK you can do so via the Add/Remove Programs option in the Control Panel.

You can also use the uninstallation wizard, as follows.

  1. Open a command prompt window and go to the location of the installed software.

  2. Launch the uninstallation wizard class.

    C:\>cd installDir
    java uninstall_jdmk_5_1_windows

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

  3. Click the Details button on the last screen of the wizard to confirm that the uninstallation is complete, then exit the wizard.


Installation on a Linux Platform

The version of Java DMK 5.1 for Linux platforms comprises the following packages. The names of these packages include the number of the build of the software delivered.

Package Name

Package Description

sun-jdmk-runtime-5.1-b34.i386.rpm

Contains the Java dynamic management runtime classes (jdmkrt.jar) and the runtime classes for the legacy packaging of the SNMP API (legacysnmp.jar). Install this package on all machines where you intend to develop or run Java dynamic management agents and manager applications.

sun-jdmk-runtime-jmx-5.1-b34.i386.rpm

Contains the JMX runtime classes (jmx.jar), the JMX Remote API runtime classes (jmxremote.jar, and jmxremote_optional.jar), and the runtime classes for the security features (rmissl.jar, sasl.jar, and sunsasl.jar). Install this package on all machines that do not already have the latest reference implementations of the JMX and JMX Remote API specifications or the correct security features installed.

sun-jdmk-sdk-5.1-b34.i386.rpm

Contains the Java dynamic management runtime classes for the Java DMK toolkit (jdmktk.jar), as well as the documentation, examples and contributions.

These packages require the following disk space:

Package Name

Disk Space (Mbytes)

Default Base Directory

sun-jdmk-runtime-5.1-b34.i386.rpm

1.7

/opt

sun-jdmk-runtime-jmx-5.1.i386-b34.rpm

1.0

/opt

sun-jdmk-sdk-5.1-b34.i386.rpm

46.0

/opt

Installation

The Java DMK packages for the Linux platform are installed using the rpm command.

  1. If installing from a CD-ROM, insert the product CD-ROM into the CD-ROM drive.

  2. If installing from an Electronic Download, unpack the downloaded bundle to a location of your choice, downloadDir.

  3. Open a command prompt window and, as root user, go to the location of the linux directory on the CD-ROM or in downloadDir.

    cd CD-ROM/jdmk-5_1/linux
    

    Or,

    cd downloadDir/jdmk-5_1/linux
    
  4. Run the rpm command to install the packages of your choice.

    rpm -i sun-jdmk-runtime-5.1-b34.i386.rpm sun-jdmk-runtime-jmx-5.1-b34.i386.rpm sun-jdmk-sdk-5.1-b34.i386.rpm
    
  5. (Optional) View or copy the documents in the jdmk-5_1/docs directory.

    These printable documents are not included in the installed packages, for space considerations.

Uninstallation

The Java DMK packages for the Linux platform are uninstalled using the rpm command.

  1. Open a command prompt window and, as root user, remove the packages of your choice, without specifying the release or build information.

    rpm -e sun-jdmk-runtime sun-jdmk-runtime-jmx sun-jdmk-sdk
    


Installation on Other Platforms

If you are installing the Java DMK software on a platform other than a Solaris platform, a Windows platform, or a Linux platform, you extract the software from a ZIP file.

  1. Open the other-platforms folder at the root of the CD-ROM or the downloaded software bundle.

  2. Extract the contents of the sun-jdmk-runtime-5.1-b34.zip, sun-jdmk-runtime-jmx-5.1-b34.zip, and sun-jdmk-sdk-5.1-b34.zip files to the installDir folder of your choice.

  3. (Optional) View or copy the documents in the jdmk-5_1/docs directory.

    These printable documents are not included in the installed packages, for space considerations.

Editing the proxygen and mibgen Scripts

Scripts are provided for launching proxygen and mibgen in the bin directories of the archive.

You must edit edit the mibgen and proxygen files before using them, to set the JDMK_HOME variable to your installation directory, that is, the directory containing the lib directory.

It is also possible to use the proxygen and mibgen tools by adding the jdmktk.jar file to your class path and then launching these tools from their corresponding Java class: com.sun.jdmk.tools.ProxyGen and com.sun.jdmk.tools.MibGen.

Uninstallation

To remove the files installed as described in this section, you must delete them manually.