Version 1.2 Of The ISPConfig 3 Manual (Date: 05/04/2011) Available

The good news first: the updated ISPConfig 3 Manual (version 1.2 for ISPConfig 3.0.3.3) is finally available (in PDF format).

On 308 pages, it covers the concept behind ISPConfig (admin, resellers, clients), explains how to install and update ISPConfig 3, includes a reference for all forms and form fields in ISPConfig together with examples of valid inputs, and provides tutorials for the most common tasks in ISPConfig 3. It also lines out how to make your server more secure and comes with a troubleshooting section at the end.

Version 1.2 for ISPConfig 3.0.3.3 (Date: 05/04/2011)
Author: Falko Timme
308 pages

Now the bad news: we can't offer it for free. But it will be available for as low as 5 EUR per copy - we think this price is more than fair for a manual with more than 300 pages.

Download Through Your HowtoForge Subscription (A HowtoForge subscription costs 5 EUR for one month or 25 EUR for six months.)(A single copy costs 5 EUR; you will receive an email with a download link that is active for ten days. Please note that this option does not include any updates!)Added internal links to the manual.Added chapter 5.25 "How Can I Access SquirrelMail From My Web Sites?"Added description (+ new screenshot) for the "Monitor keyword" field in chapter 4.9.2.4 Interface Config (Misc tab).Added QR code for making it easy to install the ISPConfig Monitor App for Android.Do not delete the /var/www/ispconfig symlink when switching the ISPConfig interface to php-fcgi.Fixed typo in chapter 5.18.

 We don't want to bore you with long explanations, so here are the facts:

We hope that this will allow us to employ an additional full-time ISPConfig developer who can disburden the core team. This would accelerate ISPConfig development a lot and also allow us to provide more support for ISPConfig users.

Yes.

You can download it either through an active HowtoForge subscription, or you can buy a single copy.

Downloading through a HowtoForge subscription has the advantage that you get updates of the manual for free as long as you are a subscriber, while if you buy a single copy, no updates are included (i.e., you would have to pay again for new versions of the manual).

A HowtoForge subscription costs 5 EUR for one month or 25 EUR for six months.

If you want to download a single copy of the ISPConfig 3 manual, this costs you 5 EUR which is equal to buying a one-month HowtoForge subscription.

Download Through Your HowtoForge Subscription (A HowtoForge subscription costs 5 EUR for one month or 25 EUR for six months.)(A single copy costs 5 EUR; you will receive an email with a download link that is active for ten days. Please note that this option does not include any updates!)

The ISPConfig 3 manual is protected by copyright. No part of the manual may be reproduced, adapted, translated, or made available to a third party in any form by any process (electronic or otherwise) without the written specific consent of projektfarm GmbH. You may keep backup copies of the manual in digital or printed form for your personal use. All rights reserved.

This means it is not allowed to redistribute the ISPConfig 3 manual in any form (for example by offering it as a download on your web site). Your copy of the ISPConfig 3 manual will be personalized with your real name (or HowtoForge username) and email address.

If you are an ISP and need multiple copies (e.g. for your clients), please contact us (info@projektfarm.de), and we will find a solution.

1 Conventions Used In This Manual
1.1 Commands
1.2 Contents Of Files
1.3 File Names, Protocol Names, System Specifications, Technical Specifications, User Names, Etc.
1.4 Highlighting

2 ISPConfig Users - Admin, Resellers, And Clients
2.1 Summary
2.1.1 admin
2.1.2 Resellers
2.1.3 Clients

3 Installation & Updating
3.1 Single Server Setup
3.2 Multiserver Setup
3.2.1 Installing A Multiserver Setup With Dedicated Web, Email, DNS And MySQL Database Servers On Debian 5.0 With ISPConfig 3
3.2.1.1 Installing The Five Debian Base Systems
3.2.1.2 Installing The Web Server
3.2.1.3 Installing The Mail Server
3.2.1.4 Installing The MySQL Database Server
3.2.1.5 Installing The Primary DNS Server
3.2.1.6 Installing The Secondary DNS Server
3.2.1.7 Adjust The Server Settings In ISPConfig

  3.3 Mirror Setup
3.3.1 Installing A Web, Email And MySQL Database Cluster On Debian 5.0 With ISPConfig 3
3.3.1.1 Setting Up The Two Base Systems
3.3.1.2 Installing The Two Servers
3.3.1.3 Installing ISPConfig On The First (Master) Server
3.3.1.4 Installing ISPConfig 3 On The Second Server
3.3.1.5 Configure Replication In ISPConfig
3.3.1.6 Additional Notes

  3.4 Updating
