Welcome to the help page for Apache2Triad

To bring up the control panel enter http://localhost/apache2triadcp/ into a web browser. You will be prompted for username and password. Default user and is root and the password is the one you set up in the installer. If you have used the change domain script, you should still be able to access through local host.

Icon Legend

Introduction

Additional Info

 

These are the blocks on the main page of the Apache2Triad Control Panel

 

Status

Info

-------------------

System

-------------------

Servers

-------------------

Interpreters

 

  • PHP

  • Perl

  • Python

  • TCL

-------------------

Services/Processes

 

 

 

Status

 

 

This block displays much information about versions and locations. If something is not working right check here and match up locations in shebang's ect. Also make sure the needed version of whatever language you are working with matches up. Some useful info about your apache2triad installation. See
icon legend. Most of the files in the System Information section requires you to be at the machine to retrieve some documents, this is because the files are outside of the doc root and cannot be accessed remotely. You can click to bring up additional info, usually the readme's. You have to be logged on locally to view these files. You can hover the mouse over the graphics and it will show you the error.

 

 

Top

 

 

Info

 

 

This block displays information about curent server status , user info and setup info. You can tell of problems with the installation here if you see warning or notice icons (icon legend)

 

 

Top

 

Services/Processes

 

 

These control the heart of Apache2triad programs. Checked boxes will auto-start when Windows starts. You can stop and start MySql, Xmail, and Slimftpd from here. Please note that only Apache can be stopped and NOT started from here. Use ApacheMonitor to restart Apache. Also note Xmail does NOT run under Windows 9x platforms.

 

 

Top



Introduction

 

            The goal of this document is to provide support information on the Apache2Triad web server bundle (Current Version is 1.5.0). It will attempt to explain some common issues some people have while installing/running it. It will not contain information of each specific program, as this is well outside the scope of this document. It is always best to consult with the manuals/documentation of the program you are using. Even though Apache2Triad was designed to run on a Windows platform, most of the programs were developed on Linux type computers. Some, not all, have Windows support information. Some people would say that running an Apache web server on a Windows machine is unsecured, although ANY server ran on ANY machine may be unsecured, it is always usually a lack of knowledge of the security mechanisms that provide a unsecured environment.

            It is recommended that only experienced users, with a vast knowledge of how networks, and its components (Apache Web Server, ect.) should install this software. It IS NOT your average software; a lot of time, patience and effort are required to maintain such a server. Having said this, all responsibilities remain on the end user who installed such systems, not the creators. From time to time there may be security situations, in such event it is the responsibility of the end user to correct such issues. 

            Some notes before when begin. Throughout this document we will use some common variables, like install path domain ect. Below is a table you can use to identify such variables. Information contained in () are the defaults, and will probably be the same unless you changed them at installation. The default domain is and will remain http://localhost/ throughout this document. If you use the change domain script, you can use either.

 

%InstallDir%    the path which you installed apache2triad (C: /apache2triad/)

 

%DocRoot%    the web serverís documents root. (C: /apache2triad/htdocs/)

 

%windir%       the systemís base dir. It is OS specific. (XP Users: C: /windows/)

 

Top


System

 

Status Scripts

 

server- info Ė Apacheís built in server information script. Displays a variety of information.

server-status Ė Apacheís built in status script. Displays a variety of information.

 

 

 

Top

 

 

 

Server Logs

 

server-error-logs Ė Displays most frequent errors and the last 10 errors from Apache, Apache SSL, MySql, PHP error log. This is very useful in finding common errors on your system.

server-access-logs - Displays all of the servers access information.

server-security-logs Ė Displays a list of past known hacking attempts on your server. If possible, itís recommended to check this frequently and filter out these IP addresses. (Use your firewall to deny these IP addresses access). It should be also noted, some of these may be valid attempts. Caution should be used here.

 

 

Top

 

 

 

Server Protection

 

