MailFaces - Installation - Version 2.1.5

Index

System Requirements

Hardware/Operating System environment.

Java Environment

In the case of Windows, the automated install process will also optionally install a version of Java for you. Otherwise, if you don't already have Java installed then go to the SUN java download site and download either the Java Runtime Environment (JRE) or (System Development Kit)SDK for your environment.

For Windows (95/98/NT/2000/XP) systems, Mac OS X, Mac OS8.1-9x and Linux, MailFaces can be installed using a automated installer. For other systems, (OS/2, Solaris, AIX, etc) a distributed zip file is used to install MailFaces manually.

If you don't know if you have Java installed, you can test if it is installed by bringing up a command window and typing: java -version or jre -version or jview.

Download and Install

• Choose an installation method.
• Download InstallAnywhere Installation file for MicroSoft Windows (Java VM included).
  This is the recommended method for most Windows users.

  Download MailFaces.exe (8000 KB)
  Open the downloaded file to complete the installation.
  Additional instructions

• Download InstallAnywhere Installation file for MicroSoft Windows (Java VM not included).
  This is the recommended method for Windows users that have already installed Java.

  Download MailFaces.exe (1900 KB)
  Open the downloaded file to complete the installation.
  Additional instructions

• Use the InstallAnyWhere Web Installer
  
This will download and install MailFaces using the InstallAnywhere automated installation process. This is the easiest way to install MailFaces and supports Windows, Linux and Mac OS X/OS8.1-9.xx. but see the note below.
For Windows systems, you can have it automatically install Java 1.3 also.
NOTE: In order to install MailFaces, the "InstallAnywhere" installer needs to have permission to the install information to you system. It will request that you "Grant" this permission. Your Web browser (InternetExplorer, Netscape, etc) will verify that the InstallAnywhere" certificate is valid so you can be assured that the program being run is valid.

Invoke Web Installer

Additional instructions

• Use the Mailfaces ZIP File
  
You can download the file and manually install MailFaces. This is the fastest method for those that are experienced with Java applications and is required for Operating System environments (such as OS2, Unix) not covered above.
• Download the ZIP file:
  mailfaces.zip (522 KB)
  After download completes, follow the installation instructions for your Operating System environment.
• Win9x/NT/2000/XP Installation
• OS/2 Installation
• Unix Installation
• Optional steps
  • Update your faces.opt file to take advantage of the optional features.
    • Cellphone Notify
    • Group Support
    • SPAM Selection

      Adding the following statement with your userid and system filled in will force 50% or more of your SPAM to be grouped under the SPAM icon.

      KillSelect not recipient "myuserid@mysystem.com"
                

  • Optional Source and JavaDoc documentation for MailFaces
    Download the ZIP file : mailfaces_src.zip (131 KB)

InstallAnywhere Install Instructions:

• When the InstallAnywhere installation is complete, invoke MailFaces.
  • Windows
  Use to the desktop icon or Start->programs->MailFaces215
  • Linux

        cd mailfaces   (or whereever it was installed)
        ./MailFaces215        
  	   

  • OS X
  Feedback needed on this!

• You will be prompted for the name of your Options file.
  You will almost always want to use the default name of faces.opt.

• You will be prompted to enter the host name, userid and password for your Mail server.
  This is the same information that you supplied to Outlook, Netscape or whatever other client you are using to read your mail.

• A MailFaces window should come up and if you have any mail waiting, one or more icons should appear. If you have no mail waiting, you should get a "NoMail" icon.
• Now you can customize your faces.opt file.
  options->Edit Optons
The comments in the distributed faces.opt file and the Options Documentation should be enough to get you going with specifications of local images for your favorite mail correspondents. Then restart MailFaces.

I hope that the installation of MailFaces went well! Please send a message to me at jthomas@cruzio.com with any comments or suggestions. I hope you will also subscribe to the MailFaces Mailing List so you can be informed of fixes and new releases.

I am keeping track of which Unix platforms MailFaces has been sucessfully installed on, so I would appreciate a note giving me the Platform and release which you used to install MailFaces. Thanks!

Windows 9x/NT/2000/XP Install Instructions:

• Make sure that you have Sun's Java 1.1 or later or MicroSoft's Internet Explorer 4.0 installed.

  If you don't know if you have Java installed, then bring up a command window and type:
  java -version or jre -version or jview
  

  • If you don't have Java installed, then you will need to download and install the Java Runtime Environment (JRE). Refer to the JRE installation for more information about installing the Java Runtime Environment on a system.
  • If you have problems with the JRE or SDK installation, see the troubleshooting guide.
  • If you have Microsoft Internet Explorer 4.0 installed, then you could use the jview command to run MailFaces. However some of the mailfaces features (audio feedback) are not supported.
• Download the ZIP file to a temporary directory.

Download mailfaces.zip to some temparary directory.
Extract the files using WinZip32 or other ZIP expanders that support long file names. All of the files will be expanded into a hilevel directory named "mailfaces". If for example, you unzip it to "c:\java" then it will be placed into a directory "c:\java\mailfaces".
• Bring up a MS-DOS Command window and issue the cd command to go to the directory where you installed MailFaces. You should find the MS-DOS Prompt on your "Start" button or you can enter "command" on the "Start->RUN" dialog.
  For example; after getting the MS-DOS command prompt window:
  
  -> c:
  -> cd \java\mailfaces

