Installation procedure

LINUX

Note: installation can only be performed for PBA on RHEL6/CentOS6.

  1. The Term::ReadKey Perl module must be installed beforehand. Issue following commands:

    perl -MCPAN -eshell
    install Term::ReadKey
    
  2. Copy the file /usr/local/bm/etc/ssm.conf.d/.wd.conf to /usr/local/bm/etc/ssm.conf.d/wd.conf.
  3. Provide values for parameters in wd.conf :

    • MAIL_PREFIX - Replace with customer's company name, for example, "Provider, Inc."
    • MAIL_FROM - Replace with e-mail address that will be displayed in the "From" field of notifications, for example, "support@provider.inc"
    • MAIL_TO - List of e-mails (separated with commas) that will receive notifications sent by Watchdog. Please preserve "bugreports@stellart.net" in this list.
    • MODULES - List of used Watchdog modules. Supported modules under Linux are: a) HTTP b) service and c) process. Default value: HTTP service process.
    • WWW_URL - URL of PBA CP Watchdog will address its requests to. Default value: https://127.0.0.1
    • CP_PATH - URL of PBA resource Watchdog will send requests to in order to check CP availability.

    Default value for PBA 5.4: www/nologin/act/BM/SubscrReasonCode_GetWin/StandardInput/?ReasonID=1

    Default value for PBA 5.5: bss-www/nologin/act/AHRC/LanguageGetAvailableLanguagesList/

    • DUMP_SERVERS - List of PBA services to restart if CP doesn't respond with 200 [OK]. Default value: www BM
    • VS_TRESHOLD - Amount of allowed VSS memory (in KB) each process can consume. If any process exceeds this threshold, Watchdog will generate a corresponding notification. Default value: 4000000
    • RS_TRESHOLD - Amount of allowed RSS memory (in KB) each process can consume. If any process exceeds this threshold, Watchdog will generate a corresponding notification. Default value: 1500000

    Note: Entries MODULES , WWW_URL, CP_PATH, DUMP_SERVERS, VS_TRESHOLD, and RS_TRESHOLD can be removed if their default values satisfy your needs.

  4. Perform a quick check with this command:

    SSMROOT=~bm ssm start wd -D http dummy check
    

    The output should contain the records like this:

    [Thu Nov 25 23:07:49 2010] [HTTP] [INFO] Checking WWW at https://127.0.0.1/www/nologin/act/BM/SubscrReasonCode_GetWin/StandardInput/?ReasonID=1
    [Thu Nov 25 23:07:49 2010] [HTTP] [DEBUG] Checking server availability..
    [Thu Nov 25 23:07:49 2010] [HTTP] [DEBUG] Server respond 200 OK in 0.280 sec. Content length: 17723 bytes.
    

    If the quick check fails, stop and contact Parallels Technical Support.

  5. In order to make Watchdog autostart along with PBA, create or edit the file /usr/local/bm/etc/ssm.conf.d/pba.conf in the following way:

    [options]
    startdep = $(startdep) wd
    
  6. To start Watchdog, execute the command:

    /etc/init.d/pba start wd
    

WINDOWS

Note: installation can only be performed for PBA on Windows 2008 (64-bit).

  1. Copy and paste the file <PBA_HOME>\.wd.conf to <PBA_HOME>\wd.conf.
  2. Provide values for parameters in wd.conf as described above for Linux installation. In this case, there are just a few differences:

    • Parameter MAIL_RELAY must be provided with an SMTP server that will be used for e-mail deliveries in this format: "<server-name>:<port>" (e.g., smtp.provider.inc:465).
    • Parameter MODULES can contain only: a) HTTP and b) service.
    • Parameters VS_TRESHOLD and RS_TRESHOLD are not used with Windows.
  3. Perform a quick check with the command:

    ssm start wd -D http dummy check
    

    The output should contain the records like:

    [Thu Nov 25 23:07:49 2010] [HTTP] [INFO] Checking WWW at https://127.0.0.1/www/nologin/act/BM/SubscrReasonCode_GetWin/StandardInput/?ReasonID=1
    [Thu Nov 25 23:07:49 2010] [HTTP] [DEBUG] Checking server availability..
    [Thu Nov 25 23:07:49 2010] [HTTP] [DEBUG] Server respond 200 OK in 0.280 sec. Content length: 17723 bytes.
    

    If the quick check fails, stop and contact Parallels Technical Support.

  4. Install Watchdog service:

    ssm install wd
    
  5. In order to make Watchdog autostart along with PBA, create or edit the <PBA_HOME>\etc\ssm.conf.d\pba.conf file in the following way:

    [options]
    startdep = $(startdep) wd
    
  6. To start PBA Watchdog, execute this command:

    ssm start wd
    

Upgrade procedure

Watchdog upgrade from PBA 5.1 is seamless and doesn't require any manual actions/reconfigurations.

Additional information

Refer to KB article #113451 for more information about PBA watchdog.

Internal content

Link on internal Article