This script will attempt to add some security settings to various scripts/programs. What is displayed on the screen will be changed.

 

After running the script you should restart your computer or all the servers for changes to take place

Top

 

 

Online Information

 

 

Online News


Click here often to check for various news on Apache2Triad.

 

 

Top

 

Online FAQ

 

Click here first, if you have any problems. This displays the Online FAQ. This document should not differ much from the one located in this document, it's wise to check both.

 

 

Online Feedback/Support

 

Click this to go to the forums. Be sure to read the Apache2Triad FAQ, and the Forum Posting Guidelines before posting please.

 

 

 

 

Online Update Check

 

Click here to find updates, new versions for Apache2Triad bundle.

 

 

 

Top

 

 

 

Change Password

 

 

 


This is the first thing you should do after installing Apache2triad! Take heed: You must not have a password with common or dictionary words because of security! Your Old Password WILL BE DISPLAYED, this is not a field for entering your old password. There are programs available that use dictionary and even brute force attacks to break passwords, and they do work. The best password is one that someone could not associate with you (petís names, kidís names ect.). A ideal password should include letters and numbers. This will be the password for all programs using the user root. Restart all services for this to take full effect. If you do not change the password, your server(s) will be open to anyone who knows the default password (triadpass)

Also remember, if you have manually changed your passwords for the different apps and then use this script, it could possibly break those passwords and make the programs inoperable.

 

 

Top

 

 

 

Change Domain

 

 

Where New Domain is your domain (default is localhost), enter the domain and click Change domain. You must own the domain in which you are changing to. If not there will be errors as it simply will not route properly. If you use a domain router (no-ip.com, dns2go.com ect.) enter it here. Leave out and suffix (e.g. www) Itís generally not a good idea to use IP address here. YOU MUST RESTART APACHE AND XMAIL FOR THE CHANGES TO TAKE EFFECT!! Although you can stop/start Xmail from the control panel, itís best to use the bundled program ApacheMonitor (%InstallDir%\bin\apachemonitor.exe) to restart Apache.

 

 

Top

 

 

 

CGI Scripts Fix

 


This script will change all acceptable files (either perl, python or TCL) to the appropriate location it needs to point to. This is a very useful script.

 

 

 

Top

 

 

 

Registry keys clean


 

This script will fix MySql registry keys from a old MySql installation , with wrong service paths, known to cause problems for apache2triad. Run this if you have problems and have had a variation of Apache/MySql ect previously.

 

 

 

Top

 

 

 

Old installations clean


 

This script will search for some files from old installations of php MySql and perl , known to cause problems for apache2triad. Delete any files it finds.

 

 

 

Top

 


Apache


 

You will notice 2 icons on either side of Apache, and . Click the  to bring up AWStats. And to bring up the Apache configuration GUI.

 

 

 

Apache Scripts

 

 

AWStats | configuration | error.log | access.log | httpd.conf | SSI test | Apache Manual | ApacheASP

 

 

 

Apache Configuration

 

This script allows for some minor and often changed parts of the httpd.conf file. Although not as powerful as editing the httpd.conf itself, it can be very useful.

 

The upper checkboxes allow for different variations of programming languages that can be used with apache. Its best you don't load either of mod_perl , mod_python or mod_tcl as long as CGI is loaded Apache::ASP needs mod perl to be loaded in order for it to function. When enabling CGI you are enabling Perl , Python and TCL in CGI mode. Disabling one of SSI, PHP or CGI will render parts of the Apache2Triad CP inoperable. After running the script you should restart apache for changes to take place.

Be aware that The server name and port of the server: is NOT the same as the domain name change script.

 

For production, or live servers, its best leave as little info about what kind of system you are running. The only info that web visitors need from your site is the content, not what makes it run. Good settings for live servers could be:

 

The server signature configuration : Off or Email
 

The amount of server info made public : Prod

 

More Info on Apache | Apache Documentation

 

 

error log

 

 

