Tenon Intersystems Please see text links at bottom of page for navigation Please see text links at bottom of page for navigation
Please see text links at bottom of page for navigation Please see text links at bottom of page for navigation
Please see text links at bottom of page for navigation
Search this site:

Program name: iTools 6
1. Installing, Upgrading, or Removing
1.1. Installation
How do I install iTools 6 for OS X?
You can find detailed instructions for this on our website in pdf format:


1.2. Uninstalling
How do I uninstall iTools?
We have detailed instructions for this listed on our website:


1.3. Updating to 6.5
How do I update to iTools 6.5.x?
iTools 6.5 is a free update and install that is available from the iTools product page. You will not need to un-install previous versions of 6.x to install 6.5. All of your configuration will be saved properly.

1.4. Updating Licence Number
How do I update my license number?
Simply run the Post.Office application that you ran when you first installed Post.Office. It is located in your Applications folder by default.

Enter your new licence number in the designated field and click "Save".

You will not need to restart your server. Your new account/list limit should be immediately available in the web administrration interface.

2. Communications and Networking
no entries
3. Administration
3.1. Logging into the Administration Server
Why do I have to log in twice to the iTools Administration Server?
There are two ways to start the Admin server. The first is by using the iTools "front-end" application to turn it on from the Admin menu. If it is enabled there, you only need to log in once in the browser to authenticate yourself as having admin access.

If you have not started the admin server from the iTools, the first password challenge is for permission to turn on the admin server.

Accessing the URL "http://yourhostname/itools_admin" can start up the admin server, as well as serve the admin home page for configuring iTools.

The first challenge is from Apache/iTools, and the second challenge is from the iTools/Admin Server itself. Web browsers will remember the username/password combination for that session, and you will not be asked to authenticate yourself until you quit and restart the browser.

3.2. VirtualHost IP address conflicts
I accidently added a VirtualHost that resolves to another machine's IP address. What do I do to fix the conflict?
Simply delete the offending VirtualHost in the iTools admin server. iTools will automatically take down the offending IP address and VirtualHost. The DNS should then be fixed to point to the correct IP and the VirtualHost can be added again. DO NOT just delete the record from the apache.conf file. If you do, the IP address will continue to cause a conflict.

3.3. "DNS Mismatch" error
Why do I get "DNS Mismatch" for some of my virtual hosts in the Admin Server?
The Admin Server prints the error "DNS Mismatch" for virtual hosts when the IP address of a VirtualHost has changed. The solution is to either delete and re-add the virtual host, fix the DNS, or edit the IP Address in the httpd.conf file.

3.4. Connecting to the admin server via SSL
How do I connect to the ssl based secure admin interface?
To connect to the admin server over SSL, you will either need a certificate and Key for your server. If you already have an SSL enabled VirtualHost, the iTools admin server will use the certificate you already have. If you do not have an SSL virtual host, generate a key and certificate using the instructions in the iTools user guide.

Onnce you have a certificate and key, simply connect to the admin server on port 85 like this:


4. Advanced Setup
4.1. Configuring WebDAV
How do I set up WebDAV under iTools?

First, you will want to protect the folder you will be accessing using DAV with some sort of Access Control. Do this in the Admin Server by selecting the Folder Contents button of the VirtualHost you wish to add WebDAV support to. Set up a realm based or IP based restriction for the folder.

Next you will need to add some configuration to the httpd.conf file using a text editor such as vi or BBEdit. Add the line:


To the container at the bottom of the httpd.conf file which configures the realm you just added.

Finally, Add the line:

DavLockDB /etc/httpd/DavLock

to the very end of the file.

Restart apache using the iTools application or the Admin Server and you should be all set.

If you only want DAV functions to be protected by the realm (all other users can access using a web browser), enclose the "Require" directive in a Limit container like in this example:

<Directory /Library/WebServer/WebSites/www.tenon.com>
Require user dav-user

Make sure that the Limit container is all one line. This will limit WebDAV functions to the iTools user "dav-user".

5. Backup, Restore configuration
no entries
6. DNS
no entries
7. FTP
no entries
8. Mail
8.1. Open Relay
I have been told that my iTools server is an "open-relay". How do I fix it?
iTools is NOT an open relay by default. In the mail settings there is a relay-domains section that will configure what domains can relay. It should be empty. If it is not, please remove the entries
that are causing the problem.

If you are running FormMail (a cgi for sending mail), make sure you are running the latest version. Previous versions contained a security hole that allowed relaying. This is not a Tenon product though and is not a part of iTools.

9. Security
no entries