• Now issue the setup.bat command to customize your environment. You will need to specify the type of Java you are using.
  • For Java SDK and JRE
    -> setup java

  • For earlier versions of the JRE
    -> setup jre

  • For MicroSoft Internet Explorer 4.0
    -> setup jview

• Now you can invoke the mf.bat file that was created by the above setup command.
  -> mf.bat

• You will be prompted to for the name of your Options file (default: faces.opt).

• You will be prompted to enter the host name, userid and password for your Mail server.

• A MailFaces window should then come up and if you have any mail waiting, one or more icons should appear. If you have no mail waiting, you should get a "NoMail" icon.
• Now you can customize your faces.opt file. The comments in the distributed faces.opt file and the Options Documentation should be enough to get you going with specifications of local images for your favorite mail correspondents. Then restart MailFaces.

• If it does not seem to start correctly, you may want to add the -d flag to the command.
  -> mf -d
  You can either attach the resulting debug.txt file or paste the appropriate console messages to an email message and send them to me. jthomas@cruzio.com
• If you want to create a screen icon for MailFaces, then do the following:
  • Right click on the background window.
  • Select new -> shortcut
  • In the "Create Shortcut" window, enter the path to the mf.bat command. For example: c:\java\mailfaces\mf.bat
  • In the "Select a Title" window, enter MailFaces
  • In the "Select an Icon" window, select any icon that you like and then Finish.
  • If you want to run without a Command Window, then rerun the setup command:

           setup javaw
        

I hope that the installation of MailFaces went well! Please send a message to me at jthomas@cruzio.com with any comments or suggestions. I hope you will also subscribe to the MailFaces Mailing List so you can be informed of fixes and new releases.

John Thomas
jthomas@cruzio.com
http://www.cruzio.com/~jthomas

Unix Install Instructions:

Please note that currently MailFaces only works with mail that is gotten from a POP3 or IMAP mail server. It does not work with the standard Unix mail delivery system. One of these days, I will get Linux running on a machine here at home and I can work on getting MailFaces to interface to the Unix mail command.

• Make sure that you have Java 1.1 or later installed. Refer to the Java Developers Kit for more information about installing Java on a system.
• Download and unzip the mailfaces.zipfile.

• Optionally edit the file "mailfaces/faces.opt" with your favorite editor and specify at least the following options:
  • MailServer POP3 hostname username

• Issue the following commands:

  
      ->   cd  ./mailfaces 
      ->   CLASSPATH=.
      ->   export CLASSPATH   
      ->   java setup 
      

• Issue the following command to invoke mf.sh which was created in the previous step.
  -> sh mf.sh faces.opt
• A MailFaces window should come up and if you have any mail waiting, one or more icons should appear. If you have no mail waiting, you should get a "NoMail" icon.
• Now you can customize your faces.opt file.

  The comments in the distributed faces.opt file and the Options Documentation should be enough to get you going with specifications of local images for your favorite mail correspondents.

• If it does not seem to start correctly, you may want to add the -d flag to the command.
  -> sh mf.sh -d You can paste the appropriate resulting console messages into an email message and send them to me. jthomas@cruzio.com

I hope that the installation of MailFaces went well! Please send a message to me at jthomas@cruzio.com with any comments or suggestions. I hope you will also subscribe to the MailFaces Mailing List so you can be informed of fixes and new releases.

I am keeping track of which Unix platforms MailFaces has been sucessfully installed on, so I would appreciate a note giving me the Platform and release which you used to install MailFaces. Thanks!

John Thomas
jthomas@cruzio.com
http://www.cruzio.com/~jthomas

JavaMail installation.

In order to support POP3 and IMAP mailboxes, you need to have Sun's JavaMail package installed. The Javamail jar file is included with MailFaces. If you wanted to install it yourself, you would need to go to the JavaMail download site and download javamail and install it on your system.

You will also need the JavaBeans Activation Framework or JAF (javax.activation). It is also included but you could also get it from http://java.sun.com/beans/glasgow/jaf.html.

When you install MailFaces and run the setup command, it will generate a new mf.bat file that will set the classpath correctly. You can then use the new mf.bat command to invoke MailFaces and access an IMAP or POP3 mail server.

Contents of MailFaces distribution files.
( mailfaces.zip )

   
  
  mailfaces/    
    faces.opt     Sample Options file for MailFaces 
    setup.bat     Batch file to create "mf.bat"
    setup.class                   
    lib/
      mailfaces.jar	Jar file with all MailFaces class files
      mail.jar
      activation.jar
    image/
      *.gif    A few example Face Gifs
      *.au     A few example sound files
      *.pal    Color Palettes for PIcons using Paint Shop Pro
  		

Contents of MailFaces Source Distribution.
( mailfaces_src.zip)

   
  
  mailfaces/    
    com/jthomas/mailfaces/   MailFaces Package   	
    com/jthomas/util         Utility classes
    html/javadoc/			JavaDoc Documentation