4.3.3 Initial Setup of Web-Based Admin View

When using Web-Based Admin View for the first time, you need to initialize the management server on each node. Take the following steps in the order listed below.

Operation Procedure:

Stop Web-Based Admin View on all the management servers and nodes.
```
# /etc/init.d/fjsvwvcnf stop
# /etc/init.d/fjsvwvbs stop
```
Set the IP addresses of the primary management server and the secondary management server.
```
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam primary-server <primary-management-server-IP-address>
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam secondary-server <secondary-management-server-IP-address>
```
- In the case of multiple-node cluster operation
  Execute the command above on all the management servers and nodes, referring to the example.
  Example: Set "Primary" - "IP address" and "Secondary" - "IP address" found on "Setup (initial configuration)" of PRIMECLUSTER Designsheets.
```
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam primary-server 10.20.30.40
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam secondary-server 10.20.30.41
```
- In the case of the single-node cluster operation
  For each IP address of the primary management server and the secondary management server, specify the IP address of the own node.
  Example:
```
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam primary-server 10.20.30.40
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam secondary-server 10.20.30.40
```
  In addition, no value is displayed in Web-Based Admin View on the secondary management server.

Restart Web-Based Admin View on all the management servers and nodes.

For RHEL6

# /etc/opt/FJSVwvbs/etc/bin/wvCntl restart
# /etc/init.d/fjsvwvcnf restart

For RHEL7

# /etc/init.d/fjsvwvbs restart
# /etc/init.d/fjsvwvcnf restart

See

Web-Based Admin View has some different operation management modes. For further details, see "1.2.2 System topology" and "Chapter 7 Web-Based Admin View setup modification" in "PRIMECLUSTER Web-Based Admin View Operation Guide."

Note

For making entries to /etc/hosts in Japanese, use EUC encoding and set "ja" for the system requirements variable "lang" for Web-Based Admin View. For further details on the Web-Based Admin View language settings, refer to "4.3.3.3 Setting the Web-Based Admin View Language."
Only the IP addresses can be set to the primary management server and secondary management server.
Sometimes after restarting Web-Based Admin View, it cannot be started and the message below is displayed.
```
wvcheckconf Error: [sys:group-addr] invalid IpAddress[Host name]
wvcheckconf: 'webview.cnf' has not been modified by some Errors.
FJSVwvbs: 'webview.cnf' abnormal
```
This message is displayed when group-addr, which is the environment variable of Web-Based Admin View, is not correctly specified.
Refer to the group address setting in "7.4 Secondary management server automatic migration" in "PRIMECLUSTER Web-Based Admin View Operation Guide" and set the group-addr value correctly.
If the information of both primary and secondary management servers is not set in /etc/hosts, refer to "Appendix B Troubleshooting" in "PRIMECLUSTER Web-Based Admin View Operation Guide" and set the information.

4.3.3.2 Confirming Web-Based Admin View Startup

This section describes the procedure for confirming whether Web-Based Admin View has been started

Confirmation Procedure

Check that all node information is output by executing the "wvstat" command on the connected management server.

(Example)

In a two-node configuration consisting of node1(10.20.30.40) and node2(10.20.30.41), node1 is the primary management server and node2 is the secondary management server.

# /etc/opt/FJSVwvbs/etc/bin/wvstat
primaryServer   10.20.30.40 node1  http=10.20.30.40     Run  3m41s
primaryServer   Sessions: 0
primaryServer   Nodes: 2
        10.20.30.40 node1      Linux-2.4.9-e.8enterprise       3m36s
        10.20.30.41 node2      Linux-2.4.9-e.8enterprise       2m58s
secondaryServer 10.20.30.41 node2  http=10.20.30.41     Run  2m46s
secondaryServer Sessions: 0
secondaryServer Nodes: 2
        10.20.30.40 node1      Linux-2.4.9-e.8enterprise       2m41s
        10.20.30.41 node2      Linux-2.4.9-e.8enterprise       2m23s

Make sure that the information of the nodes connected to each management server is properly displayed. If the information is not properly displayed, check the following points:

If the information is not properly displayed, Web-Based Admin View has not been started or there may be an error in the Web-Based Admin View settings. Restart Web-Based Admin View and execute the operation again. If node information is still not displayed, refer to "2.4 Initial Setup of Web-Based Admin View" in "PRIMECLUSTER Web-Based Admin View Operation Guide" and check the parameter settings.
Communication with the management servers may be blocked by firewall. When using firewalld, iptables, or ip6tables as firewall, permit the communication with the port numbers used by Web-Based Admin View. For details , see "Appendix L Using Firewall."

For details on the "wvstat" command, see the manual page.

4.3.3.3 Setting the Web-Based Admin View Language

The language environment in which Web-Based Admin View operates is set to English as default. Even though the client has a Japanese environment, the text of cluster resource management facility messages that are sent from the cluster node is displayed in English.

If you want to display the messages in Japanese, take the following steps to set up environment variables of Web-Based Admin View. You need to set up the variables using a system administrator access privilege on all the nodes and the cluster management servers that construct a cluster system.

This operation must be executed with the system administrator authority for all cluster nodes and the cluster management server that make up the cluster system.

Table 4.3 Environment variable for the operation language of Web-Based Admin View
Attribute	Variable	Possible values	Meaning
sys	Lang	C, ja	Language environment in which Web-Based Admin View operates. C: Operates in English. ja: Operates in Japanese. If this variable is not set, Web-Based Admin View operates in the English environment.

Operation Procedure:

Stop Web-Based Admin View on all the management servers and nodes.
```
# /etc/init.d/fjsvwvcnf stop
# /etc/init.d/fjsvwvbs stop
```
Add the environment variable to the definition file (/etc/opt/FJSVwvbs/etc/webview.cnf) of Web-Based Admin View, and set the language.
Execute the following command on all the management servers and nodes, referring to the example.
```
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam -add <attribute> <environment-variable> <setting_value>
```
Example: Add the environment variable and set the operation language to Japanese.
```
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam -add sys lang ja
```

Restart Web-Based Admin View on all the management servers and nodes.

For RHEL6

# /etc/opt/FJSVwvbs/etc/bin/wvCntl restart
# /etc/init.d/fjsvwvcnf restart

For RHEL7

# /etc/init.d/fjsvwvbs restart
# /etc/init.d/fjsvwvcnf restart

Note

For Web-Based Admin View to display messages in Japanese, the language environment of the personal computers that are being used as clients must be set to Japanese. If a client has an English environment, the message contents turn into garbled characters by the above setting change.
To change the environment variable again after it is added by the above procedure, execute the following command:
```
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam lang <setting_value>
```
For details on the command, see "4.5.3 Environment variable modification" in "PRIMECLUSTER Web-Based Admin View Operation Guide."