This displays error in the apache server. Useful for finding problems. If you have problems and suspect Apache is the culprit, check here and look for potential problems. This files' location is %InstallDir%\logs\error.log

 

 

access log

 

 

Can view the access logs of apache. You can see exactly what apache is sending out, and receiving. If you see suspicious activity you can get the IP address here and investigate further, and possibly block the IP on your firewall. This files' location is %InstallDir%\logs\access.log

 

 

httpd.conf

 

 

This script allows complete editing of the httpd.conf file. It controls EVERY aspect of the Apache Web Server. Its not wise to edit this file without prior knowledge of it's parameters. If you do edit this file, make a backup so you can retrieve previous settings. And also add directives to the bottom of the file, as there is not really a sequence to it. And comment things clearly for later use. (Comments use # as the first character on the line). Most problems apache encounters are bad config file. Check here often, and understand it thoroughly.

 

 

SSI Test

 

 

Server Side Includes (SSI). This will test to make sure SSI is working properly.

 

 

 

ApacheASP

 

 

This is apache's version of ASP, note IT IS DIFFERENT FROM MICROSOFT ASP, and scripts will probably require some heavy editing to work correctly.

 

 

Top

 


MySql


 

You will notice 2 icons on either side of MySql, and . Click the to bring up phpMyAdmin. And to bring up the Apache2Triad MySql Configuration.

 

 

phpMyAdmin | MySql configuration | error log | access log | my.ini | MySql Test | MySql Manual

 

 

Apache2Triad MySql Configuration

 

 

Here you can change most aspects of how MySql operates. You can choose to disable enable Berkley DB and/or InnoDB.

 

 

 

error log

 

 

Displays the MySql error log, check here if you have problems with MySql. Default location is %InstallDir%\MySql\logs\myerror.log

 

 

 

access log

 

 

Displays access to MySql. Default location is %InstallDir%\MySql\logs\myaccess.log

 

 

my.ini

 

 

This is the raw MySql configuration file, it's highly recommended NOT to edit this file. Controls all aspect of MySql. Default location is %Windir%\my.ini

 

 

 

MySql test

 

Will test MySql connection.

 

 

Top

 



Additional Information

 

Before reading it is important to understand the format: [program/script name] [version] [release version of apache2triad]

 

Apache                   ApacheMonitor | OpenSSL

Apache Add-ons    PHP | MySql | Xmail | SlimFTPd

Scripts                    phpxmail | AWStats | phpMyAdmin

 

 

Apache

 

 

Apache 2.0.52 (a2t v. 1.5.0)

http://www.apache.org

http://httpd.apache.org/docs-2.0/platform/windows.html

 

Defaults:

 

Doc Root         : %InstallDir%\htdocs

Port                  : 80

Server Name    : localhost

Server Email     : admin@localhost

Server Sig        : On (need to change for production, or live server)

Server Status    : On (need to change for production, or live server)

 

ApacheMonitor 2.0.52 (a2t v. 1.5.0)

 

No Defaults, Windows Binary File

DefaultLocation: %InstallDir%\bin

No documentation

 

OpenSSL 0.9.7d (a2t v. 1.4.0+) with mod_ssl 2.0.48 (a2t v. 1.2.2+) and SSLCert 1.0 (a2t v. 1.1.4+)

 

These OpenSSL binaries were built for distribution from the U.S. without support for the patented encryption methods IDEA, MDC-2 or RC5.

 

Usage:

 

DefaultLocation: %InstallDir%\opssl\bin

Documentation: http://www.openssl.org/docs/

 

To make certificates:

OpenSSL genrsa -out privkey.pem 2048

openssl req -new -x509 -key privkey.pem -out certificate.crt -days 1095 -config C:\apache2triad\opssl\bin\openssl.cnf

 

To test certificates:

openssl asn1parse -in certificate.crt -inform pem

 

To read certificates:

openssl crl -noout -text -in <name>.crl

