ISPMan 0.8.2 Installation and Configuration
<<< PreviousInstalling ISPMan 0.8.2Next >>>

Setting up Apache for ISPMan

You basically have two choices in setting up Apache:

Install a dedicated web server for ispman-web-interface

make ispman_web_server

This will download and install apache, mod_perl and mod_ldap modules. If something fails, check the LIBS= and EXTRA_LIBS= declarations in the file $SOURCE/makedefs

Once the compile and install is done edit the httpd.conf file, modify User, Group and Port to fit your requirements. For cgi-bin, make sure you have the following settings:

<Directory /opt/ispman/cgi-bin>
AllowOverride AuthConfig
Options +ExecCGI
</Directory>

Start the server:

/opt/ispman/bin/apachectl start

Verify that it has started

ps ax | grep httpd

Then access the http://your.ispmanserver.name:port with a browser. You will be prompted for a username/password. The username is the same as you set for the admin, during the “make ispman” step, above.

Start ispman-agent

On my system this is

opt/ispman/bin/ispman-agent start

If you chose a diferent prefix during your install, your path will be slightly different. Other arguments to ispman-agent are “stop”, “restart”, “forcerestart” and “nodetach”. “forcerestart is for restarting after an “unclean shutdown”. “nodetach” is for running ispman-agent in the foreground.

Configure your existing server to serve ispman-web-interface

Install mod_ldap

The only requirement is that you must have mod_ldap 1.8 or higher, installed and loaded by your webserver. If you do not already have mod_ldap, it is provide with the distribution and is located in $SOURCE/install-data/extras/mod_ldap/ . To build and install this module as a DSO (Dynamic Shared Object)

cd $SOURCE/install-data/extras/mod_ldap
edit the Makefile to suit your system, if necessary
make all
make install

Restart apache webserver.

Create a VirtualHost configuration

Create a VirtualHost for ispman. Instructions on virtual host configuration are available at  http://httpd.apache.org/docs/vhosts/index.phtml   and is beyond the scope of this document. Here is a sample virtual host container:

NameVirtualHost 192.168.0.1
<VirtualHost 192.168.0.1:80>
ServerName ispman.somwhere.net
DocumentRoot /opt/ispman/htdocs
ScriptAlias /cgi-bin/ /opt/ispman/cgi-bin/
<Directory /opt/ispman/cgi-bin/>
AllowOverride AuthConfig
Options +ExecCGI
</Directory>
</VirtualHost>

Note: ispman.somewhere.net should be a name resolvable via DNS to this host.

Restart Apache

Now restart your the Apache webserver and visit http://ispman.somewhere.net/index.phtml You should see an ispman web interface there.