PLESK SERVER ADMINISTRATOR 5.0

Chapter 7. Managing the Server

As an administrator using the Plesk Server Administrator (PSA) software, you can perform a variety of server management tasks in a few clicks. When you are logged on as an administrator, click the SERVER button located at the top of the screen to bring up the Server Administration page. From this page, you can access the following functions:

  • System Management

    • Rebooting the System

    • Shutting Down the System

    • IP Aliasing Management System

    • Setting System Time

    • Accessing System Statistics

    • Request Online Server Support Service

  • System Services

    • Mail System Management

    • DNS Zone Templates Management

    • Stop, Start, Restart Server Administrator System Services

  • Control Panel Management

    • Logo Setup

    • Sessions Management

    • Control Panel Certificate Management

    • Interface Preferences

    • Additional Services Management

    • Notifications Setup

    • Domain Templates Management

  • Admin Information Management

    • Editing Administrator Information

    • Setting Administrator's Password

System Management

Rebooting the System

Rebooting simply means restarting the server. If users are logged on to the system, you should not reboot the server until you have informed all the users that the server must be shut down temporarily; however, sometimes an emergency necessitates immediate rebooting of a server to correct a problem that cannot be fixed any other way. To reboot your system, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the REBOOT button.

  3. PSA warns you that the system will be restarted and asks you to confirm your choice, for safety purposes. Click OK to reboot, or CANCEL to keep the server up.

NOTE

Rebooting the server via the PSA interface also reboots the operating system and anything else running on the server.

Shutting Down the System

When you need to completely shut down the server, you should do it through the Plesk Server Administrator (PSA) software rather than simply turning off the hardware. Shutting down with PSA closes all open files and gracefully ends all current services. To shut down your system, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the SHUTDOWN button.

  3. PSA warns you that the system will be shut down and asks you to confirm your choice, for safety purposes. Click OK to turn the server off or CANCEL to keep the server active.

NOTE

Shutting down the server via the PSA interface will also shut down the operating system and anything else running on the server. After having done this, there is no way to remotely bring the server back up; it must be done manually.

IP Aliasing Management System

The IP Aliasing page enables the administrator to control IP Aliasing on system network interfaces. This function is specifically for servers that have more than one IP address or are on more than one interface. From this page, the user can:

  • Choose the network interface for which he/she wishes to add or remove IP aliases.

  • Add an IP alias by entering the appropriate IP address and Subnet Mask.

  • Remove one or more IP Aliases from the server.

To add or remove IP Aliases on a PSA managed server, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click on IP ALIASING. The IP Aliasing management system page appears.

  3. To choose which network interface the IP Aliases will be added to or removed from, select the appropriate Interface from the drop down box.

  4. To add an IP Alias, enter the appropriate IP address and Subnet Mask in the text boxes provided. Click ADD to submit. Once submitted, the new address remains on the screen to facilitate the entry of multiple addresses.

  5. To remove one or more IP Aliases from the network interface, first select the necessary Interface, and then select the IP Alias from the list you want to delete. Click REMOVE.

  6. A warning message appears. Click OK to delete the IP address.

  7. Click UP LEVEL to return to the Server Administration page.

NOTE

You cannot add random IP addresses; they must be assigned.

Setting System Time

As the administrator you are able to manage your server date and time through the interface. From the System Date and Time page, you can review and edit the time and date manually. You can also synchronize your server time with the Network Time Protocol (NTP) server. To set the system time, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. To manually set the System Date and Time, in the area beneath System Date and Time click in any of the given fields (i.e. Year, Month, Day, Hour, Minute, Seconds) and adjust the information as needed.

  3. Click the SET button to submit your settings and update the system time.

  4. To synchronize your server time with that of a server running the Network Time Protocol, click in the checkbox next to Synchronize system time. Once there is a check in this box, this function will be enabled.

  5. Enter a valid IP address or a domain name and click the SET button to synchronize.

  6. In order for this function to work, you must enter a domain or an IP address, which points to a valid NTP server.

NOTE