openssl x509 -noout -text -in <name>.crt

openssl req -noout -text -in <name>.csr

openssl rsa -noout -text -in <name>.key

openssl dsaparam -noout -text -in <name>.prm

 

To install certificates:

Replace /cert/privkey.pem and /cert/certificate.crt with your new ones

 

It has been bundled with: SSLCert 1.0

Besides the files in this folder it uses:  %InstallDir%\opssl\conf\ssl.conf

Configuration file is at: %InstallDir%\opssl\bin\openssl.cnf

 

 

Apache Add-ons

 

php 5.0.3 (a2t v. 1.5.0)

http://www.php.net/

 

Default Location: %InstallDir%\php

Documentation: http://www.php.net/docs.php

 

This is apache2triad PHP version 5.0.3 readme file

It has been bundled with :
Pear
Smarty 2.6.3
Zend Optimizer 2.5.7
dbg 2.11.30
Xdebug 2.0.0beta1 (a2t v. 1.5.0)

Configuration file is :
%windir%/php.ini

 

 

MySql 4.0.23 (a2t v. 1.5.0)

http://www.mysql.com/

 

Default Location: %InstallDir%\MySql

Documentation: http://dev.mysql.com/doc/

 

This is apache2triad MySql version 4.0.23 readme file


It has been bundled with :
MyODBC 3.51
winMYSQLadmin 1.4

Besides the files in this folder it uses:
%windir%/odbc.ini
%windir%/my.ini

Configuration file is :
%windir%/my.ini


 

Xmail 1.20 (a2t v. 1.3)

http://xmailserver.org/

 

Default Location: %InstallDir%\mail

Documentation %InstallDir%\mail\manual\readme.html

 

This is apache2triad Xmail 1.20 readme file

 

Usage: do read ALL the Xmail manual

 

Tab files format is: ""tab"" <carriage return>

 

Apache2triad Xmail comes with a default admin@localhost working account and a localhost domain. Default password is triadpass... It is found encrypted in the files generally in the second row after username. If you use the change domain script, these files will be updated accordingly, same for the admin mailbox.

 

Xmail administration accounts are in file ctrlaccounts.tab

Allowed administration ipís are in ctrl.ipmap.tab

Administration logins are made to the 'controller server' that runs with Xmail and waits for TCP/IP connections on port 6017

 

All domains must have line in domains.tab and dir under domains\ with its name. All users must have line in mailusers.tab and dir domains\domainaname\...

 

To make password for mailusers.tab do "xmcrypt password > tempfile.txt" and paste the contents of tempfile.txt in the password space in mailusers.tab

 

The relay access is restricted in smtprelay.tab

To enable it for your host see the Xmail manual

 

It has been bundled with: Xmail Queue Manager 1.47

 

Configuration file is: %InstallDir%\mail\server.tab

 

You can configure all of Xmail by accessing http://localhost/phpxmail/. Please understand phpxmail uses user root and pass NOT admin, admin is just a mailbox for Xmail and has nothing to do with phpxmail. You typically will add/delete users from phpxmail as it makes it much easier.

 

YOU MUST READ AND UNDERSTAND  ABOUT  THE XMAIL SERVER, AS IT CAN BE ABUSED BY SPAMMERS RESULTING IN BLACKLISTING OF YOUR SERVER.

 

 

Slimftpd 3.16 (a2t v. 1.5.0)

http://www.whitsoftdev.com/slimftpd/

 

(this is the readme from the SlimFTPd folder, is says ver. 3.15, but it is actually 3.16)

 

SlimFTPd 3.15 for Win98,WinME,WinNT 4.x,WinXP,Windows2000
 

SlimFTPd is a fully multi-threaded standards-compliant FTP server that runs as a system service on Windows 98/ME or Windows NT/2K/XP. Once started, SlimFTPd runs quietly in the background. It reads its configuration from a config file in the same folder as the executable, and it outputs all activity to a log file in the same place. Its virtual file system allows you to mount any local drive or path to any virtual path on the server.</Char_Desc_450>

