Hitachi

JP1 Version 11 JP1/Performance Management User's Guide


1.2.2 Starting services on the monitoring console server

This subsection describes how to start the PFM - Web Console services on the monitoring console server.

Check that the PFM - Manager services that you want to connect PFM - Web Console are operating before starting the PFM - Web Console services.

Organization of this subsection

(1) Manually starting services on the monitoring console server

The following two methods can be used to start the PFM - Web Console services on the monitoring console server. Note that the instructions for starting services from the Control Panel apply only to Windows systems.

(a) Starting services using a command

Use the jpcwstart command to start services. With the jpcwstart command, you can start the services only on the host to which you have logged on. You cannot start the services of the Performance Management programs on the remote host.

  1. Log on to the monitoring console server (the host that has PFM - Web Console installed).

  2. Open the Administrator Console.

  3. Execute the jpcwstart command.

    Execute the command to start the PFM - Web Service and PFM - Web Console services.

(b) Starting services from the Control Panel

  1. Log on to the monitoring console server (the host that has PFM - Web Console installed).

  2. Choose Services in Windows.

  3. In the Services dialog box, right-click the PFM - Web Service service, and from the pulldown menu choose Start.

    The PFM - Web Console service also starts. If the PFM - Web Console service does not start, right-click the PFM - Web Console service, and from the pulldown menu, choose Start.

(2) Enabling or disabling the automatic service start feature for the monitoring console server (Windows)

With the default installation settings, the PFM - Web Console services are set to start automatically when the system starts. For this reason, no operation is necessary after starting the system.

To disable and enable the automatic start feature:
  1. Log on to the monitoring console server (the host that has PFM - Web Console installed).

  2. Choose Services in Windows.

  3. In the Services dialog box, select the PFM - Web Console service, and from the pulldown menu choose Properties.

  4. In the Properties dialog box for the PFM - Web Console service, set Startup type.

    To cancel the automatic start, select Manual.

    To reset the automatic start, select Automatic.

  5. Click the OK button.

    The Properties dialog box of the PFM - Web Console service is closed.

  6. Choose the PFM - Web Service service, and from the pulldown menu choose Properties.

  7. In the Properties dialog box for the PFM - Web Service, set Startup type.

    To cancel the automatic start, select Manual.

    To reset the automatic start, select Automatic.

  8. Click the OK button.

    Important
    • Make sure that the startup types of the PFM - Web Console services and the PFM - Web Service services are the same.

    • Do not change the settings of the service account. Changing the settings might cause service operation errors.

(3) Enabling or disabling the automatic service start feature for the monitoring console server (UNIX)

With the default installation settings, services are not set to start automatically when the system starts.

To set start services to start automatically at system startup, store in the installation folder for PFM - Web Console the script file for starting services automatically (jpcw_start). To disable the automatic service start feature, delete the jpcw_start file.

Note:

At startup, Performance Management is subject to the LANG environment variable set in the environment where it operates. Use the following example as a reference for editing the script file for starting services automatically (jpcw_start) to set the LANG environment variable for Performance Management.

Example settings:

LANG=LANG-environment-variable-to-set#

export LANG#

nohup /opt/jp1pcwebcon/tools/jpcwstart

#: A line to be added to the script file.

For details on the LANG environment variable values you can use with Performance Management, see the chapters on installation and setup in the JP1/Performance Management Planning and Configuration Guide and the manuals for PFM - Agent or PFM - RM.

Important

When the automatic service start and stop features are enabled in a CentOS 7, Linux 7, Oracle Linux 7, or SUSE Linux 12 environment and the jpcwstart command is used to start services, the services will not stop automatically when the OS shuts down. If you want the services to stop automatically, use the systemctl command to restart all Performance Management services. Alternatively, use the jpcwstop command to manually stop the services that were started by the jpcwstart command.

The following example uses the systemctl command to restart the services:

> systemctl stop jp1_webcon

> systemctl start jp1_webcon