Enabling the Synchronize system time function will override any time and date you manually enter in the System Date and Time fields. It is also important to be sure the domain name or IP address you enter for synchronization is a valid NTP server. If not, this function will not work and your server will continue to run with its current settings for time.

Accessing System Statistics

Plesk Server Administrator (PSA) compiles statistics on server usage. You can access this information at any time, for viewing or printing. The report is especially helpful if the server is slow or is experiencing performance problems; the report may help you diagnose and correct such problems.

The report lists several informative statistics:

CPU: This gives a description of the CPU of your server.

Version: This provides with the version of PSA you are running as well as the kernel number.

OS: Displays operating system version.

Key Number: This will report the key number for your PSA license.

System Up Time: How long the server has been available without interruptions such as those from rebooting or shutting down the operating system.

Load Averages for the last minute, 5 minutes, and 15 minutes: The average number of processes waiting in the scheduler queue for execution in the last time frame.

Hard Disk Usage:

  • Total - How many bytes of server disk space are on the server

  • Used - How many bytes of server disk space are being used

  • Available - How many bytes of server disk space are currently unused and available for use

  • Capacity - The percentage of disk space currently being used

Domains:

  • Active - How many domains are currently turned on

  • Problem - How many domains exceed Disk and Traffic limitations but are still available

  • Passive - How many domains are turned off (either by the administrator or the client) and not working

To access the System Statistics page, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click STATISTICS. The server report appears.

  3. Click REFRESH to update the server statistics with the latest data.

To print out a copy of the statistics, use your browser's File/Print command.

Submitting a request for the Online Server Support Service

You can request online server support service directly from the PSA control panel.

To do that, access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Management page appears. Click SUPPORT.

You will be taken to the Online Server Support form at the Plesk, Inc web-site. Fill out the form and enter all the information required. Click Submit Request. Your request will be encrypted and delivered to Plesk, Inc technical support staff.

NOTE

It is highly important to make sure that you provided all the information required, otherwise the form will not be accepted. The request will be assigned a unique request identification number that is generated for your request to be addressed and will be valid until your issue is solved.

System Services

Mail System Management

The Mail System Management page allows the administrator to set the parameters for various mail services on the server. The following settings can be adjusted from this page:

  • Maximum letter size - this field can be used to set the maximum allowable size of any email received on the server. If this field is left empty, or zero is entered, then the maximum allowable size is "unlimited".

  • Relaying - these fields are used to set the mail system relay mode. Relaying affects only the sending of mail; it does not in any way change how mail is received on the server. Mail relaying can work in one of three modes: open relay, closed relay and relay with authorization.

    • Open relay - selecting this allows any host computer to utilize the mail services of any domain on the server, to send and/or receive mail. In this mode, no password is required.

    • Closed relay - selecting this only allows mail to be sent and received locally (to and from domains residing on the server). The only exception would be hosts specified as allowable relay hosts in the White list.

    • Authorization is required - selecting this allows any host computer to utilize the mail services of a domain on the server provided that a valid username and password are used to authenticate the mail user.

      • POP3 - requires a POP3 login before sending mail. The lock time field sets the allowed time given for sending mail after login. During the lock time, any email sent from the initial IP address will be accepted without requiring a password to be re-entered.

      • SMTP - smtp authentication (the PSA mail system supports LOGIN, CRAM-MD5 and PLAIN methods of smtp authorization) requires a password every time you send an email.

  • White List - the White list is a list of IP-addresses with masks from which mail is always accepted.

  • Blockers - Mail blockers are used to identify mail domains from which you do not allow mail to be received.

  • The Enable MAPS spam protection checkbox, when ckecked enables mail abuse prevention system to help you defend your customers from abuse by spammers.

