Handy Address Book
 
    Contact
 
     Home      Tutorial      Demos      More Info      Download      Support      Purchase     

Documentation - Setup

Documentation -> Overview -> Setup

A Handy Address Book Server installs just like any Windows application.  Download the setup program from the download page, and run it on your server to complete the installation.

After installation, start A Handy Address Book Server by selecting "Start / All Programs / Handy Address Book Server / Handy Address Book Server".  If there are no port conflicts you will see the GUI appear as shown in this screen shot.

If you are running any web server (like IIS or Apache) on this same server, you will want to change the port that Handy uses, so it will not conflict with this other server.  To do this, select "Administration... / Settings..." from the GUI.  Here you can select the port, as shown in this screen shot.  A good alternative port number is 8080.  After changing the port, select the "Start Server" button.

A Handy Address Book Server comes with no pre-defined users, and permissions are set wide open, so this will probably be one of the first things you will want to set up.  See the "Installation Administration" page to define new users, and set their initial permission level for new address books.

Data Folder:
By default Handy Server stores the address book data on the server at:

C:\ProgramData\AHABS

You can change the data folder by either using a command line argument, or setting a registry value.  To change the data folder using a command line argument use the "/data" command line argument, as shown in this example:

ahabs.exe /data "C:\Data\HServer"

This example will start the Handy Server, and make the data folder C:\Data\HServer.  To change the data folder by setting a registry value, set the value of "data folder" in this key:

HKEY_LOCAL_MACHINE\SOFTWARE\Beiley Software\AHABS\Preferences

Either method will change the location of where Handy Server stores data files.  The command line argument will take precedence if both methods are used.  If you are running Handy Server as a service you must use the registry method if you wish to change the location of where data files are stored.  If you are running a 64 bit version of Windows, the registry location for this preference will be at:

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Beiley Software\AHABS\Preferences

Banned IP Addresses:
Handy Server supports banning specified IP addresses.  Banned IP addresses will not be allowed to connect to the Handy Server.  Banned IP addresses are global, and apply to all installations within Handy Server.  To ban certain IP addresses, create and edit a file called "Deny.txt" in the data folder.  Type one IP address per line into this file you wish to ban.  The * wildcard is supported.  Comments are also supported on lines beginning with the # character.  An example Deny.txt file is shown here:

# Here is a sample Deny.txt file
# Let's ban a specific IP address
1.2.3.4
# We can also ban a range of addresses by using the * wildcard
1.2.*.*