To set automatic start of services:

  1. Log on to the host where you want to start services automatically.

  2. Execute the following command to move to the /opt/jp1pcwebcon directory:

    cd /opt/jp1pcwebcon
  3. Set the script file for starting services automatically for PFM - Web Console.

    • Name of the .model file of the service automatic start script: jpcw_start.model

    • Name of the script file for starting services automatically: jpcw_start

    Copy the .model file of the service automatic start script as the script file for starting services automatically, and add execution permission. Execute the commands as follows:

    cp -p jpcw_start.model jpcw_start
    chmod 555 jpcw_start
  4. Register the automatic start script file for AIX (in AIX only).

    To execute the automatic service start script file for PFM - Web Console specified in step 3, PFM - Web Console provides the automatic start script file for AIX. Register this automatic start script file into the AIX settings file.

    • Name of the automatic start script file: /etc/rc.jp1_webcon

    • Name of the settings file: /etc/inittab

    1. Use the mkitab command to register the /etc/rc.jp1_webcon file into the /etc/inittab settings file.

     mkitab "jp1pcwebcon:2:wait:/etc/rc.jp1_webcon >/dev/console 2>&1"

    2. Use the lsitab command to confirm that the /etc/rc.jp1_webcon file is registered in the /etc/inittab settings file.

     lsitab jp1pcwebcon
     jp1pcwebcon:2:wait:/etc/rc.jp1_webcon >/dev/console 2>&1

    Registering the file with the mkitab command places the file as the bottommost line of the /etc/inittab settings file. If a program linked by execution of an action is already registered in the /etc/inittab settings file, edit the /etc/inittab settings file so that the reference to the automatic start script file appears below it in the file.

    Also, the line added to the /etc/inittab settings file is not deleted upon uninstallation.

    To cancel the registration during uninstallation:

    1. Use the rmitab command to cancel the registration of the /etc/rc.jp1_webcon file from the /etc/inittab settings file.

     rmitab jp1pcwebcon

    2. Use the lsitab command to confirm that the /etc/rc.jp1_webcon file is not registered in the /etc/inittab settings file.

     lsitab jp1pcwebcon
  5. Register the Performance Management services into the OS (in CentOS 7, Linux 7, Oracle Linux 7, and SUSE Linux 12 only).

    The registration procedure is as follows:

    1. Edit the service automatic start script (/etc/init.d/jp1_webcon).

    Before editing:

    #!/bin/sh
    #
    # Title     : jp1_webcon
    # Explain   : This is a jp1_webcon file.
    # Copyright : All Rights Reserved. Copyright (C) 2011, Hitachi, Ltd.
    # Note      :
    # Version   : 09-50
      :

    After editing:

    #!/bin/sh
    #
    # Title     : jp1_webcon
    # Explain   : This is a jp1_webcon file.
    # Copyright : All Rights Reserved. Copyright (C) 2011, Hitachi, Ltd.
    # Note      :
    # Version   : 09-50
    ### BEGIN INIT INFO
    # Provides: jp1_webcon
    # Required-Start: $local_fs $remote_fs $syslog $network
    # Required-Stop: $local_fs $remote_fs $syslog $network
    # Default-Start: 3 5
    # Default-Stop: 0 6
    # Description: Start PFM services.
    ### END INIT INFO
      :

    2. Execute the following command:

    chkconfig jp1_webcon on

To disable automatic start of services, perform the procedure below.

Important

In CentOS 7, Linux 7, Oracle Linux 7, or SUSE Linux 12, also disable the automatic service stop feature when you disable the automatic service start feature. For details, see 1.3.2(3) Enabling or disabling the automatic service stop feature for the monitoring console server (UNIX).

  1. Delete the jpcw_start file that was stored when the automatic service start feature was set.

  2. Execute the following command to delete the Performance Management services that are registered in the OS (in CentOS 7, Linux 7, Oracle Linux 7, and SUSE Linux 12 only):

    chkconfig jp1_webcon off