You have installed Apache and Comanche. So what is next?, you ask. Now we will very glad to guide you through Comanche, show you its capabilities and help you know better each other.
To start the program, click on the Comanche icon on Windows or type "./comanche /path/to/config/files" in the appropriate directory on UNIX.
A logo should pop-up and shortly after the main Window will appear. It is divided in three main areas:
[In the future it will be possible to connect to remote machines or configure more than one installation of Apache in the same machine. By now, you just can configure the local machine, so only "Apache Machine" appears]
Double-click on the Comanche folder. A new blue computer icon should appear hanging from the Comanche folder. If you double-click on it or click on the circle on the left, it will expand and show its contents. You will see at least two Folders, one named "Server Management" and the other "Main Server".
To start/stop/restart apache select server management (support for starting/stopping apache as a service in NT will be done in the near future, by now you just have to live with that dos box that will pop up.)
To save the configuration, just press save
To make the server re-read the new configuration, save and then press the restart button.
If you double-click now on the "Main Server" icon, it will expand and show directory and location icons.
If you have defined virtual hosts, they will appear as well, below Main Server. If you have not, but you would like, just do the following: Click with the right button of the mouse on the computer icon representing the Apache server where you would like to create the new virtual host. A menu will pop-up, select New->Virtual Host.
[In the future there will be a wizard here, explaining the available options (name based/ IP based), etc. Right now, just enter the name of the new virtual host]
The process through one creates a new directory or location is basically the same, select the appropriate Main Server or Virtual Host, right-click and select New->Directory
[The same, in the future a wizard will appear, right now just to enter the name]
To delete a directory is as simple as select it, right-click and choose the delete option
[In the future, support for multiselection & undo]
By now you should be able to create and delete Virtual Hosts, Directories and Locations. Now we will move into how to configure them. Just right-click on the one you want to configure and select the properties entry. A (surprise) properties window will pop up, which is divided in two parts. Think of it as a normal tabbed Windows property page, just with so many tabs that they are arranged and structured on the left (much like Netscape Communicator 4.0 preferences dialog). You can press on the leaves on the left and the corresponding configuration page will display on the right. Double-clicking on the leaves will expand/collapse parts of the tree and allow you to navigate the property pages.
After you have made the changes, press the Ok button and they will be stored.
You can see how your changes affected the configuration files if you select the appropriate location or directory in the left pane and choose the conf pane [in the future this changes will be highlighted and also one will be able to edit directly there]
When you are done and configured everything, go to the Server Configuration and save the configuration and restart the server. If something goes wrong you can always use on of the previous configurations [not yet, there will be configuration history, etc... So please back up your files before playing with comanche]
So basically that is Comanche. We hope that you like it and find it useful. The rest of this document describes in depth the available options and describes the way to accomplish common tasks
[to be continued]