4PSA Integrator 3.5.0 Command Line Installation

Manual Version 77015.15 at 2008/11/14 16:36:14

For suggestions regarding this manual contact: docs@4psa.com

Copyright © 2011 Rack-Soft. 4PSA is a registered trademark of Rack-Soft, Inc.

All rights reserved.

Distribution of this work or derivative of this work is prohibited unless prior written permission is obtained from the copyright holder.

Plesk is a Registered Trademark of Parallels, Inc.

Linux is a Registered Trademark of Linus Torvalds.

RedHat is a Registered Trademark of Red Hat Software, Inc.

FreeBSD is a Registered Trademark of FreeBSD, Inc.

All other trademarks and copyrights are property of their respective owners.

Table of Contents

Before Installation
Required Packages
Installation Steps
RPM Capable Linux Distributions
Debian and Ubuntu Distributions
FreeBSD
After Installation
Upgrade
Compatibility
Contact and Support
15 minutes
It will take about 15 minutes to an intermediate user to read this document and follow the steps highlighted here.

Before Installation

4PSA Integrator software has two important components, 4PSA Integrator core, which contains the application files and 4PSA Integrator SaaS archives, every archive containing a software managed by 4PSA Integrator.

In order to start the installation, you must download the 4PSA Integrator core installer. The SaaS archive is automatically maintained by 4PSA Integrator. Every time you launch the installer, the SaaS software installed on your server is checked against the latest versions present on the 4PSA repository server. When new versions are detected, they are automatically downloaded and installed.

The software applications included in 4PSA Integrator work on most hosting servers. However, keep in mind that you need:

  1. PHP 5.2.6 or a superior version (note the most of the applications work on PHP 4.2.0). PHP must be compiled with --enable-tokenizer and must include the JSON extension.

  2. NetPBB and ImageMagick packages installed (required by Gallery).

  3. pear packages PEAR Spreadsheet_Excel_Writer, DB (required by PHP Bug Tracker).

  4. MySQL 4.1.7 or a superior version (MySQL > 5.0.33 recommended).

  5. Python support installed (required by Google Sitemaps).

The following .deb packages must be installed under Debian:

  1. python

  2. imagemagick

  3. netpbm

It is advisable to use apt-get to install these packages.

The following ports must be installed under FreeBSD:

  1. /usr/ports/graphics/ImageMagick

  2. /usr/ports/graphics/netpbm

  3. /usr/ports/lang/python

  4. /usr/ports/textproc/py-expat

Note

Due to security reasons, 4PSA DOES NOT recommend to any hosting company to set safe_mode off or register_globals on globally in php.ini. Instead, enable the automatic PHP management feature of 4PSA Integrator.

The available free disk space for both partitions, one containing the installation directory and one the /usr/local/psa/admin must be higher than 1GB. 4PSA Integrator can not be installed on a partition with less available disk space.

Required Packages

4PSA Integrator 3 is packaged in the following installation formats:

  1. RPM packages for RPM capable Linux distributions. Available at http://plesk.4psa.com/downloads/

  2. Shell installer for Debian, Ubuntu and FreeBSD distributions. Available for download in the Support Zone (after login).

  3. Virtuozzo EZ templates for installation on virtualized systems. Available at http://plesk.4psa.com/vz

Installation Steps

RPM Capable Linux Distributions

You can use the installer from the 4PSA web site in order to install 4PSA Integrator. Be aware that this installer requires Yum, therefore you must have Yum package manager installed on your server.

If you want to install the RPM packages manually (not recommended), then you can download them from here.

Follow the steps below to install the product using 4psapleskinstaller.sh.

  1. Log in to your server using SSH from Linux or Putty from Windows. You have to be logged in as root in order to install the program.

  2. Create a directory named /usr/local/src.

  3. Download the installer by typing:

    wget http://www.4psa.com/software/4psapleskinstaller.sh

    The installation program will be downloaded.

  4. Execute the 4psapleskinstaller.sh installation script by typing:

    sh 4psapleskinstaller.sh

    Next, follow the instructions on screen.

Debian and Ubuntu Distributions

In this case, you must download the 4PSA Integrator installation script from the Support Zone. To do so, simply click Downloads and download the installation archive.

Note

If you want to install the engine on the same machine, you must first install the engine and then execute the Integrator installer.

Follow the instructions below to install 4PSA Integrator:

  1. Log in to your server using SSH from Linux or Putty from Windows. You have to be logged in as root in order to install the program.

  2. Create a directory named /usr/local/src.

  3. Decompress and untar the distribution file in the previously created /usr/local/src folder by typing:

    tar -zxf integratorXXX_buildXXXXXX.XX_OSPleskX.tar.gz

    The program will extract a directory which contains the installation script. Change to this directory.

  4. Execute the install.sh installation script by typing:

    sh install.sh

    Next, follow the instructions on screen.

FreeBSD

In this case, you must download the 4PSA Integrator installation script from the Support Zone. To do so, simply click Downloads and download the installation archive.

Note

If you want to install the engine on the same machine, you must first install the engine and then execute the Integrator installer.

Follow the instructions below to install 4PSA Integrator:

  1. Log in to your server using SSH from Linux or Putty from Windows. You have to be logged in as root in order to install the program.

  2. Create a directory named /usr/local/src.

  3. Decompress and untar the distribution file in the previously created /usr/local/src folder by typing:

    tar -zxf integratorXXX_buildXXXXXX.XX_OSPleskX.tar.gz

    The program will extract a directory which contains the installation script. Change to this directory.

  4. Execute the install.sh installation script by typing:

    sh install.sh

    Next, follow the instructions on screen.

After Installation

When you install the product for the first time, the clients are not allowed to access 4PSA Integrator.

In order to give access rights to your customers, you must login to Plesk as admin and click the 4PSA Integrator button available in the navigation area. Next, check the Permissions area to give management permissions to your clients.

For more details please consult the User's Guide.

Upgrade

In order to upgrade the system you must execute the same steps like in the product installation (described above).

Compatibility

4PSA Integrator 3 is compatible with Plesk 8.0.0 for Linux/Unix and newer versions. The software is compatible with the following operating systems:

  • RedHat Enterprise Linux 3.x/CentOS 3.x
  • RedHat Enterprise Linux 4.x/CentOS 4.x
  • RedHat Enterprise Linux 5.x/CentOS 4.x
  • Fedora Core 4
  • Fedora Core 5
  • Fedora Core 6
  • Fedora 7
  • Fedora 8
  • Suse 9.3
  • Suse 10.0
  • Suse 10.1
  • Suse 10.2
  • Suse 10.3
  • Suse 11
  • Ubuntu 6.0.6
  • Ubuntu 7.10
  • Ubuntu 8.04
  • Debian 3.1
  • Debian 4
  • FreeBSD 5.x
  • FreeBSD 6.x

Contact and Support

For online help and support please visit:

For mailing addresses and phone numbers from our offices:

http://www.4psa.com/contactus

If you have any question, do not hesitate to contact us.