DSmanager Installation (DSmanager)

From ISPWiki

Contents 1 System requirements 1.1 Operating system 1.2 Software 1.3 Server IP-address 2 Installation guide 2.1 Step 1 2.2 Step 2 2.3 Step 3 3 FreeBSD 3.1 Apache

System requirements

Operating system

We recommend You to use FreeBSD or CentOS or Debian Linux, as these distributions have the most part of the software required for operation.

Software

The Setup program will automatically install the software, but in most cases it is recommended to install the software on the empty server.

If any part of the software already exists on the server, the Setup program will try to adjust it for running with DSmanager.

Server IP-address

To install a program product You need a real static IP-address, which should be present on the server network address. Connection via http-protocol should be realized from this address (address translation is not accepted).

The IP-address with the DSmanager license should stand first in the list of IP-addresses, that are returned by the ifconfig command. If not, You may start the install.sh script with a key --ip IP-address.

Installation guide

Step 1

On this step You should have an active license. If not, You can order it here. If You are not sure, whether your license is active, You may check it in the BILLmanager system.

Step 2

Enter the command shell on your server and start any of these commands:

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

Next

sh install.sh

The keys of install.sh script start the command, that can be specified in case of errors:

--os OS Operating system manual setting --arch ARCH architecture manual setting (i386, i686) --ip IP IP-address license manual setting

If Apache is not present, the Setup program will notify You

Apache webserver ... pkg_info: no packages installed [NOT FOUND] dnsmgr can't work without Apache Have you installed Apache? [y/N]

If Apache is not installed, press Enter and the the Setup program will prompt to install it

Would you like install it ? [Y/n]

Select Apache installation(press Enter), Apache web-server installation will proceed

Once installation is complete, the DSmanager panel will prompt You to enter the admin password to access DSmanager

Please enter admin password for access the control panel :

If You want ISPsystem administrators to help You install DSmanager, You should let them know the root password on your server. Besides, this user should have the possibility to enter the server via SSH. To do so, in the /etc/ssh/sshd_config file enable the option

PermitRootLogin yes

Step 3

To access DSmanager, use the following URL, applying your server IP-address. For authorization use the users stored in DSmanager configuration file, the password is provided when installing. Enter with the admin privileges

https://IP-адрес/manager/dsmgr

FreeBSD

Use a /usr/local/ispmgr directory for installation

If necessary, the following software can be installed (the list and releases may vary depending on the distribution):

Apache ...

Apache

The Include directive required for DSmanager operation is added to the Apache configuration file

Include /usr/local/ispmgr/etc/ispmgr.inc

For secure connection via SSL, You need to have secret keys created by the command:

openssl req -new -newkey rsa:1024 -nodes -keyout /etc/mail/certs/server.key -x509 -days 5000 -subj "/C=XX/CN=hostname/emailAddress=root@hostname" -out /etc/mail/certs/server.crt

The key and the certificate are copied into the required directories

/usr/local/etc/apache/ssl.crt/server.crt /usr/local/etc/apache/ssl.key/server.key