Parallels H-Sphere Documentation Administrator Guide


Background Job Manager


Related Docs:   CP Cron Jobs (Sysadmin guide) CP Cron Configuration (Developer guide)

Last modified: 21 Dec 2007


WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

Background Job Manager is a utility that allows enabling, starting and disabling selected cron jobs from the admin control panel only.

This document will tell you how to manipulate cron jobs, see cron job details and view currently running jobs.

Manipulating Cron Jobs

To manupulate cron jobs via H-Sphere interface:

  1. Go to E.Manager - > Background Jobs- > Background Job Manager.

  2. On the page that shows, check necessary jobs:
  3. The listed cron jobs will do the following:
    • ASYNC_MAN: checks if asynchronous domain was created
    • BalanceExhaustionDateEstimator: estimates the period of time before the user balance will be exhausted
    • BoxesInfo: retrieves info from web/mail/etc boxes
    • CleanMailRelaysForMailServer (HS 3.1 Beta 1+): removes all mail relays from the mail server with none of mail domains
    • ComodoSSLRenewal: performs renewal for Comodo SSL certificates
    • DedicatedServerCancellation: cancels dedicated servers
    • DomainRegistrationRenewal: performs renewal for domains registered via domain registrar (i.e: OpenSRS)
    • ExpDateSynchronization (HS 3.1 Beta 1+): corrects expiration dates by requesting domain status from the registrar
    • MIGRATION: launches migration from other control panels
    • MSExchangeStats: collects MS Exchange mailbox usage statistics.
    • ResellerSupportBilling: bills resellers for the users' trouble tickets solved by admin.
    • Suspend: suspends debtors, finalizes incompletely suspended accounts and suspends users of suspended resellers
    • TTMailClient: gets mails using Settings -> Tech Support pop3 access.
      If pop3 access is wrong, H-Sphere creates TT for current admin, sets the value TT_POP3_ACCESS in Postgres table settings to 0. Next time the Cron is started, it will skip getting mails for admin with TT_POP3_ACCESS set to "0". To take emails for this admin next time, re-submit the admin Settings->Tech Support settings, and then set TT_POP3_ACCESS to 1.
    • accounting: performs recurrent billing for end users
    • contentMoving: completes the process of moving user content
    • escallation: sets higher priority to the tickets that are not answered for a long time
    • extcharge: processes the external_credits table and adds payments performed within an external payment system outside H-Sphere to this table as the account credits, thus integrating external payments into H-Sphere. More about external credits configuration.
    • fSignups: sends emails about failed signups (every 5 minutes)
    • mailSRS: monthly regenerates secret key used in the SRS address cipher
    • overlimit: checks that the account is not going over the limit
    • reseller: does billing for resellers
    • revenue: calculates summary billing info
    • transfer: moves accounts between boxes
    • trial: suspends expired trial accounts
    • ttAutoClose: closes trouble tickets answered certain time ago
    • vps: queries the status of creating virtual servers (every 4 minutes)
    • vpsReconfig: reposts net configuration for future VPS servers on each physical VPS box.
    • vps_templates (HS 3.1 Beta 1+): checks the status of vps templates
  4. Choose an action: enable, start or disable jobs. The chosen action will be perfomed for all selected jobs.
  5. Click the Apply button. The action will reflect in the job Status.

Cron Job Details

To view details of the specific job, click the Job name and you will see the page similar to this:

Job name shows the job to be executed:

Detailed description of cron jobs is listed in CP Cron Jobs.
  • Group name shows the group the job belongs to;
  • Status shows what action has been performed.
  • Priority ranges from 1 to 10. By default, priority is set as 5 (normal);
  • Start at is a time when the job is to be started next time;
  • Period is a time interval between the cron job launches, in minutes;
  • Before start, min: time left before cron job starts;
  • Launch count shows how many times the job was started since Job Manager was initialized (or since CP was started).

Read more about job details in CP Cron Configuration.

Current Jobs

To view the jobs that are currently running, choose Current Jobs on the admin control panel.

This page will show detailed information about the current jobs:

Id, Job name, Group name, Priority, Current status and job Progress in percents.

Depending on the current status of a job, you can restart, interrupt, suspend or resume specific jobs. To do it, check necessary jobs, select an action and click Apply.

Related Docs:   CP Cron Jobs (Sysadmin guide) CP Cron Configuration (Developer guide)

© Copyright 2018. Parallels Holdings. All rights reserved.