Installation procedure
LINUX
Note: installation can only be performed for PBA on RHEL6/CentOS6.
The Term::ReadKey Perl module must be installed beforehand. Issue following commands:
perl -MCPAN -eshell install Term::ReadKey
- Copy the file /usr/local/bm/etc/ssm.conf.d/.wd.conf to /usr/local/bm/etc/ssm.conf.d/wd.conf.
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.
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.
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
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).
- Copy and paste the file
<PBA_HOME>\.wd.conf
to<PBA_HOME>\wd.conf
. 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.
- Parameter MAIL_RELAY must be provided with an SMTP server that will be used for e-mail deliveries in this format:
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.
Install Watchdog service:
ssm install wd
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
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.