[MKDoc-users] Installation with SuSE and httpd.conf probs

[Chris Croome]

Hi

On Thu 12-Sep-2002 at 12:36:55 +0200, Friedrich-Stade@gmx.de wrote:
> 
> Can tell you that I needed two days to install the software for MKDoc
> with SuSE 7.3. 

I'm very sorry that you have had such a bad experience :-(

> 127.0.0.1        www.example.com   ////I need this for what?
> 127.0.0.1	editor.example.com  //// ????????
> 127.0.0.1       admin.example.com  ////????????

If you want to just use IP addresses to access MKDoc then you need one
IP address for the public interface (www.example.com) one for the editor
interface (editor.example.com) and one for the administrators address
(admin.example.com).

However I don't expect that you do want to just use IP addresses, in
which case you need to invent 3 domain names (these can be based on the
example ones above -- change example.com to whatever.com) and you will
also need to add these to your computers hosts file (/etc/hosts) if you
don't have a name server.

> #####################################################################
> This is my modified MkDoc httpd.con
> #######################################################################

The file you attached is actually the template that MKDoc uses when the
install.pl script is run to generate a httpd.conf file.

> ######################################################################
> This is my install.config
> ######################################################################
> # ============================
> # MKDoc installation directory
> # ============================
> #   Set this variable to wherever MKDoc 1.1 is
> #   installed on your system. No trailing slash!
> 
> MKDOC_DIR	/usr/local/httpd/htdocs/mkdoc

For a development machine this isn't a big issus, but you shouldn't have
your MKDoc directory somwehere where it is served by Apache as you do
with the path above for a production machine.

> # ==================
> # Domain names setup
> # ==================
> #   This is where you set your public, admin and
> #   super-user domains. It will set MKDoc so that
> #   it can accept the domain but also www.domain
> 
> PUBLIC_DOMAIN	127.0.0.1
> ADMIN_DOMAIN	127.0.0.1
> SU_DOMAIN	127.0.0.1

The adove does need to have 3 different domain names, or 3 different IP
addresses -- see above for an explanation.

Hope this helps

Chris

-- 
Chris Croome                                         <chris@mkdoc.com>
MKDoc                                                http://mkdoc.com/