In order to manage mail system settings, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. To set the maximum letter size allowed on the server, click in the Maximum letter size text box and enter your desired size in KBytes. Click SET to submit.

  3. To set the mail system relay mode, click on the radio button next to your desired mode to select it:

    • For open relaying, click on the Open button.

    • For closed relaying, click on the Closed button.

    • For relaying which requires authorization, click on the Requires authorization button. You must then select an authorization type, which can be POP3, SMTP or both.

      • POP3 - Click a check in the check box next to POP3 to enable this mode of authorization. You must then set the lock time; the default setting is 20 minutes.

      • SMTP - Click a check in the check box next to SMTP to enable this authorization mode.

    • Click on SET to submit.

  4. To add an IP address/mask to the White List, type in the appropriate IP address and mask in the fields provided. Click the ADD button to submit. The address selected will appear in the IP list.

  5. To remove an IP address/mask from the White List, select the IP address you wish to delete from the IP list. Click the Remove button.

  6. To add a mail blocker, click in the text box next to Enter domain name and enter the domain name from which you want the mail to be rejected. Click the ADD button to submit. The domain you selected will appear in the blocked domain list.

  7. To remove a mail blocker, select the domain you wish to remove from the list of blocked domains. Click the Remove button.

  8. To enable the Mail Abuse Prevention System (MAPS) check the Enable MAPS spam protection checkbox, enter the hostname or IP-address of the external MAPS server in the MAPS server field and click SET.

DNS Zone Template Management

This page allows you to create the default DNS Zone Template. Such template makes it easier to set up the DNS records for a freshly created new domain. This feature provides you with a number of DNS records that are more or less standard for a DNS zone.

In order to add a new DNS template record follow these steps:

  1. Access the server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click on the DNS button. The DNS Zone Template page appears.

  3. Select the type of the record you wish to add from the Record type drop-down box and click the ADD button. The DNS Zone Template Records Edit page appears.

  4. Fill in the required information into the provided input fields (the type of the information required varies depending on the type of the DNS record selected).

  5. Click the UPDATE button to submit the entered data and add the new record to the template. If you decide not to add the record, simply click the UP LEVEL button. Both will take you back to the DNS Zone Template page, one adding the record and the other one skipping any modifications.

NOTE

It is possible not to enter the precise name of the new domain or the IP address. Instead, the following substitutions are made available: <domain>, which is then replaced with the domain name, and <ip>, which is replaced by the primary IP address.

In order to remove a DNS record from a template: click on the REMOVE button related to the record you wish to remove. The confirmation dialog box will appear. Click OK to confirm. The record will be immediately removed.

The DNS Zone Status icon located at the top of the page indicates whether a DNS is turned on or off.

  • If you wish to turn the DNS on or off for the template, select ON/OFF.

  • Turning the DNS zone off will refresh the page, so that only a list of nameservers remains.

  • If you are running remote DNS, and therefore want to turn DNS off, you should create the appropriate NS entries to be stored in the template. To add a nameserver: click ADD, enter the nameserver in the appropriate input field, click UPDATE. You see that the name server(s) for the template remains listed as a link.

Restarting Services

You can restart some of PSA services directly from the control panel.

The services available for restart are:

  • Qmail,

  • Apache web server,

  • Named,

  • Courier-IMAP

  • Stunnel

In order to stop, start or restart some system service follow these steps:

  1. Access the server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click on the RESTART SERVICES button. The PSA services restart page appears.

  3. To start the service: click on the Start the service icon.

    To stop the service: click on the Stop the service icon.

    To restart the service: click on the Restart the service icon.

The current service state will be marked by an icon: "ON" for the service running, and "X" for the service stopped.

Control Panel Management

Logo Setup

When using PSA, you may replace the Plesk logo in the top banner area with your own logo. This provides you with a customized look for your interface. Also, it enables you to hyperlink the logo to your organization's website. To change the logo on the interface, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the LOGO SETUP button. The Logo Setup page appears:

  3. Click in the Choose new Logo file text box and enter the name of the logo file you wish to use. Or, click the Browse... button and choose a file.

    NOTE

    You should use a GIF or a JPEG file format for your logo, preferably no larger than 100 kilobytes to minimize download time. Plesk resizes the logo to fit in the banner area. If you don't want your logo to be resized, you should edit the logo to the exact banner size, which is 558 X 81 pixels.

  4. Click SET to place your logo in the banner area. This may take some time to upload.

  5. You have the option to create a hyperlink that activates when a user clicks on your logo. The link may take the user to a corporate URL or other website. Click in the Enter new Logo link URL box. Enter in the URL.

  6. Click SET to activate the hyperlink.

  7. If you change your mind about a logo, and wish to revert back to the PSA logo, click the DEFAULT LOGO.

