View source for Installing ISPsystem software products from repository

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:  

<font color="red">We do not recommend that you connect third-party repositories</font>

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
<bash>
wget -O install.sh "http://cdn.ispsystem.com/install.sh"
</bash>

and start it 
<bash>
sh install.sh
</bash>

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:
<bash>
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"
</bash>

Example for stable versions:
<bash>
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"
</bash>

== Debian ==
Select the version: '''alpha'''<ref>Alpha version can be used only for development needs and test of functionality.</ref>, '''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 '''<pre>http://download.ispsystem.com/repo/debian/<OS version>-ispsystem-<version>.list</pre>''' into the directory '''/etc/apt/sources.list.d/'''


Example of ''Debian wheezy'' for beta versions:

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

Create a file for ''base'' repository 

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

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

Add the key

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

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

<pre>apt-get update</pre>

= 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:

<bash>
yum install coremanager
</bash>

or

<bash>
yum install dnsmanager
</bash>

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: 

<bash>
yum update dnsmanager coremanager
</bash>

=== 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''.
<bash>
/usr/local/mgr5/sbin/licctl fetch ispmgr
apt-get update
/usr/local/mgr5/sbin/pkgupgrade.sh coremanager
</bash>

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:

<bash>
apt-get install coremanager
</bash>

and 

<bash>
apt-get install dnsmanager
</bash>

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 ===

<bash>
apt-get update
apt-get dist-upgrade
</bash>

=== Upgrade from '''beta''' to '''stable''' and vice versa ===


In order to upgrade from '''stable''' to '''beta'''

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

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 run'''CentOS'''  - '''panelname-devel''', '''Debian''' - '''panelname-dev'''

Example: the name of the package for ipmanager on CentOS is'''ipmanager-devel'''. The package name for ispmanager-lite on Debian is '''ispmanager-lite-dev'''

[[Category:ISPmanager: Technical articles]]

[[Category:Setup and configuration]]