3.4.1 Creating A Backup
3.4.2 Command Line Update

4 Reference
4.1 Tabs
4.2 Login
4.3 Home
4.4 Tools
4.4.1 User Settings
4.4.1.1 Password and Language

  4.5 Client
4.5.1 Clients
4.5.1.1 Add Client
4.5.1.2 Edit Client
4.5.1.3 Edit Client-Templates
4.5.2 Resellers
4.5.2.1 Add Reseller
4.5.2.2 Edit Reseller

  4.6 Sites
4.6.1 Websites
4.6.1.1 Website
4.6.1.2 Subdomain for website
4.6.1.3 Aliasdomain for website
4.6.2 FTP
4.6.2.1 FTP-User
4.6.3 Shell
4.6.3.1 Shell-User
4.6.4 WebDAV
4.6.4.1 WebDAV User
4.6.5 Database
4.6.5.1 Database
4.6.6 Cron
4.6.6.1 Cron Jobs
4.6.7 Statistics
4.6.7.1 Web traffic
4.6.7.2 Website quota (Harddisk)

  4.7 Email
4.7.1 Email Accounts
4.7.1.1 Domain
4.7.1.2 Domain Alias
4.7.1.3 Email Mailbox
4.7.1.4 Email Alias
4.7.1.5 Email Forward
4.7.1.6 Email Catchall
4.7.1.7 Email Routing
4.7.2 Spamfilter
4.7.2.1 Whitelist
4.7.2.2 Blacklist
4.7.2.3 User / Domain
4.7.2.4 Policy
4.7.3 Fetchmail
4.7.3.1 Fetchmail
4.7.4 Statistics
4.7.4.1 Mailbox traffic
4.7.5 Global Filters
4.7.5.1 Postfix Whitelist
4.7.5.2 Postfix Blacklist
4.7.5.3 Content Filter
4.7.5.4 Relay Recipients

  4.8 DNS
4.8.1 DNS Wizard
4.8.1.1 Add DNS Zone
4.8.1.2 Templates
4.8.2 DNS
4.8.2.1 Zones
4.8.3 Secondary DNS
4.8.3.1 Secondary Zones

  4.9 System
4.9.1 CP Users
4.9.1.1 Add user
4.9.1.2 Edit user
4.9.2 System
4.9.2.1 Server Services
4.9.2.2 Server Config
4.9.2.3 Server IP addresses
4.9.2.4 Interface Config
4.9.3 Firewall
4.9.3.1 Firewall
4.9.4 Software
4.9.4.1 Repositories
4.9.4.2 Packages
4.9.4.3 Updates
4.9.5 Language Editor
4.9.5.1 Languages
4.9.5.2 New Language
4.9.5.3 Merge
4.9.5.4 Export
4.9.5.5 Import
4.9.6 Remote Users
4.9.6.1 Add user
4.9.6.2 Edit user
4.9.7 Remote Actions
4.9.7.1 Do OS-Update
4.9.7.2 Do ISPConfig-Update

  4.10 Monitor
4.10.1 System State (All Servers)
4.10.1.1 Show Overview
4.10.1.2 Show System-Log
4.10.1.3 Show Jobqueue
4.10.2 Server to Monitor
4.10.3 Hardware Information
4.10.3.1 Show CPU Info
4.10.4 Server State
4.10.4.1 Show Overview
4.10.4.2 Show Update State
4.10.4.3 Show RAID State
4.10.4.4 Show Server Load
4.10.4.5 Show Disk Usage
4.10.4.6 Show Memory Usage
4.10.4.7 Show Services
4.10.4.8 Show OpenVz VE BeanCounter
4.10.5 Logfiles
4.10.5.1 Show Mail Queue
4.10.5.2 Show Mail Log
4.10.5.3 Show Mail Warn-Log
4.10.5.4 Show Mail Error-Log
4.10.5.5 Show System-Log
4.10.5.6 Show ISPC Cron-Log
4.10.5.7 Show Freshclam-Log
4.10.5.8 Show Clamav-Log
4.10.5.9 Show RKHunter-Log
4.10.5.10 Show fail2ban-Log

  4.11 Help
4.11.1 Support
4.11.1.1 Send message
4.11.1.2 View messages
4.11.2 About ISPConfig
4.11.2.1 Version

  4.12 Domains
4.12.1 Domains
4.12.1.1 Domains

