Top
PRIMECLUSTER  Web-Based Admin ViewOperation Guide 4.6
FUJITSU Software

3.1.3 Preparing Java application

This section explains how to install and set up the Java application to use the Web-Based Admin View.

Take the following steps to prepare the Java application:

3.1.3.1 Installing Java application

To use the Web-Based Admin View screen, install the client Java application.

On the client to start the screen, access the following web page from the Web browser and download the installer of the client Java application (PRIMECLUSTER Web-Based Admin View Startup). The file name is "WVStartupInst.zip". Unzip the file and execute "WVStartupInst.exe".

http://[IP address of the management server]:[http port number of the management server]/download.html

When running the installer, enter the IP address (IPv4 or IPv6) and the http port number of primary and secondary management servers. Enter only the IP address of the primary management server if the management server is not duplicated.

These entered values are set as the connection information of two shortcuts (the shortcut and the desktop shortcut) created by the installer.

After the installer is completed, the following program group, the shortcut, and the desktop shortcut are created.

Program group:

\PRIMECLUSTER\PRIMECLUSTER Web-Based Admin View Startup\

Shortcut and desktop shortcut:
  • Shortcut name for a connection to the primary management server

    PRIMECLUSTER Web-Based Admin View Startup - Primary

  • Shortcut name for a connection to the secondary management server (only when inputting the IP address of the secondary management server)

    PRIMECLUSTER Web-Based Admin View Startup - Secondary

This Java application is installed in the home folder of a Windows login user ("C:\Users\[User name]\" is used for later examples). This installation folder cannot be changed later. Install the Java application in each user who executes it. About 200MB disk resources are consumed for each installation user.

Example of installation folder:

C:\Users\[User name]\AppData\Local\Programs\PRIMECLUSTER Web-Based Admin View Startup\


Before using the Java application on Windows Server(R), install the Java application and then take the following steps to add the Java application execution program (javaw.exe) to the allowed communication applications through Windows Firewall.

  1. Obtain the command path of the Java application execution program.

    Copy the command path of "javaw.exe" from [Target] in the properties of the shortcut.

    Example of "javaw.exe" command path:

    C:\Users\[User name]\AppData\Local\Programs\PRIMECLUSTER Web-Based Admin View Startup\bin\javaw.exe

  2. Set to allow the Java application execution program (command path copied in Step 1) to the Windows firewall.

Note

  • Installing the Java Runtime Environment (JRE) is not necessary as it is included in the Java application.

  • When installing a new version of Java application, install it without uninstalling the existing version that is already installed. The existing configuration information can be retained.

3.1.3.2 Setting up Java application

The shortcut and the desktop shortcut of the Java application retain the connection target information (IP address and http port number of the management server) specified by the "PRIMECLUSTER Web-Based Admin View Startup" installer.

Edit the [Target] parameter from properties of the shortcut and the desktop shortcut to confirm and modify the connection target information.

See the example below when setting "10.20.30.40" for the IP address of the management server and "8081" for the http port number of the management server.

Example of [Target] parameter of the shortcut (IPv4) (set as follows without line break):

"C:\Users\[User name]\AppData\Local\Programs\PRIMECLUSTER Web-Based Admin View Startup\bin\javaw.exe"
-jar "WVStartup.jar" "10.20.30.40" "8081"

See the example below when setting "1080:2090:30a0:40b0:50c0:60d0:70e0:80f0" for the IP address of the management server.

Example of [Target] parameter of the shortcut (IPv6) (set as follows without line break):

"C:\Users\[User name]\AppData\Local\Programs\PRIMECLUSTER Web-Based Admin View Startup\bin\javaw.exe"
-jar "WVStartup.jar" "1080:2090:30a0:40b0:50c0:60d0:70e0:80f0" "8081"

When starting the Web-Based Admin View screens of multiple cluster systems, copy the shortcut and the desktop shortcut of the existing cluster system and change them to the IP addresses (httpip) and the http port number information of the connection target management server in other cluster systems.

Parameters other than the connection target information are retained in the configuration file. Since the configuration file is created for each Windows user who installed the Java application, the Web-Based Admin View screens of multiple cluster systems cannot be started with different setting values. Separate Windows users for each cluster system.

The following parameters can be set in the configuration file (WVStartup.properties).

Parameter key

Function

Default value

Settable value

redirect

Automatic connection to the management servers

yes

yes or no

initialwait

Maximum waiting time (second)

60

Integers from 10 to 2147483647

language

Display language settings on a client

auto

ja, en, or auto

Note

  • initialwait is the maximum waiting time. It is not a parameter that guarantees the specified waiting time for connection.
    The waiting time for connection may end earlier than initialwait depending on a client OS and a network environment.

  • When using the language of Windows(R) OS that is not Japanese or English, set "en" to "language" of the environment setting parameter.

When changing the settings if necessary, move to the "File location:" below and edit the configuration file (WVStartup.properties).

The configuration parameter "redirect" sets up yes/no of the automatic connection to the management server.

When automatically selecting and connecting with the running management server (primary or secondary), set "yes".

This setting enables the automatic connection of the primary/secondary management server, and the automatic migration function of the secondary management server.

When connecting with the specified management server without using automatic connection or automatic migration function, set "no".

For details of the automatic migration function of the secondary management server, refer to "7.4 Secondary management server automatic migration."

File location:

C:\Users\[User name]\AppData\Local\Programs\PRIMECLUSTER Web-Based Admin View Startup\

File name:

WVStartup.properties

Parameter:

redirect

Function:

Automatic connection to the management servers

Settable values:

yes/no (default value: yes)

Setting example (in the WVStartup.properties file):

redirect = yes

To directly connect with the secondary management server, set the redirect parameter to "no" and then start the Web-Based Admin View screen from the shortcut (or desktop shortcut) where the secondary management server is set as the IP address of the connection management server.

For the parameters other than redirect parameter, see the following sections.