Installation guide (ISPmanager)

From ISPWiki

Jump to: navigation, search

This article provides information on installing the control panel on your server, including pre-requisites and the stages you should pass, as well as instructions on how to start working in ISPmanager.

Follow the steps below to perform a successful installation of ISPmanager:

Contents

System requirements

Before installing ISPmanager, make sure that the following requirements are met:

Operating system

Please note! The current  version will be installed! 

The list of supported operating systems is growing all the time.

We would recommend that you run Linux (Debian or CentOS). If using other versions, make sure that the distributive includes the required software.

You will be prompted to install a hostname, if needed.

Disable SELinux, if any, by changing SELINUX=enforcing into SELINUX=disabled in the configuration file /etc/selinux/config, and reboot the system.

Software

All services that ISPmanager requires will be automatically installed during the ISPmanager installation process. You should install a minimal version of the operating system. Linux requires the one where Apache/PHP/MySQL-servers are not installed and configured.

If any part of the software is already installed on the server, the Setup Wizard will try to configure it to run with ISPmanager.

IP-address

You should use public static IP addresses for connections through http (you cannot use NAT).

The license's IP-address must be first on the list of IP-addresses the ifconfig command returns. If not, you can run install.sh with the --ip IP-address key.

Installing the panel

Step 1

Be sure to obtain the active license for your IP-address. Go to BILLmanager to make sure you are running the active license.

Step 2

Enter shell on your server and run any of the commands below:

fetch "http://download.ispsystem.com/install.sh"
curl -o install.sh "http://download.ispsystem.com/install.sh"
wget "http://download.ispsystem.com/install.sh"

Then

sh install.sh

The following are the keys to be used for running the install.sh script command that can be specified in case of problems:

--os OS Provide the operating system manually
--arch ARCH Provide the architecture manually (i386, i686)
--ip IP Provide the IP-address license manually

Welcome to the Setup Wizard

Image:en-install.guide-welcome.gif

If you are running CentOS, the installation script will enable you to add repositories. CentOS base repositories contains the most stable packages, however a number of packages are not included. To use all the features of the control panel, connect additional repositories:

  • Extra Packages for Enterprise Linux (EPEL)
Image:en-install.epel.gif

This repository contains additional packages for Enterprise Linux, including Red Hat Enterprise Linux (RHEL), CentOS and Scientific Linux (SL). The control panel uses it to install such packages as PowerDNS, Nginx, MyAdmin, pgAdmin, clamav-milter, etc.

  • RPMForge
Image:en-install.rpmforge.gif

This repository is considered the safest and the most stable. The control panel uses it for installing a number of packages that are also included into the EPEL repository.

  • ATrpms
Image:en-install.atrpms.gif

The repository is responsible for the latest versions of applications and should be used to enable the DKIM filter in the control panel.

The installation script will prompt you to choose the components you want to install:

Image:en-install.guide-mode.gif
  • Install most popular software - the most popular software will be installed (such as Apache, PHP (latest versions), Sendmail (Exim for Debian), Dovecot, Proftpd, FastCgi, Bind, MySQL, Webalizer, AwStats, PhpMyAdmin). We recommend that you use this mode for it provides the quickest installation.
  • Minimal install (includes web server only) - only Apache will be installed. You will be able to install other software in the Applications module.
  • Install all supported software (default for anything) - all components of the panel will be installed. PostgreSQL, PhpPgAdmin, mailing lists will be added to the first mode. You can delete the ones you do not need in the Applications module.
  • Gives you a choice of software - only selected components will be installed. Do not choose his mode unless you are an experienced user.
Image:en-install.guide-choose.jpg

If you choose Gives you a choice of software, you will be prompted to set up the network and system features that you can install on your distribution.

To configure a service, select one you need and click "Enter". Provide the software version that you can use not to install this service.

Image:en-install.guide-detail.jpg

Note If any of the software versions is already installed on your server, in the Setup Wizard you will see only its version, all other program variants hidden.

Once you have configured software versions, select "Install" and click "Enter". When the installation has been completed, the ISPmanager Setup Wizard will check the installed services and display the results.

Image:en-install.complete.gif

If one or more errors occurred during installation, make sure that the package managers on your server are working correctly. For example, if you run Debian, check that correct links are specified in /etc/apt/sources.list (apt package manager runs correctly), if running CentOS/Fedora, that the yum package manager is running correctly.

If you want the ISPsystem's administrators to help you install ISPmanager, provide them with the root password to gain access to your server. This user must be able to SSH to the server. To do that, enable the following option in /etc/ssh/sshd_config


PermitRootLogin yes

Step 3

Open the URL below in your favourite browser to gain access to ISPmanager. Log in to the control panel using your system users' privileges. Enter the root password and username if you log in to the control panel for the first time

https://IP-address/manager/

Advanced users can install the software or configure the control panel manually.

More information can be found in the article Technical details.

Was this helpful? Yes | No
Personal tools