Configuring built-in web-server

From ISPWiki
Jump to: navigation, search

The built-in web-server that is provided with COREmanager-based software products is configured automatically.

Automatic configuration of the built-in web-server

The built-in web-server automatically listens to port 1500 of the main IP address (both IPv4 and IPv6).

Different ways to configure the built-in web-server

You can configure the web-server to listen to certain IP addresses and ports either through the command line or the configuration file.

If you specify settings in the configuration file, the configuration parameters that were specified in the command line, will be ignored.

Command line

When starting the web-server you can specify a specific IP address and port to listen. For more information about this function start the web-server using the -h key.

Configuration file

Fore more flexible configuration of your built-in web-server you can use the file etc/ihttpd.conf of a COREmanager 5-based software.

In the listen section of that file you can specify IP addresses to listen:

 listen {
   ip <IP address to listen>
   port <port to listen>
   certkey <path to the file key of the SSL-certificate>
   cert <path to the SSL-certificate's file>
 }
  • IP address is a mandatory parameter
  • Other parameters are optional
  • If the "port" parameter is not specified, the default port (1500) of the built-in web-server will be used
  • Both the "certkey" and "cert" parameters must be specified. You cannot specify only one parameter.
  • If the certificates' paths are not specified, the built-in web-server will use a self-signed SSL certificate that was created automatically
  • If the redirect parameter is specified, users won't be able to access the panel through HTTP. HTTP requests will be sent to the same URL through the HTTPS protocol. (we do not recommend that you use this option for VMmanager, VEmanager and DCImanager, as it may cause errors when running OS installers). If you install the panel from packages, redirect is specified by default except for VMmanager, VEmanager and DCImanager.

Example:

 listen {
   ip *
 }

The built-in web-server will listen to all IPv4 addresses available using the default port ("*" equals "0.0.0.0")

 listen {
   ip 5.6.7.8
 }

The built-in web-server will listen to IPv4-address 5.6.7.8

 listen {
   ip 5.6.7.8
   port 1700
 }

The built-in web-server will listen to IPv4-address 5.6.7.8 on port 1700

 listen {
   ip 5.6.7.8
   port 1700
   certkey etc/my.key
   cert etc/my.crt
 }

The built-in web-server will listen to IPv4-address 5.6.7.8 on port 1700 and the etc/my.crt file of the etc/my.key SSL certificate with the key for SSL requests (https)

 listen {
   ip ::
 }

The built-in web-server will listen to all IPv6 addresses available on the default port

 listen {
   ip 2001:db8::ae21:ad12
   port 1800
 }

The built-in web-server will listen to IPv6-address 2001:db8::ae21:ad12 on port 1800

After you have modified the ihttpd configuration file, restart the service

CentOS 6, Debian 7:

/etc/init.d/ihttpd restart

CentOS 7, Debian 8:

systemctl restart ihttpd

Index page

By default COREmanager opens at <server IP adddres>:1500. To change it into another panel, in the directory /usr/local/mgr5/bin/ create the index file with a <panel short name>

E.g. to open ISPmanager by default, create the file containing ispmgr

#cat /usr/local/mgr5/bin/index
ispmgr

Restart COREmanager

killall core

Technical details

Connection remains active during one hour.