5 Howtos
5.1 How Do I Create A Reseller?
5.2 How Do I Create A Client?
5.3 How Do I Create A Web Site?
5.4 How Do I Create An SSL Web Site?
5.4.1 How Do I Import An Existing SSL Certificate Into A Web Site That Was Created Later In ISPConfig?
5.5 How Do I Redirect My Web Site To Another Web Site Or To A Specific Directory On The Server?
5.6 How Do I Create An FTP Account So That I Can Upload Files To My Web Site?
5.7 How Can I Use Perl/CGI Scripts With My Web Site?
5.8 How Do I Create An Email Account?
5.9 How Do I Activate The Spamfilter/Virus Scanner For An Email Account?
5.10 How Do I Blacklist/Whitelist Email Addresses In The Spamfilter?
5.11 How Do I Fetch Emails From A Remote Server With ISPConfig And Put The Emails In A Local Email Account?
5.12 How Do I Create A DNS Zone?
5.13 How Do I Create A Secondary DNS Zone?
5.14 How Do I Create A Mirror?
5.15 How Do I Split Up Services Between Multiple Servers?
5.16 How Do I Unblock An IP Address That Got Blocked By fail2ban?
5.17 How Do I Create A Subdomain And Redirect It To A Different Folder/Web Site?
5.18 How Do I Manually Configure New IP Addresses On My System?
5.19 How To Build A PureFTPd Debian Package For OpenVZ Virtual Machines (Without Capabilities Enabled)
5.20 How To Display Hidden Files With PureFTPd On Debian And Ubuntu Linux
5.21 PureFTPd Does Not Show More Than 2,000 Files On Debian And Ubuntu
5.22 How To Speed Up Logins In PureFTPd On Debian Or Ubuntu Linux By Disabling Name Resolving
5.23 How To Enable Verbose Logging In PureFTPd On Debian And Ubuntu Linux
5.24 How To Enable FTPS For PureFTPd On Debian And Ubuntu Linux
5.25 How Can I Access SquirrelMail From My Web Sites?

6 Security Considerations
6.1 How Do I Disable Certain PHP Functions?
6.2 Enabling SSL For The ISPConfig Web Interface
6.3 Using SuExec For The ISPConfig Web Interface
6.4 What Are Secure Settings For Web Sites Created Through ISPConfig?
6.5 How Do I Make fail2ban Monitor Additional Services?
6.5.1 PureFTPd
6.5.2 SASL
6.5.3 Courier
6.5.4 Dovecot

7 Troubleshooting
7.1 How Do I Find Out What Is Wrong If ISPConfig Does Not Work?

 

View the original article here

How To Create Remote API Scripts For ISPConfig 3

This guide will walk through the instructions on how to create an API script to create an ftp user in ISPConfig 3. It will give you the knowledge to develop scripts for any function available in ISPConfig 3.

So let's look at the script we will be analyzing.

The first place you start when creating an API script is at the function. The function is the part of the code that adds the ftp user to the databases.

$domain_id = $client->sites_ftp_user_add($session_id, $client_id, $params_ftp);

As you can see from the code above site_ftp_user_add is the function to add an ftp user. All the functions have names like this so you will never wonder what it does. In order to find out all functions that are available you need to look at /usr/local/ispconfig/interface/lib/classes/remoting.inc.php.

It will look like this:

?//* Add a recordpublic function sites_ftp_user_add($session_id, $client_id, $params) {if(!$this->checkPerm($session_id, 'sites_ftp_user_add')) {$this->server->fault('permission_denied', 'You do not have the permissions to access this function.');return false;}return $this->insertQuery('../sites/form/ftp_user.tform.php',$client_id,$params);}

Alright so we know from the line that says,