SlimFTPd is a fully standards-compliant FTP server implementation with an advanced virtual file system. It is extremely small, but don't let its file size deceive you: SlimFTPd packs a lot of bang for the kilobyte. It is written in pure Win32 C++ with no external dependencies and no messy installer. SlimFTPd is a fully multi-threaded application that runs as a system service on Windows 98/ME or Windows NT/2K/XP, and it comes with a tool to simplify its installation or un-installation as a system service. Once the service is started, SlimFTPd runs quietly in the background.

It reads its configuration from a config file in the same folder as the executable, and it outputs all activity to a log file in the same place. The virtual file system allows you to mount any local drive or path to any virtual path on the server.

This allows you to have multiple local drives represented on the server's virtual file system or just different folders from the same drive. SlimFTPd allows you to set individual permissions for server paths. Open slimftpd.conf in your favorite text editor to set up SlimFTPd's configuration. The format of SlimFTPd's config file is similar to Apache Web Server's for those familiar with Apache. Supports passive mode transfers and allows resume of failed transfers.

Small memory footprint; won't hog system resources. Easy configuration of server options through configuration file. All activity logged to file. Support for binding to a specific interface in multihomed environments. User definable timeouts. No installation routine; won't take over your system. Executable is tiny!

Supports all standard FTP commands: ABOR, APPE, CDUP/XCUP, CWD/XCWD, DELE, HELP, LIST, MKD/XMKD, NOOP, PASS, PASV, PORT, PWD/XPWD, QUIT, REIN, RETR, RMD/XRMD, RNFR/RNTO, STAT, STOR, SYST, TYPE, USER. Supports these extended FTP commands: MDTM, NLST, REST, SIZE. Supports setting of file timestamps. Conforms to RFC 959 and RFC 1123 standards.

 

 

 

Scripts

 

phpxmail 0.70 (a2t v. 1.4.0+)

http://phpxmail.sourceforge.net/

 

DefaultLocation: http://localhost/phpxmail

Documentation: None Yet

 

This is apache2triad PHPXMail 0.69 readme file

 

Usage: This is an Xmail server script to add/delete users, change domains, ect. Just open this directory in your browser. You can configure all of Xmail by accessing http://localhost/phpxmail/. Please understand phpxmail uses user root and pass NOT admin, admin is just a mailbox for Xmail and has nothing to do with phpxmail. You typically will add/delete users from phpxmail as it makes it much easier.

 

Configuration file is: %DocRoot%\phpxmail\config.php

 

 

AWStats 6.1 (a2t v. 1.2.2+)

http://awstats.sourceforge.net/

 

Default Location: %DocRoot%\AWStats

Documentation: http://localhost/awstats/docs/index.html

 

This is apache2triad AWStats version 6.1 readme file

 

Usage: Create and configure: awstats.yourhost.conf (yourhost=www.domain.com; domain.com you need to create for each one you plan on accessing from). To update click the text named Update Now in the upper top section.

 

Configuration file is: %DocRoot%/awstats/awstats.yourhost.conf

 

 

phpMyAdmin 2.6.0-pl3 (a2t v. 1.5.0)

http://www.phpmyadmin.net/home_page/

 

Default Location: %DocRoot%\phpMyAdmin

Documentation: http://localhost/phpmyadmin/documentation.html

 

This is apache2triad PhpMyAdmin version 2.6.0 pl3 readme file

Usage:
Just open this directory in your browser.

Configuartion file is :
config.inc.php

 

Top



ICON LEGEND

Info

Manual

Test

Details
Help

Configuration (graphicall)

Configuration (textonly)

Warning

Notice
OK


Top

Page Contribuited by Andy Carmony
Apache2Triad Net by Vlad Alexa Mancini
Programming by NextCode Graphics by NextDesign