When you have finished defining a local logo and hyperlink, click UP LEVEL to return to the Server Administration page.

Sessions Management

The Sessions Management page allows for the setup of various PSA security parameters. The following parameters can be set from this page:

  • Session idle time - allowable idle time for any session in PSA. PSA does not allow two sessions using the same login name to run simultaneously; however, should a user session remain idle for a length of time exceeding that specified as the Session idle time, then PSA allows that user name to login from a different location, thus ending the idle session.

  • Invalid login interval - interval between two invalid login attempts within which the invalid login attempts counter is increased. If the time between two invalid login attempts exceeds this value, then the invalid login counter is reset back to 0.

  • Invalid login attempts - maximum quantity of invalid login attempts allowed. Once a user has exceeded this value, they are locked out for the time specified in the Invalid login lock time text box.

  • Invalid login lock time - lockout time for a user once the invalid login attempts counter has exceeded its maximum limit. During this time, correct attempts will not be accepted. Upon completion of the lockout time, the invalid login attempts counter is reset to "0" and the user is again given the ability to login to PSA.

In order to change the settings for the sessions parameters, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click on the SESSIONS button. The Sessions Management page appears.

  3. To set the Session idle time, click in the field provided to the right, and enter the selected time.

  4. To set the Invalid login interval, click in the field provided to the right, and enter the selected interval.

  5. To set the number of Invalid login attempts, click in the field to the right, and enter the selected number of attempts.

  6. To set the Invalid login lock time, click in the field to the right, and enter the selected lock time.

  7. Click the UPDATE button to submit your settings.

Click the Defaults button to return the settings to their default values.

Control Panel Certificate Management

PSA enables you to upload a Secure Socket Layer (SSL) Certificate, generate a Certificate Signing Request (CSR), and/or generate a Self-signed Certificate. Each certificate represents a set of rules used when exchanging encrypted information between two computers. Certificates establish secure communications; this is especially important when handling e-commerce transactions and other private transmittals. Only authorized users can access and read an encrypted data stream. If your client intends to implement SSL support for a virtual host domain, you can grant permission for SSL capabilities to the domain. Or, your client can implement the SSL certificate by self-administering his/her domain. You can also download a certificate from a PSA server acting as master to another PSA server acting as slave server.

Notes on Certificates:

  • You can acquire SSL certificates from various sources. We recommend generating a certificate with the SSLeay utility and submitting it to a certificate authority. This can be done using the CSR option within PSA. You can also purchase the certificate through our web-site My.Plesk.com (MPC).

  • A default SSL certificate is uploaded automatically for the control panel. However, this certificate will not be recognized by a browser as one that is signed by a certificate signing authority. The default SSL certificate can be replaced by either a self-signed certificate or one signed by a recognized certificate-signing authority.

  • If using a SSL certificate issued by a certificate authority other than Thawte or Verisign, a rootchain certificate is required to appropriately identify and authenticate the certificate authority that has issued your SSL certificate.

  • Once you have a certificate, you can upload it through the Plesk Server Administrator using the instructions which follow in this section.

