How to install software’s using Plesk Autoinstaller#

Plesk Auto-Installer is a utility used by Plesk control panel for retrieving and installing software updates and upgrades . This article describes how to install software’s from back-end .

Lets see how to install webmail using autoinstaller . Control Panel shows webmail is not installed and is grayed out .

1. Ssh to your server

2. Search for the binary autoinstaller. Most probably it should be under /usr/local/psa/bin/

# cd /usr/local/psa/bin/

3. Check for various options available.

[root@admin /usr/local/psa/admin/bin]# ./autoinstaller –help

It should list something like

Usage: parallels_installer [OPTIONS]

Product and operating system updates source:

–source <URL or absolute path to .inf3 file>

URL (http://your-mirror.com/) or absolute path

to an .inf3 file on your hard disk.

Examples:

‘http://autoinstall-ctp.plesk.com/’

‘/root/parallels/PSA_8.1.0/plesk-8.1.0-deb3.1-i386.inf3′

–disable-plesk-sys-updates

Do not use operating system updates shipped

with Plesk and other product(s)

–add-source <type,priority,url[,username,environment variable with password]>

Specify the additional source of packages.

You can specify either of the following source

types: repodata, directory.

Examples:

‘repomd,500,http://download.fedora.redhat.com/fedora/updates/2/i386′

‘directory,500,/mnt/updates’

–show-additional-source-types

Show possible source types for –add-source

–show-additional-sources

Show the additional sources you configured

Proxy server options:

–proxy-host <host> When using a proxy server or a firewall, use this

option to specify the proxy server’s domain name

or IP address.

–proxy-port <port> Default port for connecting to proxy server is 3128.

If your proxy server uses a different port number,

you should specify it using this option.

–proxy-user <user> Set username for authorization at the proxy server

–proxy-password <password>

Set password for authorization at the proxy server

Select a product version:

–select-product-id <product id>

Select the product name

(‘plesk’ (by default) or ’sitebuilder’)

–select-release-id <release id>

Use this option to specify the product version that you

want to install or whose properties you want to view.

–select-release-latest

Select the latest product version available for

your operating system

–select-release-current

Select the same product version as the one installed

on your machine

Options for selecting components:

–install-component <component id>

Install the product component with specified

identifier

–install-everything

Install all components of the selected product version

–upgrade-installed-components

Upgrade all installed components of the selected

product version

Installer options:

–allow-kernel-install

Allow kernel upgrade. By default, the auto-installer

does not make any kernel upgrades.

Note that auto-installer installs new kernels to the system, leaving the older

kernel aside so that you can revert to it at any time.

–ignore-key-errors

Allow upgrading product even if upgrade of the license

key fails.

–use-existing-ports

FreeBSD specific option

(You may want to use this to prepare the machine for installing the product.)

–no-space-check Install packages even if you are low on disk space.

Use the following options for selecting and installing packages,

and setting up mirrors:

–show-releases Specify this option to retrieve a list of available

product versions for the operating system where the

auto-installer is executed. You will be given a list

of release identifiers and release descriptions.

The release identifiers are what you will need to

deal with.

–show-all-releases This option shows all product versions available from

the official product updates server.

–show-os-list Use this option to find out on which operating systems

the product version you selected can run.

–show-components Use this option to obtain the information on the

components available for the selected product version.

Components descriptions and names will be displayed.

The component names are what you need to specify when

selecting additional components to install.

–show-packages Show additional packages required for installation of

selected components.

–mirror-os <id> This option activates the mirroring feature in

auto-installer. If you want to mirror product versions

for different operating systems, you should specify

this option per each operating system.

–install-package <name>

Install package with specified name

Options for interaction with other software:

–enable-xml-output Specify this option to have all output of

auto-installer in XML format. Note that this option

disallows auto-installer to report errors by exit code.

Exit code is always zero and all errors are reported

inside XML output.

–query-status Use this option to find out if auto-installer is

active. This will return either an exit code

(0 – auto-installer is idle, 1 – auto-installer is

running and busy), or XML-formatted output.

–check-updates Specify this option to check the updates server for

updates applicable to your product version.

A list of releases that you can update or upgrade to

will be shown.

–no-daemon Perform installation process in the foreground

–web-interface Opens the Web-based installation wizard in

a Web browser.

–ssl-cert <file.pem>

Specifies the path to the SSL certificate file that

should be used for securing connections.

–without-ssl Specifies that connections to the Web-based

installation wizard will not be secured.

FreeBSD specific options:

–cvsup-host <hostname>

Hostname of CVS server for retrieving updates for

FreeBSD ports

Override operating system detection results:

–override-os-name <arg>

Override detected operating system name

–override-os-vendor <arg>

Override detected operating system vendor

–override-os-version <arg>

Override detected operating system version

–override-os-arch <arg>

Override detected operating system architecture

–override-environment <arg>

Override detected environment

(possible values are ‘dedicated’, ‘vz’, ‘vserver’)

Interactive user interface options:

–no-clear Do not clear screen when moving between wizard’s pages

General options:

–target <dir> The directory where downloaded files must be stored.

–notify-email <email>

Use this option to have the auto-installer send you

status reports by e-mail. A successful completion

report includes a list of installed or upgraded

packages with a detailed log.

–truncate-log Clear log file on auto-installer start

–separate-log Use new log file for each start of auto-installer

–debug Turn on detailed output into log file

–version Show auto-installer’s version

–usage,

–help Show this help page

That clearly shows what does each option do .

You can see all the product versions using :-

[root@admin /usr/local/psa/admin/bin]# ./autoinstaller –show-all-releases

Downloading the file products.inf3: 100% done.

Downloading the file plesk.inf3: 10%..21%..30%..41%..50%..61%..70%..81%..90%..100% done.

Downloading the file ppsmbe.inf3: 76%..100% done.

Downloading the file sitebuilder.inf3: 15%..35%..55%..96%..100% done.

Downloading the file sso.inf3: 10%..24%..37%..51%..64%..78%..91%..100% done.

Downloading the file setemplates.inf3: 38%..87%..100% done.

— prod_id release_id (description) —

plesk PLESK_9_2_3 (Parallels Plesk Panel 9.2.3)

plesk PLESK_9_2_2 (Parallels Plesk Panel 9.2.2)

plesk PLESK_9_2_1 (Parallels Plesk Panel 9.2.1)

plesk PLESK_9_0_1 (Parallels Plesk Panel 9.0.1)

plesk PLESK_9_0_0 (Parallels Plesk Panel 9.0.0)

plesk PLESK_8_6_0 (Plesk 8.6.0)

plesk PLESK_7_5_4 (Plesk 7.5.4)

plesk PLESK_8_0_0 (Plesk 8.0.0)

plesk PLESK_8_0_1 (Plesk 8.0.1)

plesk PLESK_8_1_0 (Plesk 8.1.0)

plesk PLESK_8_1_1 (Plesk 8.1.1)

plesk PLESK_8_2_0 (Plesk 8.2.0)

plesk PLESK_8_2_1 (Plesk 8.2.1)

plesk PLESK_8_3_0 (Plesk 8.3.0)

plesk PLESK_8_4_0 (Plesk 8.4.0)

ppsmbe PPSMBE_10_0_0 (Parallels Small Business Panel 10.0.0)

sitebuilder SB_4_5_0 (Sitebuilder 4.5.0)

sso SSO_2_0 (SSO 2.0)

sso SSO_2_1 (SSO 2.1)

To retrieve a list of components for the “selected product version”, you can use

[root@admin /usr/local/psa/admin/bin]# ./autoinstaller –select-release-id PLESK_8_6_0 –show-components

Here I have selected product version as PLESK_8_6_0 Or else with the current release if I need to see what all components can be installed and what are already installed .

4. [root@admin /usr/local/psa/admin/bin]# ./autoinstaller –select-release-current –show-components

Downloading the file products.inf3: 100% done.

Downloading the file plesk.inf3: 10%..21%..30%..41%..50%..61%..70%..81%..90%..100% done.

Downloading the file ppsmbe.inf3: 33%..76%..100% done.

Downloading the file sitebuilder.inf3: 15%..35%..55%..96%..100% done.

Downloading the file sso.inf3: 10%..24%..37%..64%..78%..100% done.

Downloading the file setemplates.inf3: 38%..87%..100% done.

Checking for installed packages…

Downloading the file PSA_9.2.3/plesk-9.2.3-fr6.1-i386.inf3: 12%..21%..30%..44%..53%..71%..80%..93%..100% done.

Preparing ports for product installation:

Removing unnecessary packages from the system.

done

Preparing ports for product installation:

Deploying product ports…

Downloading the file PSA_9.2.3/dist-pkg-FreeBSD-6.1-i386/ports/ports-common.tar.gz: 10%..20%..30%..40%..50%..60%..70%..80%..90%..100% done.

Downloading the file PSA_9.2.3/dist-pkg-FreeBSD-6.1-i386/ports/psa-ports-9.2.3.tar.gz: 10%..20%..30%..40%..50%..60%..70%..80%..90%..100% done.

done

Re-installing port ’swsoft/ports-common’…done

Detecting installed product components.

Detecting installed product components.

base [up2date] – Base packages of Plesk

psa-autoinstaller [up2date] – Plesk Updater

postgresql [up2date] – PostgreSQL server support

vault [install] – Application vault packages

ppwse [install] – Plesk Professional Web Site Editor

api [up2date] – Plesk API [former Plesk Agent]

pmm-ded [install] – Plesk migration manager

sb-publish [install] – SiteBuilder publishing support for Plesk

sbm [install] – SiteBuilder module migration suite

miva [install] – Miva Empresa support

billing [install] – Plesk billing

mod-bw [install] – Bandwidth Limiter For Apache support (mod_bw)

asp [install] – Apache ASP support

java [install] – Tomcat Java Servlets support

mod_python [install] – Apache mod_python module

ruby [install] – Ruby on Rails support

php4 [install] – PHP4 support

php5 [up2date] – PHP5 support

qmail [up2date] – Qmail mailserver

postfix [install] – Postfix mailserver

psa-firewall [install] – Plesk Firewall module

psa-vpn [install] – Plesk VPN module

psa-fileserver [install] – Plesk Fileserver module and SMB file server package

sshterm [install] – SSHTerm – SSH Terminal java applet

watchdog [install] – Watchdog (System monitoring module)

mailman [up2date] – Mailman mailing list manager support

kav [install] – Kaspersky antivirus module

drweb [up2date] – Dr. Web antivirus

spamassassin [install] – SpamAssassin support

backup-ded [install] – Plesk Backup Manager

de-DE-locale [install] – German language pack

ja-JP-locale [install] – Japanese language pack

es-ES-locale [install] – Spanish language pack

ru-RU-locale [install] – Russian language pack

fr-FR-locale [install] – French language pack

it-IT-locale [install] – Italian language pack

zh-CN-locale [install] – Chinese language pack for China

zh-TW-locale [install] – Chinese language pack for Taiwan

nl-NL-locale [install] – Dutch language pack for Netherlands

horde [install] – Horde webmail support

atmail [install] – AtMail webmail support

If you want to install backup for the selected product version PLESK_8_6_0 , use

./autoinstaller –select-release-id PLESK_8_6_0 –install-component backup-ded

(Give the correct component name shown under show-components.It may vary)

Or for the current release if you need webmail

5.

[root@admin /usr/local/psa/admin/bin]# ./autoinstaller –select-release-current –install-component horde

After this completes you should be able to access webmail .

Before you start, always take the backup of plesk psa database, just in case if anything went wrong.

cd /var/lib/mysql

mysqldump -uadmin -p`cat /etc/psa/.psa.shadow` psa > psabackup.sql