Yolinux.com Linux logo

AOL and Linux

Related YoLinux Tutorials:

°Connecting to "Compuserve Classic"

°Connecting to your generic ISP using PPP

°YoLinux Tutorials Index

Free Information Technology Magazines and Document Downloads
TradePub link image

PengAOL Intro:

AOL logo This tutorial covers the PengAOL software installation and configuration necessary for one to connect to AOL using Linux. (uses P3 protocol) It is assumed that you have a working telephone modem. (There is also an option for using DSL.)

If you get one of those free CD's from AOL, it is not enough to get started. I had to first use the AOL software on a MS/Windows PC with the given "Registration number" and password to sign-on and obtain an account. The registration process will allow you to choose a login "handle" and login password. It is this login and password which will be used to login using the PengAOL Linux dialer. Once you have performed the registration process and obtained the necessary information you will no longer need the MS/Windows PC. Configuration of both the command line and GUI versions of the PengAOL dialer are covered in this tutorial.

PengAOL software installation and configuration:

Steps to install and use PengAOL dialer:

  1. Download: Download PengAOL software from SourceForge.

    This tutorial covers PengAOL version 1.0. I also tried 0.96 (RPM version) with less than satesfactory results. I am using Red Hat Linux 7.2 for this tutorial but due to the fact that one can compile the source code, I feel that it is probably Linux version and release independant. Download at least version 1.0beta1. Two downloads are available:
    • peng1.0a01.tar.gz - Source and precompiled executables.
    • QTkylix.tar.gz - Kylinx libraries used for GUI version. Covered at end of tutorial.

  2. Unpack and install:
    [root prompt]# tar xzf peng1.0a01.tar.gz
    [root prompt]# cd peng
    [root prompt]# ./recompile      - Optional and recommended. Compile from source and install. 
                                      Uses local language environment variable for configuration.
    [root prompt]# ./Install        - Use precompiled binaries

    Note the install scripts will configure the following:

    chmod +s /usr/bin/pengaol              - pengaol will be set to execute as root
    chmod +s /usr/bin/peng                 - pengaol will be set to execute as root
    chmod 666 /dev/ttyS0                   - Defaults are changed to allow regular users access to serial ports
    chmod 666 /dev/ttyS1

    While I find this acceptable for my own personal workstation, it may not be acceptable for a public system. It's your call. I personally use an external modem on COM2 (/dev/ttyS1). Many internal modems use other serial ports may require the appropriate configuration.

    Software installed:

    /usr/bin/pengsetup - GUI configuratiojn program. Did not work for me. Just locks up and waits. /usr/bin/PengGui - GUI program. See configuration below. /usr/bin/wavplay
    Configuration and data files installed:
    /etc/Pengaol/PengAol.conf       - Edit this file. See below.
    /etc/Pengaol/Dns                - Same purpose as /etc/resolv.conf. List of name servers
  3. Configuration:
    • Edit configuration file: /etc/Pengaol/PengAol.conf
      Change the following:
      PhoneNbr=0860880310 - Change to actual dial-up number for telephone modem access. AutoDetected=/dev/ttyS0 - On my system I use an external modem on /dev/ttyS1 ...

      Default phone number in code and config file: 0860880310 (Somewhere in France - Don't use it!!!) In america I use the local phone number without the area code. There did not seem to be any command or GUI interface to manage the access number. There is just you, the file and a text editor.

    • Shut down other internet connections:
      I turned off my DSL connection. (It's not like I really use AOL): ifdown eth0

      [Potential Pitfall]: If you leave any other internet connections active, PengAOL will test, find and use a connection driver which may not be the one you counted on. When dialing in to AOL by modem, I kill the ethernet connection. (Not a problem with regular PPP access to generic ISP's or Compuserver.)

    • Add user to the connection list: pengaol -AddUser [login] [Password]
      Add your AOL login and password to the list of users. This is stored in the file: $HOME/.PengUser
      The password is stored encrypted.

  4. Test auto driver detection: pengaol -ListDriver
    Load language : en 
    Driver Name : CPppDriver
    Author : Birdy57
    Message included : Vers 0.55 Linux
    Guid : 3812
    The pilot works on this configuration :Yes

    Driver Name : CTunTapDriver
    Author : birdy57
    Message included : Vers 0.5 Linux
    Guid : 4212
    The pilot works on this configuration :No

    Driver Name : CCableDriver
    Author : birdy57 & surfufu
    Message included : Vers 0.5 Multi
    Guid : 8301
    The pilot works on this configuration :No

    Driver Name : CModemDriver
    Author : Birdy57
    Message included : Vers 0.5 Linux
    Guid : 1711
    The pilot works on this configuration :Yes

  5. Dial AOL and use internet connection:

    pengaol -User [login] [Password] 
    OR pengaol -AddUser [login] [Password] - Do this once to add user to $HOME/.PengUser pengaol -Connect [login]

    Other command line examples:

    pengaol -DelUser [login]
    pengaol -ListUser
    Other command line options require the setting of compilation flags to turn them on. (i.e. -Debug, -Log,...)

  6. Terminate the session: killall pengaol or CNTL-c

[Potential Pitfall]: If it doesn't connect try a different access number.

PengAOL GUI Set-Up:

In addition to the pengaol configuration set-up above, perform the following additional steps:

  1. Download and install:
    [root prompt]# tar xzf QTkylix.tar.gz  - Required for GUI interface users
    [root prompt]# cd QT/
    [root prompt]# ./install
    This will create the directory /opt/qtkylix and copy the Kylix libraries to this directory.

  2. Run GUI dialer:

    Script to start GUI version of AOL dialer found in: peng/peng/pengui

    export LD_LIBRARY_PATH=/opt/qtkylix
    ls -l /dev/modem > /tmp/Modem.txt

    1. Select "Connect" button:
      PengAOL GUI
    2. New dialog box appears. Select "OK":
      PengAOL GUI
    3. Select appropriate login from pull-down menu and select "Start" button:
      (or select "User Manager" button to add and configure user - once)
      PengAOL GUI
    4. User Manager: add/delete/edit a login/password: (Add and configure user - once)
      PengAOL GUI
    5. Select "Start" button. System will dial and connect:
      PengAOL GUI
    6. GUI will show stats:
      PengAOL GUI
    7. The "Quit" button will disconnect you from AOL.

Access Numbers:

Dial up modem access numbers may be obtained by first using the nationwide (U.S., Puerto Rico, and the US Virgin Islands) modem dial-up number: 1-(800)716-0023
(they charge 10 cents a minute or $6.00 per hour)

This will connect you to the internet. Search for a local access number by entering the telephone area code on the AOL access number search page: http://access.web.aol.com/

International Access Numbers: http://intlaccess.web.aol.com/

Call and get a number (beware they make you wait for an operator): (800)827-6364


Checking your email can be done in two ways:

  1. Go to Aol.com and use the web interface.
  2. Download Netscape 6.1+ and use it to access AOL email via the AOL IMAP interface. When adding a new email account to the Netscape configuration it will allow one to configure the account for POP, IMAP, AOL or a Newsgroup. Choose AOL. It works!! Even though Mozilla is almost exactly the same as Netscape 6+ on Linux, only Netscape supports AOL mail.
    • Select from the browser toolbar "Tasks" + "Mail".
    • From the new Mail window select "Edit" + "Mail/News Account Settings...".
    • Selecting the "New Account" button will bring up a wizard to create the new AOL mail account.
    • To use the account select the AOL Mail account "Mail Folder". You will now be in the AOL mail environment to read, archive and delete mail. This will require the use of your AOL screen name and password.
    • AOL Servers:
      • IMAP: imap.aol.com
      • SMTP (outbound): smtp.aol.com
        (Use AOL login/password)



    Bookmark and Share


Copyright © 2002, 2004, 2005 by Greg Ippolito