To generate a self-signed certificate or a certificate-signing request, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the CERTIFICATE button. The Control Panel Certificate Setup page appears.

  3. The Certificate Information: section lists information needed for a certificate Request, or a Self-Signed certificate.

  4. The Bits selection allows you to choose the level of encryption of your SSL certificate. Select the appropriate number from the drop-down list next to Bits:.

  5. Select your country from the drop-down list. To enter the information into the provided text input fields (State or Province, Location (City), Organization Name (Company) and Organization department (division name) click in the text boxes and enter the appropriate names.

  6. To enter the Domain Name for the certificate, click in the text box next to Domain Name: and enter the appropriate domain.

    This will be the only domain name that can be used to access the Control Panel without receiving a certificate warning in the browser. The expected format is http://www.domainname.com or http://domainname.com.

  7. Click on either the SELF-SIGNED or REQUEST button.

  8. Clicking SELF-SIGNED results in your certificate being automatically generated and posted to your certificate directory. Selecting REQUEST results in the sending of a certificate-signing request to the email provided.

When you are satisfied that the SSL certificate has been generated or the SSL certificate request has been correctly implemented, click UP LEVEL to return to the Domain Administration page.

To purchase a certificate through the My.Plesk.com proceed to:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the CERTIFICATE button. The Control Panel certificate setup page appears.

  3. The Certificate Information: section lists information needed for a certificate Request, or a Self-Signed certificate.

  4. The Bits selection allows you to choose the level of encryption of your SSL certificate. Select the appropriate number from the drop down box next to Bits:.

  5. Choose your country from the drop-down list. To enter the information into the provided text input fields (State or Province, Location (City), Organization Name (Company) and Organization Department/Division) click in the text boxes and enter the appropriate names.

  6. To enter the Domain Name for the certificate, click in the text box next to Domain Name: and enter the appropriate domain.

    This will be the only domain name that can be used to access the Control Panel without receiving a certificate warning in the browser. The expected format is http://www.domainname.com or http://domainname.com.

  7. Click on the BUY CERTS button to gain access to the certificate management interface on My.Plesk.com. The MPC Gate page appears.

  8. This page allows you to create account (the Create Account button) and access (the Log In button) to MPC from where you are able to purchase and manage the certificates.

  9. In case you already have an existing account on MPC but forgot the password for it, there is a button provided especially for such occasions: Forgot Password?. Click it and enter your MPC account login name when requested into the provided text input field. Your password will be sent via e-mail to the address specified in your Server Administrator profile.

NOTE

If you do not wish to purchase certificates at this time but do wish to view the certificates currently owned by you, you may proceed directly to the MPC Gate page by clicking the VIEW CERTS button. At that you will not be prompted to fill in the details at the Control Panel Certificate Setup page.

To upload a file containing the certificate authorized by the Certificate Signing Authority:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the CERTIFICATE button. The Control Panel Certificate Setup page appears.

  3. If you wish to upload a Certificate File authorized by the Certificate Signing Authority, click the Browse... button under the Upload previously purchased Certificate File (without private key) section to select the file (the file must be in .txt format)

  4. Then, click SEND FILE to copy the certificate to the server.

To upload a new certificate:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the CERTIFICATE button. The Control Panel Certificate Setup page appears.

  3. If you wish to upload a certificate file from a local machine, under the Uploading Certificate File section, click the Browse... button to select the file (the file must be in .txt format).

  4. Then, click SEND FILE to copy the certificate to the server. Or, if you want to type in the text of the certificate without uploading a specific file, click in the text box and type in or paste the certificate text.

  5. Click SEND TEXT to implement the text on the server.

    NOTE

    Ensure that the private key text block is included along with the SSL certificate text block when using the SEND FILE or SEND TEXT options.

  6. When you upload the certificate to the server, PSA checks for errors. If an error is detected, PSA restores the old version of the SSL certificate, and prompts you to update the certificate. At this point, you can try again to enter text or to upload the certificate file.

  7. When you are satisfied that the SSL certificate is correctly installed, click UP LEVEL to return to the Domain Administration page.

If you are using a certificate that has been signed by an authority other than Thawte or Verisign then it is likely that this will require the use of a rootchain, or CA, certificate. To install a rootchain certificate for the domain:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the CERTIFICATE button. The Control Panel Certificate Setup page appears.

  3. The icon next to Use rootchain certificate for this domain appears on this page.

  4. If the icon is [ON] then the rootchain certificate will be enabled for this domain. If the icon is [X] this function will be disabled.

  5. To change the status of the rootchain certificate, click the ON/OFF button.

  6. To upload your rootchain certificate, first make sure that it has been saved on your local machine or network. Use the Browse... button to search for and select the appropriate rootchain certificate file.

  7. Then click the SEND FILE button. This will upload your rootchain certificate to the server to assure proper authentication of the certificate authority.

The Download certificate section is intended for downloading certificate already installed for the control panel. Click DOWNLOAD to save the certificate on your local machine.

Interface Preferences

PSA allows you to set up system-wide preferences, such as the number of lines displayed on the pages containing the lists (i.e.: Domains List, Clients List, etc.), set default interface language (English is set by default), customize Control Panel appearance by applying a skin, enable/disable checking mailboxes passwords uniqueness, and adjust server-wide statistics calculation.

To change the number of lines displayed per page:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the PREFERENCES button. The Server Preferences page appears.

  3. Click in the Display lines per page input box and enter the number of lines you want to see displayed on the pages.

  4. Click the UPDATE button or the UP LEVEL button to return to the Server Administration page. One will commit the changes; the other one will leave the settings unchanged.

To change the control panel interface language:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the PREFERENCES button. The Server Preferences page appears.

  3. Select the desired language from the drop-down list (currently only English is available).

  4. Click the UPDATE button or the UP LEVEL button to return to the Server Administration page. One will commit the changes; the other one will leave the settings unchanged.

To apply a skin to your PSA control panel:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the PREFERENCES button. The Server Preferences page appears.

  3. Select the desired skin from the drop-down list.

  4. Click the UPDATE button or the UP LEVEL button to return to the Server Administration page. One will commit the changes; the other one will leave the settings unchanged.

Currently only two PSA skins are available. However, you may wish to create your own skins to be used with PSA control panel.

To add your skin, follow these steps:

  1. Skins are located in the psa/admin/htdocs/skins/ directory. After you have created a directory with desired content, place it into psa/admin/htdocs/skins/ directory. The following subdirectories with appropriate content should be prepared: /buttons, /css, /elements, /icons.

  2. Add to the Skins table in the database a record describing title and location of the created skin.

    Example

    # mysql -u admin -p`cat /etc/psa/.psa.shadow` -e 'insert into Skins (name, place) values("Alternative", "/skins/Alternative")' psa

    Where "Alternative" - is the name the skin will be assigned and referred to from the interface, and the "/skins/Alternative" - path to a skin relative to /htdocs directory of the admin apache.

    You will possibly have to specify the full path to mysql if the path is not set in the PATH variable.

  3. Select your Skin from the drop-down list on the page SERVER->PREFERENCES. Click UPDATE.

  4. NOTE

    If the directory with your skin will be missing some subdirectory, a corresponding subdirectory will be taken from the standard skin instead.

To enable/disable checking for mailboxes passwords uniqueness in the database:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the PREFERENCES button. The Server Preferences page appears.

  3. Put a check mark in the Check the passwords for mailboxes in the vocabulary box.

  4. Click UPDATE.

To adjust server-wide statistics calculation:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the PREFERENCES button. The Server Preferences page appears.

  3. In the Retain traffic statistics for at least...Months box, enter the duration the statistics will be retained for.

  4. In the Include in the disk space usage calculation section, specify whether the log files, databases, mailboxes will be taken into account during disk space usage calculation.

  5. Click UPDATE to submit changes, or UP LEVEL to discard any unsaved changes and return to the Server Administration page.

Customizable Buttons

Administrator can insert into PSA 5.0 control panel any additional buttons that will be linked to some URL. Thus, when a user clicks on such button, the URL link specified will open in a new browser window. The buttons will be located on the Domain Administration page and displayed for all clients' domains. The buttons will be placed below the domain management buttons, by 4 buttons in one row.

NOTE

The number of customizable buttons is unlimited and does not depend on the key.

How to customize a new button:

  1. Create a directory inside /usr/local/psa/admin/htdocs/

  2. Make this directory readable (for example: chmod 755 /usr/local/psa/admin/htdocs/buttons)

  3. Place the image of a button into the /usr/local/psa/admin/htdocs/buttons directory. Recommended button size - 115*22 pixels

  4. Insert a record in psa database in the table custom_buttons with image_path, url and context help tip. A path should be specified relatively to /usr/local/psa/admin/htdocs.

  5. Example

    # mysql -u admin -p`cat /etc/psa/.psa.shadow` -e "insert into custom_buttons (image_path, url, conhelp) values ('/button/button1.gif', 'http://www.plesk.com', 'Plesk Site.');" psa

    You will possibly have to specify the full path to mysql if the path is not set in the PATH variable.

Additional Services Management

This page allows you to manage a few additional services available through My.Plesk.com (MPC). The current services are Domain Registration, Certificate Purchasing and Extra Services (general MPC access).

To activate (or deactivate) a certain service, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the ADD SERVICES button. The Additional Services Setup page appears.

  3. Check (or uncheck) the checkbox corresponding to the service you wish to activate (or deactivate).

  4. Click the UPDATE button or the UP LEVEL button to return to the Server Administration page. One will commit the changes; the other one will leave the settings unchanged.

If you wish to register your server on MPC or another service provider, click REGISTER. You will be taken to the MPC Gate page.

Notification Subscription

Notification system is intended to keep administrator informed of the ongoing events.

The following system events can be handled by the notification system:

  • new domain creation,

  • new client creation,

  • account-specific quotas exceeded.

To adjust the notification system, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the NOTIFICATION button. The Notification Subscription page appears. Here you can enable notification to be sent on a new client creation, new domain creation, and if a quota is exceeded.

  3. By placing the checkmarks in appropriate checkboxes, select the person, the notification will be sent to on each selected event - it can be a client, the administrator, and a domain user.

  4. Click UPDATE to submit the settings, and UP LEVEL to return to the Server Administration page.

To edit the default notification message text, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the NOTIFICATION button. The Notification Subscription page appears.

  3. Click the TEXT button related to the desired system event, be it New client creation, New domain creation, or Account limit notices. Notification editing page appears.

  4. Edit the default notification message text. Click UPDATE to submit changes, DEFAULT to restore default message text, or UP LEVEL to discard unsaved changes and return to the Notification subscription page.

The tags used in the notification messages are as follows:

New client creation

  • <client> - client's control panel login name

  • <password> - client's control panel password

  • <ip> - ip-address for control panel access

New domain creation

  • <domain> - client's domain name

  • <client> - client's control panel login name

  • <ip> - ip-address pointing to the domain name

Account limit notices

  • <client_login> - client's control panel login name

  • <client_contact_name> - client contact name

  • <disk_usage> - disk space currently used

  • <disk_space_limit> - disk space limit set for the account

  • <traffic> - amount of traffic currently used

  • <traffic_limit> - traffic limit set for the account

Domain Templates Management

What is domain template?

Domain template in PSA 5.0 is a predefined set of domain-specific restrictions, options, and hosting parameters that should be set for a domain. The primary purpose of domain templates is to simplify creation of domains with automatic settings assignment to them.

The following parameters can be set for a domain and included in the template:

  • Disk space limit

  • Maximum traffic allowed

  • Maximum web users

  • Maximum databases

  • Maximum mailboxes

  • Mailbox quota

  • Maximum mail redirects

  • Maximum mail groups

  • Maximum mail autoresponders

  • Period of time the statistics is kept for a domain

  • Mail to non-existent user parameters

  • Allowing scripting for webusers

  • Webmail

  • Virtual host type (no, name-based, ip-based)

  • Support for FrontPage,

  • FrontPage over SSL,

  • FrontPage Authorization

  • SSI

  • PHP

  • CGI

  • mod_perl

  • Apache ASP support

  • SSL

  • Web statistics

  • Apache Error Documents

Creating a domain template

To add a new domain template, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the DOMAIN TEMPLATES button. The Domain Templates Management page appears.

  3. Click the ADD button, the Template creation and editing page appears.

  4. Enter the name for the domain template in the Template name field.

    The template allows to set the following limitations:

    • maximum disk space usage,

    • maximum traffic allowed (MB per month),

    • maximum number of web-users,

    • number of databases,

    • number of mailboxes,

    • mailbox quota (KB),

    • maximum mail redirects,

    • maximum mail groups,

    • maximum mail autoresponders.

    To set the necessary parameter, check the appropriate checkbox, and type in a value for the parameter.

    Specify the time for the statistics to be retained in the Delete traffic statistics older than ... Months field. Set the Mail to non-existent user option to Bounce with phrase or Catch to address. Check the Allow scripting for web-users checkbox and enable Webmail if desired.

    Set the Virtual host type to:

    • None,

    • Name-based

    • IP-based

    To allow the use of FrontPage Server Extensions, check the checkbox for FrontPage support and FrontPage over SSL support. Authorization will be disabled by default. For security reasons, authorization should only be enabled when FrontPage extensions are in use.

    The following column of checkboxes controls the remaining selectable features for the domain template:

    • SSI support - Server Side Included scripting enabled.

    • PHP support - supports html documents that contain PHP scripts.

    • CGI support - an individual cgi-bin directory is created and CGI scripting is enabled.

    • mod_perl support - mod_perl scripting enabled.

    • Apache ASP support - Apache::ASP perl module enabled.

    • SSL support - maintenance of https protocol.

    • Web statistics - keeping the usage statistics for the domain.

    • Apache Error Documents - With this feature enabled, a client will be able to use custom files for displaying them in the case of Apache errors.

  5. Click UPDATE to submit settings, UP LEVEL to discard unsaved settings and return to the Domain templates management page.

The template will be added to the list of domain templates and become available as option when creating a domain.

Domain Templates Management page

This page contains a list of all domain templates, already created in the system. Once you create a domain template you are able to use it while creating a domain for any client.

The list of domain templates can be sorted by name in ascending or descending order. To sort the list, click on the Name header of the list. An arrow will show the order of sorting.

You can search through the list for a certain pattern. It may help you in case you have a great number of templates in the list and you need to work with a particular one. To search through the list, type the pattern string into the text input field and click SEARCH. If there were any items found matching the entered pattern string, they will all be displayed in the form of a reduced list. The button SHOW ALL will revert to displaying the whole list.

To add a domain template, click the ADD button. You will be taken to the domain template creation page. This is explained in detail in the previous section.

Editing a domain template

To edit a domain template:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the DOMAIN TEMPLATES button. The Domain Templates Management page appears.

  3. Select the template you wish to edit by clicking on its name in the list. The Domain Template Editing page will open, allowing you to change the desired options. Settings that can be configured on that page are absolutely the same as on the Domain Template Creation page.

  4. Click UPDATE after you are done with configuring the template.

NOTE

When altering a template, nothing will change for the domains that were previously created by means of this template.

Removing a domain template

To remove a domain template:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the DOMAIN TEMPLATES button. The Domain Templates Management page appears.

  3. Select the template you wish to remove by putting a checkmark in the checkbox related.

  4. Click REMOVE SELECTED. The confirmation page appears.

  5. On the confirmation page, check the checkbox to confirm, and click SUBMIT.

Admin Information Management

Editing Admin Information

This page allows you to enter contact information for the administrator. The email address to which the administrator receives messages from users was set when you installed the PSA software. You can change this email address at any time. To enter or edit Admin information, follow these steps:

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the EDIT button. The Edit Administrator Information page appears.

  3. Click in any of the desired fields and enter the admin information.

  4. All the required fields are marked with asterisks.

  5. You can return to this page and edit this information at any time.

  6. Click the UPDATE button to submit your information.

NOTE

When you change the administrative email address, be sure to inform your users of the new address.

Setting the Admin Password

You can change the administrative password at any time. Regularly changing the administrative password is a good idea for security purposes.

  1. Access server management functions by clicking on the SERVER button at the top of the PSA interface. The Server Administration page appears.

  2. Click the CHANGE PASSWORD button. The Change Server Administrator Password page appears.

  3. Click in the Old password text box and enter your current password.

  4. Click in the New password text box and enter the password that you wish to change to.

  5. Click in the Confirm text box and re-enter the new password, exactly as you entered it in the New password text box.

  6. Click the UPDATE button.

NOTE

The default password is "setup" and is established during the installation process. Because of this, you cannot "create" a password, rather you can only change it.

to top