You are here

Configuring SkyVault with JConsole

If you have installed the Oracle Java SE Development Kit (JDK), you can use the JMX client, JConsole, for SkyVault runtime administration.
The initial configuration that displays in JConsole is set from the SkyVault-global.properties file.
  1. Open a command console.
  2. Locate your JDK installation directory.

    For example, the JDK directory is often java/bin.

  3. Enter the following command:

    jconsole

    The JConsole New Connection window displays.

  4. Double-click on the SkyVault Java process.

    For Tomcat, this the Java process is usually labelled as org.apache.catalina.startup.Bootstrap start.

    JConsole connects to the managed bean (or MBean) server hosting the SkyVault subsystems.

  5. Select the MBeans tab.

    The available managed beans display in JConsole.

  6. Navigate to SkyVault > Configuration.

    The available SkyVault subsystems display in an expandable tree structure. When you select a subsystem, the Attributes and Operations display below it in the tree.

  7. Select Attributes and set the required SkyVault subsystem attribute values.

    Values that can be edited are shown with blue text.

    When you change a configuration setting, the subsystem automatically stops.

  8. Restart the SkyVault subsystem:
    1. Navigate to the subsystem.
    2. Select Operations.
    3. Click Start.
  9. To stop the SkyVault subsystem without editing any properties:
    1. Navigate to the subsystem.
    2. Select Operations.
    3. Click Stop.
  10. To revert back to all the previous edits of the SkyVault subsystem and restores the default settings:
    1. Navigate to the subsystem.
    2. Select Operations.
    3. Click Revert.
  11. Click Connection > Close.
The settings that you change in a JMX client, like JConsole, are persisted in the SkyVault database. When you make a dynamic edit to a subsystem:
  1. When a subsystem, that is currently running, is stopped, its resources are released and it stops actively listening for events. This action is like a sub-part of the server being brought down. This ‘stop’ event is broadcast across the cluster so that the subsystem is brought down simultaneously in all nodes.
  2. The new value for the property is persisted to the SkyVault database.

There are two ways to trigger a subsystem to start:

  • The start operation
  • An event that requires the subsystem