Installing ISPsystem software products from repository

From ISPWiki
Jump to: navigation, search

ISPsystem's software products can be installed and updated using OS in-built tools, i.e. using OS repositories.

Before you start, connect the ISPsystem repository. You can do this manually or with a script. Both methods are described below:

We do not recommend that you connect third-party repositories

In order to install a software product, connect ISPsystem's repository. You can do this either manually, or using a script. For more details, see the information below:

  • if the license for that IP (the one to which the request was sent) has never been ordered or it has not yet expired, the trial will be activated automatically and the panel will be installed. (the trial license that was ordered automatically will display in a client area).
  • if the tiral for that IP has already expired, the installation will finish showing the License does not exists error message.

If you have the license, but your server is using internal IP address (i.e. you need to use the activation key for activation), execute the following command before you start:

  export ACTIVATION_KEY=<activation_key>

The above command will install the environment variable, and you will be able to proceed with the panel installation.

IMPORTANT NOTES: You must be logged in as root to be able to install and use the control panel using this method.

Connect repository automatically

Repositories both for CentOS and Debian can be added with a script.

Download the script to the server

wget -O install.sh "http://cdn.ispsystem.com/install.sh"

and start it

sh install.sh

The script will ask you to select a version: beta or release and will connect the corresponding ISPsystem repository. It will also connect other repositories (EPEL for CentOS) and update the package cache.

Once completed, the script will ask you what product you want to install.

Connect repository manually

CentOS

Select beta or stable.

Each version is located in a separate repository.

To add a repository, download a required "repo-file" and locate it into /etc/yum.repos.d/. Update the packages cache.

Some packages can be also found in the repository EPEL. You won't be able to install a software product without it.

Example for beta versions:

rpm -iU http://download.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
wget -O /etc/yum.repos.d/ispsystem-base.repo "http://cdn.ispsystem.com/repo/centos/ispsystem-base.repo"
wget -O /etc/yum.repos.d/ispsystem.repo "http://cdn.ispsystem.com/repo/centos/ispsystem-beta.repo"

Example for stable versions:

rpm -iU http://download.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
wget -O /etc/yum.repos.d/ispsystem-base.repo "http://cdn.ispsystem.com/repo/centos/ispsystem-base.repo"
wget -O /etc/yum.repos.d/ispsystem.repo "http://cdn.ispsystem.com/repo/centos/ispsystem-stable.repo"

Debian

Select the version: alpha[1], beta or release (release is not available for packages yet).

Each version is located in a separate repository.

To add a repository, download the file
http://download.ispsystem.com/repo/debian/<OS version>-ispsystem-<version>.list
into the directory /etc/apt/sources.list.d/


Example of Debian wheezy for beta versions:

wget -O /etc/apt/sources.list.d/ispsystem.list "http://cdn.ispsystem.com/repo/debian/wheezy-ispsystem-beta.list"

Create a file for base repository

echo "deb http://cdn.ispsystem.com/repo/debian base-wheezy main" > /etc/apt/sources.list.d/ispsystem-base.list

Enter a code name of a distribution instead of wheezy, if needed (e.g., jessie)

Add the key

wget -q -O - http://cdn.ispsystem.com/repo/debian/ispsystem.gpg.key | apt-key add -

After you added the record or downloaded the file, update the package cache:

apt-get update

Software installation and update

Once you connected the ISPsystem repository, you can use standard means of the operating system for software installation.


IMPORTANT NOTES: fresh installation is required. Installing on the system where some data are used, and services are already running (such as, MySql database) may cause data lose.

CentOS

Installation

Install the software using standard means:

yum install coremanager

or

yum install dnsmanager

Once you are done, you can access the panel at https://IP-ADDRESS:1500/panel_short_name. Short names are core, dnsmgr, ipmgr, ispmgr, dcimgr и т.д.

Login - root, password - root password to your server. Add a user with administrator privileges for managing the control panel.

Update

Use standard procedure depending on your OS:

yum update dnsmanager coremanager

Upgrade from beta to stable and vice versa

Downgrade from stable to beta:

Modify contents of the /usr/local/mgr5/etc/repo.version file by changing stable into beta.

/usr/local/mgr5/sbin/licctl fetch ispmgr
apt-get update
/usr/local/mgr5/sbin/pkgupgrade.sh coremanager

Downgrading from beta to stable is possible with downgrade but may lead to unwanted results, and is not supported.

Debian

Installation

Install a software product:

apt-get install coremanager

and

apt-get install dnsmanager

Once you successfully install the panel, you can access it at https://IP-ADDRESS:1500/panel_short_name. Short names: core, dnsmgr, ipmgr, ispmgr, dcimgr и т.д.

Login - root, password - root password to your server. Add a new user with administrator privileges for managing the control panel.

Update

apt-get update
apt-get dist-upgrade

Upgrade from beta to stable and vice versa

In order to upgrade from stable to beta

/usr/local/mgr5/sbin/licctl fetch ispmgr
apt-get update
/usr/local/mgr5/sbin/pkgupgrade.sh coremanager

Downgrading from beta into stable may lead to unwanted results. This variant is not supported.

You will have to wait for a new update of this version (release candidate).

Software installation

IPmanager

IPmanager can work with 3 different DNS servers: bind, nsd, powerdns

There are 3 versions of IPmanager packages: ipmanager-bind, ipmanager-nsd, ipmanager-pdns

To install IPmanager with a desired DNS server, you need to install a corresponding package:

Example: execute the following for installation with powerdns

yum install ipmanager-pdns

We recommend that you use bind, because if you do not select a DNS server, bind will be installed.

ipmanager-bind will be installed when installing ipmanager

The control panel can be accessed at https://SERVER_IP:1500/ipmgr

DNSmanager

Complete the same steps as for IPmanager installation

The control panel can be accessed at https://SERVER_IP:1500/dnsmgr

VMmanager

Currently vmmanager-basic and vmmanager-cloud are available.

yum install vmmanager-basic

or

yum install vmmanager-cloud

The control panel can be accessed at https://SERVER_IP:1500/vmmgr

VEmanager

yum install vemanager

The control panel can be accessed at https://SERVER_IP:1500/vemgr

DCImanager

DCImanager is available in 2 versions: DCImanager and DCImanager Enterprise.

To install a required version, you need to install the corresponding package:

yum install dcimanager-essential

or

yum install dcimanager


The control panel can be accessed at https://SERVER_IP:1500/dcimgr

ISPmanager

ISPmanager-Lite

Due to a large variety of software configurations, ISPmanager can be installed by 2 different means: minimal installation (ispmanager-lite-common) and recommended (ispmanager-lite).

If you select recommended, install ispmanager-lite

yum install ispmanager-lite

This package will install ispmanager-lite-common (ISPmanager) and recommended packages.

If this version does not suit you, you may install only ispmanager-lite-common

yum install ispmanager-lite-common

Applications can be installed either from the ISPmanager interface or by packages ispmanager-pkg-<APPLICATION_NAME>

For example, phpmyadmin can be installed as follows:

yum install ispmanager-pkg-myadmin

The control panel can be accessed at https://SERVER_IP:1500/ispmgr

Header files

available in version 5.19 and later

Header files are available for the control panels.

If you run Linux-based systems, you need to installed the additional package for their installation.

If you runCentOS - panelname-devel, Debian - panelname-dev

Example: the name of the package for ipmanager on CentOS isipmanager-devel. The package name for ispmanager-lite on Debian is ispmanager-lite-dev
  1. Alpha version can be used only for development needs and test of functionality.