public function sites_ftp_user_add($session_id…

that there is a function called sites_ftp_user_add.

Let's look at the entire line where the function will reside in our new script.

$domain_id = $client->sites_ftp_user_add($session_id, $client_id, $params_ftp);

Let's break this line down so you know what you need to change to adjust this to any function.

$domain_id = $client->sites_ftp_user_add($session_id, $client_id, $params_ftp);

The $domain_id is a variable that you will not need to change as the variable is not used in the execution of the function. 

$domain_id = $client->sites_ftp_user_add($session_id, $client_id, $params_ftp);

$client-> is a variable you should never change, so do not mess with it.

$domain_id = $client->sites_ftp_user_add($session_id, $client_id, $params_ftp);

As stated above this is the function and will change depending on the task you wish the script to do.

$domain_id = $client->sites_ftp_user_add($session_id, $client_id, $params_ftp);

This section can change depending on the function. From the /usr/local/ispconfig/interface/lib/classes/remoting.inc.php you will see the line

public function sites_ftp_user_add($session_id, $client_id, $params)

This is where you will get what needs to go after the function.

Above the function line you will see the creation of the function's array. This is where the information that will be used to create the ftp user is given.

$params = array( 'server_id'=> '1','parent_domain_id'=> $domain_id,'username'=> $myusername,'password'=> $mypassword,'quota_size'=> '-1','active'=> 'y','uid'=> 'web'.$domain_id,'gid'=> 'client'.$client_id,'dir'=> '/var/www/clients/client'.$client_id.'/web'.$domain_id,'quota_files'=> '100','ul_ratio'=> '-1','dl_ratio'=> '200','ul_bandwidth'=> '-1','dl_bandwidth'=> '100',);

This will always start with

$variable = array (

but we do not know what information we need to type in with every function without looking it up.

Going back to /usr/local/ispconfig/interface/lib/classes/remoting.inc.php you will look up the function being used:

?//* Add a recordpublic function sites_ftp_user_add($session_id, $client_id, $params) {if(!$this->checkPerm($session_id, 'sites_ftp_user_add')) {$this->server->fault('permission_denied', 'You do not have the permissions to access this function.');return false;}return $this->insertQuery('../sites/form/ftp_user.tform.php',$client_id,$params);}

This is telling up what file has the array information needed. Now let's use our find command:

sudo find / -name ftp_user.tform.php

And open up the document. Should look like:

'password' => array ('datatype'=> 'VARCHAR','formtype'=> 'PASSWORD','encryption' => 'CRYPT','default'=> '','value'=> '','width'=> '30','maxlength'=> '255'),'quota_size' => array ('datatype'=> 'INTEGER','formtype'=> 'TEXT','validators'=> array ( 0 => array ('type'=> 'NOTEMPTY','errmsg'=> 'quota_size_error_empty'),1 => array ('type'=> 'REGEX','regex' => '/^(\-1|[0-9]{1,10})$/','errmsg'=> 'quota_size_error_regex'),

As you can see I am showing two examples that would be transformed to

'password' => 'yourpassword'

and

'quota_size' => 'quota size'

Using everything we have learned so far we can create:

$params = array( 'server_id'=> '1','parent_domain_id'=> $domain_id,'username'=> $myusername,'password'=> $mypassword,'quota_size'=> '-1','active'=> 'y','uid'=> 'web'.$domain_id,'gid'=> 'client'.$client_id,'dir'=> '/var/www/clients/client'.$client_id.'/web'.$domain_id,'quota_files'=> '100','ul_ratio'=> '-1','dl_ratio'=> '200','ul_bandwidth'=> '-1','dl_bandwidth'=> '100',);$domain_id = $client->sites_ftp_user_add($session_id, $client_id, $params);

Not too much farther to go. All we need to do now is have our shell user log in and log out. Make sure you have created a shell user in ISPConfig Control panel by going to the Sites tab and then click Shell User on the left.

Here is the beginning of the script to log into Soap.

$username = 'yourusername';$password = 'yourpassword';/*$soap_location = 'http://localhost:8080/ispconfig3/interface/web/remote/index.php';$soap_uri = 'http://localhost:8080/ispconfig3/interface/web/remote/';*/$soap_location = 'http://localhost:8080/remote/index.php';$soap_uri = 'http://localhost:8080/remote/';

You should put your Shell User where it says "yourusername", and ?the password in "yourpassword." You should also put in your soap?location and uri, but more than likely you will not have to change this.

$client = new SoapClient(null, array('location' => $soap_location, 'uri' => $soap_uri));try { //* Login to the remote server if($session_id = $client->login($username,$password)) { echo 'Logged into remote serversucessfully. The SessionID is '.$session_id.'
';

No changes are needed to this section unless you want to change

echo 'Logged into remote server sucessfully. The SessionID is '.$session_id.'
';

to ouput a different message.

End the script with the following to log out. Nothing has to be changed in the last section.

//* Logoutif($client->logout($session_id)) {echo "FTP Created";}} catch (SoapFault $e) {die('SOAP Error: '.$e->getMessage());echo "Please contact the server administator";}?>;

View the original article here

ISPConfig Monitor App For Android

The ISPConfig Monitor App is for all servers, not only for servers running ISPConfig. With the ISPConfig Monitor App, you can check your server status and find out if all services are running as expected. You can check TCP and UDP ports and ping your servers. In addition to that you can use this app to request details from servers that have ISPConfig installed (please note that the minimum installed ISPConfig 3 version with support for the ISPConfig Monitor App is 3.0.3.3!); these details include everything you know from the Monitor module in the ISPConfig Control Panel (e.g. services, mail and system logs, mail queue, CPU and memory info, disk usage, quota, OS details, RKHunter log, etc.), and of course, as ISPConfig is multiserver-capable, you can check all servers that are controlled from your ISPConfig master server.

View the original article here

The Perfect Server - CentOS 5.6 x86_64 [ISPConfig 2]

This tutorial shows how to set up a CentOS 5.6 server (x86_64) that offers all services needed by ISPs and web hosters: Apache web server (SSL-capable), Postfix mail server with SMTP-AUTH and TLS, BIND DNS server, Proftpd FTP server, MySQL server, Dovecot POP3/IMAP, Quota, Firewall, etc. This tutorial is written for the 64-bit version of CentOS 5.6, but should apply to the 32-bit version with very little modifications as well. In the end you should have a system that works reliably, and if you like you can install the free webhosting control panel ISPConfig 2 (i.e., ISPConfig runs on it out of the box).

I will use the following software:

Web Server: Apache 2.2 with PHP 5.1.6 Database Server: MySQL 5.0 Mail Server: PostfixDNS Server: BIND9 (chrooted) FTP Server: ProftpdPOP3/IMAP server: DovecotWebalizer for web site statistics

Please note that this setup does not work for ISPConfig 3! It is valid for ISPConfig 2 only!

I want to say first that this is not the only way of setting up such a system. There are many ways of achieving this goal but this is the way I take. I do not issue any guarantee that this will work for you!

To install such a system you will need the following:

In this tutorial I use the hostname server1.example.com with the IP address 192.168.0.100 and the gateway 192.168.0.1. These settings might differ for you, so you have to replace them where appropriate.

Boot from your first CentOS 5.6 CD (CD 1) or the first CentOS 5.6 DVD. Press at the boot prompt:

 It can take a long time to test the installation media so we skip this test here:

 

The welcome screen of the CentOS installer appears. Click on Next:

 

Choose your language next:

 Select your keyboard layout:

 I'm installing CentOS 5.6 on a fresh system, so I answer Yes to the question Would you like to initialize this drive, erasing ALL DATA?

 Now we must select a partitioning scheme for our installation. For simplicity's sake I select Remove linux partitions on selected drives and create default layout. This will result in a small /boot and a large / partition as well as a swap partition. Of course, you're free to partition your hard drive however you like it. Then I hit Next:

 Answer the following question (Are you sure you want to do this?) with Yes:

 On to the network settings. The default setting here is to configure the network interfaces with DHCP, but we are installing a server, so static IP addresses are not a bad idea... Click on the Edit button at the top right.

In the window that pops up uncheck Dynamic IP configuration (DHCP) and Enable IPv6 support and give your network card a static IP address (in this tutorial I'm using the IP address 192.168.0.100 for demonstration purposes) and a suitable netmask (e.g. 255.255.255.0; if you are not sure about the right values, http://www.subnetmask.info might help you):

Set the hostname manually, e.g. server1.example.com, and enter a gateway (e.g. 192.168.0.1) and up to two DNS servers (e.g. 8.8.8.8 and 145.253.2.75):  

Choose your time zone Give root a password:

 The Perfect Server - CentOS 5.6 x86_64 [ISPConfig 2] - Page 2

View the original article here

ISPConfig Monitor App For Android

The ISPConfig Monitor App is for all servers, not only for servers running ISPConfig. With the ISPConfig Monitor App, you can check your server status and find out if all services are running as expected. You can check TCP and UDP ports and ping your servers. In addition to that you can use this app to request details from servers that have ISPConfig installed (please note that the minimum installed ISPConfig 3 version with support for the ISPConfig Monitor App is 3.0.3.3!); these details include everything you know from the Monitor module in the ISPConfig Control Panel (e.g. services, mail and system logs, mail queue, CPU and memory info, disk usage, quota, OS details, RKHunter log, etc.), and of course, as ISPConfig is multiserver-capable, you can check all servers that are controlled from your ISPConfig master server.

For download and usage instructions, please visit http://www.ispconfig.org/ispconfig-3/ispconfig-monitor-app-for-android/.

View the original article here