Parallels

Symptoms

Some items like webspace, domain, mailbox are shown as being not in sync in POA CP.

Cause

Most probably, some scheduled activity was not completed successfully. POA schedules various tasks almost for any operation (like provisioning, changing configuration, updating statistics and so on), if such task fails - related objects can be out of sync.
 

Resolution

Common way to fix such issues is to find a corresponding failed task in the task manager, fix it and re-run. Please see http://kb.swsoft.com/en/2246 for general info about dealing with POA tasks.


How to find corresponding failed tasks:

for a webspace:
    Webspace is out of sync when some scheduled operations for its domain service are not performed yet, to check if there are any, one may use the following command (should be executed on POA management node):
where 123456 is a webspace ID (available in the CCP).

For example:

This output shows that there are 10 pending operations (tasks) for domain service 188791, to find related tasks in POA one should copy the ds_id and search in background tasks, filtering by queue name domain_service$ds_id (in our example: domain_service188791).

Webspace may be also marked as not in sync if exclusive IP could not be assigned to it and that IP was left in state 'configuring' in POA database. In that case it is needed to find out why POA could not assign exclusive IP to webspace, solve the problem and update POA database - set 'configured_ips.state' to 'A' for the IP address in question.

for a DNS domain:
    POA has only one task for handling DNS updates, it is a periodic task 'Update name servers state' which runs every 10 minutes (by default) and it does not need manual rescheduling. However, it makes sense to check if the task was finished successfully the last time or not. Possible out of sync issues can be caused by three things:
    a) domain has not ready registrar status (article #2255)
    b) some DNS records keep failing to propagate to one or all DNS servers (article #2256)
    c) domain's webspace is not in sync

for a Qmail mailbox:
    QMail related tasks are grouped by Qmail hosting ID and can be found in background tasks by the following queue name: qmail_hosting_$id. This $id can be retrieved from the following command (execute it on POA management node):

where 12345 is a mailbox ID from the CCP.

For example:


In the example above there is one operation for hosting_id 42213 pending - use qmail_hosting_42213 as queue name filter in background tasks.

for an Exchange mailbox:
    Usually, it is possible to look-up an Exchange task by a mailbox name (e.g. enter *sales* in the name field in Task Manager > Background Tasks, where sales is a mailbox name). General way is to select such tasks by a domain service, ID can be retrieved from the following command (should be executed on POA management node):

where 12345 is a mailbox id, available in the CCP.

For example:

Sync status is positive, that means the mailbox is out of sync, related tasks can be found using the following filter as queue name: DomainService*4.

for a VPS:
    VPS can stuck in creating/stopping/starting/etc states. To find corresponding task for the VPS, one needs to get VPS host ID on the following screen: Top > Service Director > Virtuozzo Manager > VPSs (refer to the ID column). And locate tasks with the queue name vps*$ID, for example vps*123 for a VPS with host ID 123.

NOTE: VPS host ID is not the same as ID of VPS on Virtuozzo server, it is internal POA ID of VPS. To locate a task VPS host ID is needed, not ID of VPS on Virtuozzo server.