emailAdmin

The emailAdmin is a Java-based application that provides regular mail users administrator-level access to configuration of their mail accounts. With it, users can:

• modify their email password
• edit, enable, and schedule their own autoresponders
• set up email forwarding for their mail box

The site administrator can still perform these functions via the account's web-based control panel--netConsole, however, the emailAdmin provides a "lite" version of the netConsole where individual users can make modifications only affecting their own email account without requiring site administrator access or intervention.

Resellers: If you're providing branded version of Internet Connection's products to your clients, the emailAdmin is also available in a branded version for your clients.

Accessing the emailAdmin

In general, the emailAdmin can be accessed by two means, locally via a Java JAR file and remotely through your web browser. Because the emailAdmin client is written in Java you will need Java installed on your local machine. Java can be downloaded from http://java.sun.com/getjava/

How you access the emailAdmin or choose to allow your mail users to access the emailAdmin depends solely on your situation.

For example, LAN administrators may want to deploy applications to their users' desktops using a shared file service, or some auto-install features. For them, downloading the JAR is a wonderful timesaver.

If you have a very fast connection, you may want to deploy via the web. Doing so allows you to easily take advantage of updates to the emailAdmin. In this situation, running the JAR locally is not the best option.

The last example again depends on internet connection speed. Some people have slow connections, but better control over their firewall. Using the JAR file means that they don't have to "download" the emailAdmin into their JVM every time they use it on a new machine in their network. We hope these examples give you some more insight on how to access/deploy the emailAdmin in your situation.

Accessing emailAdmin Through a Web Browser

The first method for accessing the emailAdmin is through a web browser. First, install the emailAdmin through the Package Installer section of your netConsole. During this process you'll be asked for the directory you'd like the emailAdmin to be installed into. It's recommend that you do not install this in a directory that already exists. If you do so, the index.html that's installed with the emailAdmin will overwrite any existing index.html file.

Once the emailAdmin package is installed it can be accessed by going to http://YOUR-DOMAIN-NAME/DIR-NAME/

Note: Customers utilizing our Windows hosting accounts must first upload the JAR and an index.html to their hosting account to access the emailAdmin via the web browser. Please refer to the readme.txt file inside the emailAdminWIN.zip

Accessing emailAdmin Locally

The second method for accessing emailAdmin requires users to download a Java JAR file. The JAR can be downloaded below.

Once emailAdmin.jar has been downloaded, most users can double-click on it to begin using it. However, if your computer is configured to associate JAR files with another program besides Java, you may have to either change this association or execute the JAR from the Command Prompt.

Accessing emailAdmin Locally from the Command Prompt

As discussed above, emailAdmin.jar can be launched from the command prompt. Using the command prompt, the user actually has a few more configuration options:

C:\>java.exe -jar emailAdmin.jar --help 
Usage: emailAdmin [options] username [command args....] -P PASSWORD     
use PASSWORD as the password or use - to
read from standard input
-p FILE         read password from FILE
-i IP           use specified IP address
-d DOMAIN       use DOMAIN as the domain name
-u USERNAME     use USERNAME and stop command line processing
-x PROTOCOL     force usage of PROTOCOL
PROTOCOL can currently be 'fast' or 'http'
-h, --help      show this help dialog

For example, to access the emailAdmin without being prompted for you domain name, user name and password you would use this command:

C:\>java.exe -jar emailAdmin.jar -P PASSWORD -d DOMAIN-NAME USER

Download emailAdmin

• emailAdmin.jar - 125k
• emailAdminWIN.zip with index.html - 112k
  For customers utilizing Windows hosting accounts wishing to access the emailAdmin via web browser.

Using the emailAdmin

The emailAdmin consists of three panels: Autoresponder, Password and Forward.

	Autoresponder In the Autoresponder panel you can enable/disable autoresponders. You are also able to schedule autoresponders start/stop times for vacations etc. This works seamlessly with the autoresponder function on the netConsole.
	Password The Password panel allows mail users to change their passwords. Simply provide your current password, the new password and the new password again.
	Forward This panel allows a user to have a regular mailbox also forward mail. This simply means that when an address receives an email, it will keep a copy of it like a regular mailbox would, but it also forwards mail to the addresses specified.

Accessing emailAdmin Locally

The first method for accessing emailAdmin requires users to download a Java JAR file. The JAR can be downloaded below.

Once emailAdmin.jar has been downloaded, most users can double-click on it to begin using it. However, if your computer is configured to associate JAR files with another program besides Java, you may have to either change this association or execute the JAR from the Command Prompt.

Accessing emailAdmin Locally from the Command Prompt

As discussed above, emailAdmin.jar can be launched from the command prompt. Using the command prompt, the user actually has a few more configuration options:

C:\>java.exe -jar emailAdmin.jar --help
Usage: emailAdmin [options] username [command args....]
-P PASSWORD     use PASSWORD as the password or use - to
read from standard input
-p FILE         read password from FILE
-i IP           use specified IP address
-d DOMAIN       use DOMAIN as the domain name
-u USERNAME     use USERNAME and stop command line processing
-x PROTOCOL     force usage of PROTOCOL
PROTOCOL can currently be 'fast' or 'http'
-h, --help      show this help dialog

For example, to access the emailAdmin without being prompted for you domain name, user name and password you would use this command:

C:\>java.exe -jar emailAdmin.jar -P PASSWORD -d DOMAIN-NAME USER

Control of Mail Aliases

Not only does the emailAdmin allow you to manipulate your email boxes (accounts that are accessed via POP3 or IMAP) but also provides you with control over any email aliases for which your email box is the sole destination. Control over email aliases is limited to manipulating autoresponder functions. This is because email aliases do not have passwords (they aren't "checked", they forward email).

What emailAdmin Does Not Do

emailAdmin provides many helpful features to mail users but it does not replace the netConsole for complete administration of email accounts. The following tasks cannot be performed by the emailAdmin. Instead, these tasks must be performed through the netConsole.

• creation/deletion of email boxes
• creation/deletion of email aliases/forwarding accounts
• modification of destination addresses for email alias/forwarding accounts

A Note About Firewalls

The emailAdmin will function through most firewalls. If possible, it will communicate over it's own internal protocol (using port 1038), but if it cannot make a connection, it will fall back on an RPC that uses normal HTTP requests to perform it's functionality. The RPC is slower, but because it can use your web-browsing proxy preferences, it will work with nearly every networking environment. In general, if you can reach your website, you can probably use the emailAdmin from that same location.