DNSmanager installation (DNSmanager)

From ISPWiki

Follow the procedures below to install DNSmanager

System requirements

Operating system

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

Software

The Setup Wizard will automatically install the software for proper operation, but in most cases fresh installation is recommended.

If any part of the software already exists on the server, the Setup Wizard will try to adjust it for running DNSmanager. 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).

IP-address with the license for DNSmanager management should stand first in the list of IP-addresses, that are returned by the ifconfig command. If the address is not the first in the network interface, You can 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 You are not sure, whether your license is active, You can check it in the BILLmanager system.

Step 2

Enter the command shell on your server and start any command:

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 keys of install.sh script start a 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 missing, 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]

In case Apache is not installed, press Enter for the Setup Wizard to offer to install it

Would you like install it ? [Y/n]

Select Apache installation(press Enter) to proceed to Apache web-server installation.

Once installation is complete, the DNSmanager panel will ask You to enter admin password to access DNSmanager

Please,enter admin password for access the control panel:

If You want ISPsystem administrators to help You install DNSmanager, You should let them know the password root 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 DNSmanager, use the following URL, applying your server IP-address. For authorization use the users stored in DSmanager configuration file, the password is specified during installation. Enter with admin privileges.

https://IP-address/manager/dnsmgr

Technical details

FreeBSD

Installation to the directory /usr/local/ispmgr

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

Apache bind

Apache

The Include directive required for DNSmanager working 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 with the command:

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

Then the key and the certificate are copied into the directories required for their operation

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