Linux Guide

AT&T Global Network Client for Linux –Version 1.03.4 Draft

For Linux

2002, AT&T Corporation, All rights reserved

AT&T Global Network Client for Linux Users Guide

Contents Contents........................................................................................................................................ ii

Welcome ............................................................................................................................................. iv How to Use This Guide................................................................................................................... iv System Requirements ........................................................................................................................v Distribution........................................................................................................................................v Installation Checklist.........................................................................................................................v Capabilities........................................................................................................................................v

Downloading the AT&T Global Network Client for Linux ............................................................1 Downloading .........................................................................................................................1 Making the File Executable...................................................................................................1

Installing the AT&T Global Network Client for Linux...................................................................2 Running Setup .......................................................................................................................2 Software License Agreement Window .................................................................................2 Installation Window ..............................................................................................................3 Installation Complete ............................................................................................................3 Additional Installation Information.......................................................................................4

Configuration.......................................................................................................................................5 First Time Run Message .......................................................................................................5 Running the Configuration Tool ...........................................................................................5 Running the Configuration Tool Using the Icon...................................................................5 Running the Configuration Tool Using the Menu ................................................................6 User Tab ................................................................................................................................6 User Field Descriptions.........................................................................................................7 DNS Tab................................................................................................................................8 Modem Tab ...........................................................................................................................8 Modem Field Descriptions ....................................................................................................8 Connection tab.......................................................................................................................9 Connection Field Descriptions ..............................................................................................9 Trace tab................................................................................................................................9 Exits Tab .............................................................................................................................10 Exits Tab Descriptions ........................................................................................................10

Main Menu Options ..........................................................................................................................12 Starting the AT&T Global Network Client for Linux.........................................................12 Connecting ..........................................................................................................................12 Connecting to AT&T Global Network Using the Icon .......................................................12 Connecting to the AT&T Global Network Using the Menu...............................................13 Password..............................................................................................................................13 Password Changes Using the Menu Option........................................................................13 Password Changes Using the Shortcut Keys Option ..........................................................14 Password Change Window..................................................................................................14 Software Update ..................................................................................................................15 Software Update ..................................................................................................................15

2002, AT&T Corporation, All rights reserved. Page ii


Software Updates Using the Shortcut Keys Option ............................................................15 Software Update Window ...................................................................................................15 Software Update Selection ..................................................................................................16 Clearing the Log Display Window......................................................................................17 Clearing log display window...............................................................................................17 Disconnecting from the AT&T Global Network ................................................................18 Disconnecting Using Icons..................................................................................................18 Disconnect Using the Menus...............................................................................................18 Exiting the AT&T Global Network Client for Linux .........................................................19 Exiting Using the Icon.........................................................................................................19 Exiting Using the Menus.....................................................................................................19 Exiting Using Other Methods .............................................................................................20 Help Menu Items.................................................................................................................21 Help Menu Descriptions......................................................................................................21 Customer Support Window.................................................................................................22 Help Contents ......................................................................................................................22 What’s this? Option.............................................................................................................23 About Window ....................................................................................................................23

Uninstall .............................................................................................................................................24 Executing the Uninstall .......................................................................................................24 Software License Agreement Window ...............................................................................24 Uninstall Window ...............................................................................................................24 Uninstall Complete Window...............................................................................................25

Appendix A: Problem Determination Aids.....................................................................................26

Appendix B: Frequently Asked Questions......................................................................................27

2002, AT&T Corporation, All rights reserved. Page iii


Welcome

AT&T Global Network Services provides a full suite of Remote Access services to meet the challenging and demanding requirements of businesses today. Since most people use the Microsoft Windows operating system, the AT&T Global Network Client has been designed to support all of our services for that environment. AT&T recognizes there is a need to access remote services from other platforms as well. Thus we provide client software for the Palm OS, Windows CE, Macintosh, AIX and Linux platforms. We also provide a platform agnostic solution by utilizing our NetGate network appliance. This document provides information on the capabilities and use of the AT&T Global Network Client for Linux.

How to Use This Guide This document describes the installation, setup and features of the AT&T Global Network Client for Linux. The remainder of this chapter includes System Requirements, Distribution, and Installation Checklist. These sections cover prerequisites to review before you proceed. The next chapters, Downloading the AT&T Global Network Client for Linux and Installing the AT&T Global Network Client for Linux, describes the installation procedures for the program. Following installation, the Configuration chapter describes configuring the AT&T Global Network Client for Linux to connect to the network. The remaining chapters discuss the connection process, password changes, setup options, help options, and uninstalling the client. Problem determination aids and frequently asked questions are included in the appendixes. This user guide is provided to you on an "as is" basis and AT&T shall have no liability for any errors or inaccuracies herein. This user guide is subject to change without notice and you should consult your Customer Point of Contact (CPOC) or customer help desk with specific questions.

2002, AT&T Corporation, All rights reserved. Page iv


System Requirements The Linux Client is supported on the following Linux distributions.

• Red Hat 6.2 and 7.1 • Mandrake 7.0 7.1 and 7.2 • SuSE 7.2 and 7.3 • Corel Linux OS and Corel Linux OS Second Edition

In addition to this, the following libraries need to be installed.

• LibXext.so.6 • LibX11so.6 • Libstdc++-libc6.1-1.so.2 • Libm.so.6 • Libc.so.6 • /lib/ld-linux.so.2

Note: The Linux Client uses Qt 2.2.2 for the application framework. This means that the Qt 2.2.2. runtime libraries must be available on the system. There are two versions of the client available. One version has included the libraries in the client itself, a method known as static linking. This relieves the user of the burden of installing the Qt libraries however it increases the size of client. A second dynamic link version is available for users who have installed the correct Qt runtime libraries.

Distribution The AT&T Global Network Client for Linux (static link version) can be downloaded from ftp://ftp.attglobal.net/pub/client/linux/static/setup The dynamic linked version can be downloaded from ftp://ftp.attglobal.net/pub/client/linux/dynamic/setup

Installation Checklist Before starting the AT&T Global Network Client for Linux installation and setup, complete the following checklist. If you are missing any information, please contact your account administrator.

Account User ID Password Verify a modem is installed and working with your version of Linux Verify PPP is installed

Capabilities At this time, the AT&T Global Network Client for Linux supports the following services.

• Internet • Secure IP

2002, AT&T Corporation, All rights reserved. Page v

ftp://ftp.attglobal.net/pub/client/linux/static/setup

ftp://ftp.attglobal.net/pub/client/linux/dynamic/setup


• Dual Access • Fixed IP • 3D

Other network applications (eg: VPN software) may be run along side the Linux client for a complete connectivity solution.

2002, AT&T Corporation, All rights reserved. Page vi


Downloading the AT&T Global Network Client for Linux

Downloading You can download the Linux client at ftp://ftp.attglobal.net/pub/client/linux/static/setup or ftp://ftp.attglobal.net/pub/client/linux/dynamic/setup using a GUI or the terminal interface. Figure 1 shows an example using gftp 2.0.8. Once you are in the correct folder, (dynamic for the dynamically linked version or static for the statically linked version), for Linux, click on setup and select the left pointing arrow icon to start the download.

Figure 1: FTP Download GUI

Making the File Executable Once the file "setup" is retrieved, you may need to set the execute access permissions. This is only required if the ftp tool you are using does not save the file permissions. If you are using one of the GUI's such a KDE or Gnome, you can do this from the file window. For KDE, right click on the Setup Icon and select ‘Properties’ from the popup menu. Click on the ‘Permissions’ tab and ensure that all the check boxes under the “Exec” column are checked. If you are familiar with using the terminal interface, you can use the chmod command to set the permissions. If you are in the directory with setup, you can enter “chmod 777 setup.” If you are not in the directory, you can specify the full file name, e.g. “chmod 777 /usr/download/setup.”

2002, AT&T Corporation, All rights reserved. Page 1

ftp://ftp.attglobal.net/pub/client/linux/static/setup

ftp://ftp.attglobal.net/pub/client/linux/dynamic/setup


Installing the AT&T Global Network Client for Linux

Running Setup You may either execute setup from within a file manager window or from a terminal interface running under “X.” You cannot execute setup from outside the “X” environment. To change the directory that the client will install into, you must run setup from a terminal window and provide the new path name as an argument on the command line, for example, “./setup /usr/local.”

Software License Agreement Window The Figure 2: Software License Agreement Window displays the standard license agreement for the AT&T Global Network Client. To continue with the installation, you must agree to the terms and conditions specified in the license agreement by clicking on the ‘I Agree’ button. If you click on the ‘I disagree’ button, setup will terminate without installing any of the files.

Figure 2: Software License Agreement Window



Installation Window On the Figure 3: Installation Window, click the ‘Install’ button to continue. You may exit the installation by clicking on the ‘Cancel’ button. Note: It is not necessary to uninstall an older version of the client before installing a newer version. If aconfiguration file upgrades are required, these will be made the first time you start the client.

ny

Figure 3: Installation Window

Installation Complete You will receive the Figure 4: Installation Complete message once the installation is complete. Click on ‘Launch Dialer’ to close the installer and start the client. If you would like to exit the installer and start the client at a later time, click on ‘Finished.”

Figure 4: Installation Complete



Additional Installation Information Directory Contents /opt/attdial/backup previous release when upgrading (restore source - future) /opt/attdial/bin client executable (attdial), pppd startup scripts (ip-up local, ipupatt, ttypap ), client exit

scripts (attdue1.sh, attdue2.sh, attdue3.sh) and user exit scripts (userexit1.sh, userexit2.sh, userexit3.sh) Note: Client exits scripts exist only if the exit is enabled. User exit scripts only exist if the exit is enabled and the user has provided a script.

/opt/attdial/etc data files, phone and country lists (country3.dat, phone3.dat) /opt/attdial/help help files, license agreement, change history (*.html, *.png, legal.html, history.txt) /opt/attdial/original dynamic backup of ip-up.local, resolv.conf and options.ttyXX /$HOME/.attdial user versions of wvdial.conf and attdial.ini and the trace log file dialer.log



Configuration

First Time Run Message

When you start the client for the first time or a new Linux user runs the client, you will receive the Figure 5: First Time Run Warning Message. The message informs the first time user that the user must use the configuration tool and complete, at a minimum, the User, Modem, and Connection sections before connecting to the network.

Figure 5: First Time Run Warning Message

Running the Configuration Tool The configuration tool can be started from the main window by using the icons, menus or shortcut keys. To start the configuration tool using the shortcut keys, press function key 4 (F4).

Running the Configuration Tool Using the Icon On the Figure 6: Main Window, move the mouse pointer on top of the configuration tool icon and press the left mouse button to start the configuration tool.

Figure 6: Main Window



Running the Configuration Tool Uthe Menu

sing

Move the mouse pointer on top of the Network menu item and press the left mouse button to start the configuration tool using the menu. Next move the mouse pointer on top of the Configure menu item as shown in Figure 7 and press the left mouse button. (Depressing and holding the left ALT key and then pressing the N key can also open the Network dropdown menu.) When using menus, the up arrow and down arrow keys may be used to select the action.

Figure 7: Main Window Using the Menu

User Tab The user tab on the Configuration Window is used to identify the user and select the type of service. An additional window to change the Domain Name Server (DNS) addresses will be presented when changing the type of service. (See the user tab help section for information about the buttons at the bottom of each page.)

Figure 8: Configuration Window User Tab



User Field Descriptions Input Item Description Account Enter the account you have been given to access the AT&T Global Network. User Enter the user identification you have been given to access the AT&T Global Network. Password Enter the password you have been given to access the AT&T Global Network. The password

will be masked and stored in a file in your home directory. If you do not want to have your password stored in a file, leave this field blank and you will be prompted to enter your password when you request a connection to the network.

Verify password Re-enter the password you have been given to access the AT&T Global Network. Leave this field blank if you have left the password field blank.

Type of service Select the type of service, internet, dual access, etc., for your access to the AT&T Global Network. Selecting this will open a second dialog that allows you to enter your domain name and names of two domain name servers.

The following buttons are found at the bottom of each configuration page: OK Save the information on every page and exit the dialog. Apply Save the information on every page but do not exit the dialog. Cancel Discard all information entered since the last Apply. If you have never pressed the Apply button, then all

data entered will be discarded. You will receive a warning if there is unsaved data.



DNS Tab The “Type of Service” dropdown field in the Configuration Window User Tab controls the selection of Domain Name Server (DNS) address. Selecting any type of service will cause the popup Figure 9: DNS Update Window to appear. For Internet, the information will be provided from the client although this can be changed if needed. For dual access and secureIP, this information must be obtained from your network administrator.

Figure 9: DNS Update Window

Modem Tab The Figure 10: Configuration Modem Tab is used to select a modem. The auto detect feature will locate any modem attached to the system and allows the user to select which modem to use. Auto detect will attempt to locate modems on each defined device. If this is a long list then the detection process may take several seconds. For details on Linux and modems see http://www.tldp.org/HOWTO/Modem-HOWTO.html.

Figure 10: Configuration Modem Tab

Modem Field Descriptions Input Item Description Modem Port Enter name of port that has your modem connection. Modem Speed Enter the speed of your modem. Initialization String 1 Enter any special modem initialization strings needed by your modem. Initialization String 2 Enter any special modem initialization strings needed by your modem. Auto Detect You may click the auto detect button if you want the client to attempt to automatically

configure the modem.


http://www.tldp.org/HOWTO/Modem-HOWTO.html

http://www.tldp.org/HOWTO/Modem-HOWTO.html


Connection tab The Figure 11: Configuration Connection Tab is used to locate the phone number of the nearest access point. The Connection Field Descriptions below describe each field.

Figure 11: Configuration Connection Tab

Connection Field Descriptions Input Item Description County/Region Select the country from which you are attempting to connect from the drop-down menu. If

the country has regions, an additional list will be displayed. Select a region within the country you are attempting to connect from the drop-down menu.

Phone Number Select the phone number from the drop-down menu. This list will have the name of the city and the phone number. There may be more than one phone number for some cities.

Dialable Number Edit the number for any required prefix. Customer Support Number

This is an information field only. This number is the same as the number that is displayed when you select customer support under the help menu.

Trace tab The Figure 12: Configuration Trace Tab is used to set the amount of detail that is displayed in the client log window. Check each option you would like detailed.

Figure 12: Configuration Trace Tab



Exits Tab The Figure 13: Configuration Exits Tab allows the user to perform actions at pre-defined points in the connection process. You can find a description for each field in the Exits Tab Descriptions below.

Figure 13: Configuration Exits Tab

Exits Tab Descriptions Input Item Description Delete the default route prior to connect

Selecting this check box will cause the client to delete any exiting default route in the IP routing table before dialing the network. Before the route is deleted, the client will attempt to determine the IP address of the default route and set the “Restore the default route after disconnect” check box on and complete the “Default route IP address” field. NOTE: The process of determining the default route IP address may take a few seconds.

Restore the default route after disconnect

Selecting this check box will cause the client to restore the default route IP address after disconnecting from the network. This check box is disabled if “Delete the default route prior to connect” is not checked.

Default route IP address Enter the IP address of the route to be set as the default IP address after disconnecting from the network. The client will attempt to determine the current default IP address when the “Delete the default route prior to connect” check box is checked. This field is disabled if “Delete the default route prior to connect” is not checked.

Launch Netscape after connect

Selecting this check box will cause the client to launch Netscape® after the connection completes.

Call user exit 1 before connecting

Selecting this check box will cause the client to call the user written shell, “userexit1.sh” before connecting to the network. The script must be in the client “bin” directory. The call to this script is synchronous. The client will wait for the shell to complete before continuing. If the “Delete the default route prior to connect” is active, the user script will execute after the route is deleted.

Call user exit 2 after connected

Selecting this check box will cause the client to call the user written shell, “userexit2.sh” after connecting to the network. The script must be in the client “bin” directory. The call to this script is synchronous. The client will wait for the shell to complete before continuing. If the “Launch Netscape after connect” is active, the user script will execute after Netscape is launched.



Call user exit 3 after disconnect

Selecting this check box will cause the client to call the user written shell, “userexit3.sh” after disconnecting from the network. The script must be in the client “bin” directory. The call to this script is synchronous. The client will wait for the shell to complete before continuing. If the “Restore the default route after disconnect” is active, the user script will execute after the default route is restored.



Main Menu Options

Starting the AT&T Global Network Client for Linux The name of the AT&T Global Network Client for Linux executable is “attdial.” The executable is installed in the directory “/opt/attdial/bin.” When you run “attdial,” the Figure 14: Main Window will appear. The installation directory can be changed when running the setup program. If the default directory is changed during installation, the location of the executable will be the “(directory name)/attdial/bin.” If this is the first time the current user has run “attdial,” the Figure 5: First Time Run Warning Message will be displayed telling the user to run the Configuration tool. Figure 14: Main Window

Connecting The connection can be made from the main window by using the icons, menus or shortcut keys. These options will be disabled if a connection already exists. To start the connection process using the shortcut keys, press function key 2 (F2).

Connecting to AT&T Global Network Using the Icon On the Figure 14: Main Window move the mouse pointer on top of the connection icon as shown in Figure 15 and press the left mouse button to start the connection process.

Figure 15: Main Window Using Icon to Connect



Connecting to the AT&T Global Network Using the Menu On the Figure 14: Main Window; move the mouse pointer on top of the Network menu item, and press the left mouse button to start the connection process. Next move the mouse pointer on top of the Connect menu item as shown in Figure 16 and press the left mouse button. (Depressing and holding the left ALT key and then pressing the N key can also open the Network dropdown menu.) When using menus, the up arrow and down arrow keys may be used to select the action.

Figure 16: Main Window Connection Using the Menu Password

Password Password changes can be made from the main window menus or shortcut keys. Passwords changes are made prior to connecting to the Network. This option will be disabled if a connection exists.

Password Changes Using the Menu Option To change your password, on the Main Window move the mouse pointer on top of the Services menu item and press the left mouse button. Next move the mouse pointer on top of the “Change Password” menu item as shown in Figure 17 and press the left mouse button. When using menus, the up arrow and down arrow keys may be used to select the action.

Figure 17: Changing Password - Main Window



Password Changes Using the Shortcut Keys Option Depressing and holding the left ALT key and then pressing the S key can open the Services dropdown menu. Then depress and hold the left Alt key and the left Shift key and then press the P key to bring up the Change Password window.

Password Change Window On the Figure 18: Change Password Window, enter your new password in the “New Password” field and then re-enter the password in the “Verify Password” field. Click ‘OK’ to accept the new password or ‘Cancel’ to discard the change request.

Figure 18: Change Password Window After the Connection to the Network is complete the password change will be initiated. If the change is completed, you will be notified that the password was successfully changed. If there is a problem, you will receive an information message with details about the reason the change could not be completed.



Software Update Software updates are made after connecting to the Network. This option will be disabled if a connection does not exist. Software updates can be made from the main window menus or shortcut keys.

Software Update To start the software update process using the menus, move the mouse pointer on top of the Services menu item on the Main Window and press the left mouse button. Then move the mouse pointer on top of the “Software Update” menu item as show in Figure 19 and press the left mouse button. When using menus, the up arrow and down arrow keys may be used to select the action.

Figure 19: Software Update - Main Window

Software Updates Using the Shortcut Keys Option Depressing and holding the left ALT key and then pressing the V key can also open the Services dropdown menu. To start the software update process using the shortcut keys, depress and hold the left Alt key and the left Shift key and then press the U key.

Software Update Window After the software update tool is started the current and available date of the phone file and program version will be displayed as shown in Figure 20. This process may take a few seconds. After the available version information is complete, click on the checkbox for the items you want to update and select ‘Download.’ If you do not want to update any items select ‘Exit.’

Figure 20: Software Update Window



Software Update Selection When the software download begins, a progress bar will replace the current and available area and the checkbox item will be replaced by the name of the file being retrieved as shown in Figure 21. You may cancel the update before the download completes by selecting ‘Cancel.’ Figure 21: Software Download Progress Bar Note: In the unlikely event that the files with the telephone numbers are received in an unusable state, the current version is renamed after the download of the latest version is complete. To manually restore the files do the following: Delete: “/$Home/attdial/etc/phone3.dat” and “/$Home/attdial/etc/country3.dat” Rename: “/opt/attdial/etc/phone3.bak” to “/opt/attdial/etc/phone3.dat” and

“/opt/attdial/etc/country3.bak” to “/opt/attdial/etc/country3.dat” If the client has been installed in a directory other the default, then you will need to replace ‘/opt’ with the installation directory.



Clearing the Log Display Window The window containing the log messages can be erased from the main window by using the menus or shortcut keys. Depressing and holding the left ALT key and then pressing the V key can also open the View dropdown menu. To clear the log window using the shortcut keys, depress and hold the left Alt key and the left Shift key and then press the L key.

Clearing log display window To clear the log window using the menus, move the mouse pointer on top of the “View” menu item and press the left mouse button. Next, move the mouse pointer on top of the “Erase log” menu item as shown in Figure 22 and press the left mouse button. When using menus, the up arrow and down arrow keys may be used to select the action.

Figure 22: Erase Log - Main Window



Disconnecting from the AT&T Global Network A connection may be terminated from the main window by using the icons, menus or shortcut keys. This option will be disabled if a connection does not exist. To terminate a connection using the shortcut keys, press function key 3 (F3).

Disconnecting Using Icons To terminate the connection using the icon, move the mouse pointer on top of the ‘Disconnect’ icon as shown in Figure 23 and press the left mouse button.

Figure 23: Disconnect Using Icons - Main Window

Disconnect Using the Menus To terminate a connection using the menus, move the mouse pointer on top of the Network menu item and press the left mouse button. Next move the mouse pointer on top of the Disconnect menu item and press the left mouse button as shown in Figure 24. (Depressing and holding the left Alt key and then pressing the Nkey can also open the Network dropdown menu.) When using menus, the up arrow and down arrow keys may be used to select the action.

Figure 24: Disconnect Using Menus - Main Window



Exiting the AT&T Global Network Client for Linux Ending the client will also cause the connection to be terminated. You can exit the client from the main window by using the icons, menus or shortcut keys.

Exiting Using the Icon To exit the client using the icon, move the mouse pointer on top of the exit icon as shown in Figure 25 and press the left mouse button.

Figure 25: Exiting Using the Icon - Main Window

Exiting Using the Menus To exit using the menus, move the mouse pointer on top of the Network menu item and press the left mouse button. Next move the mouse pointer on top of the Exit menu item as shown in Figure 26 and press the left mouse button. (Depressing and holding the left Alt key and then pressing the N key can also open the Network dropdown menu.) When using menus, the up arrow and down arrow keys may be used to select the action. Figure 26: Exiting Using the Menus - Main Window



Exiting Using Other Methods To exit using the shortcut keys, press function key 12 (F12). In addition to the client provided keys, the desktop environment's control keys and window decorations can also be used. For GNOME and KDE the left Alt-F4 or the top left window button will also initiate a client exit. If you have an active session when you exit, you will be asked to confirm that you want to disconnect from the Network as shown in Figure 27. Selecting ‘Yes’ will end the session and close the client. Selecting ‘No’ will return you to the main window.

Figure 27: Disconnect Message



Getting Help A variety of help information is available in the AT&T Global Network Client for Linux. This information can be accessed from the main window by using the icons, menus or shortcut keys. Depressing and holding the left Alt key and then pressing the H key can also open the Help dropdown menu.

Help Menu Items To display the menu of help items, move the mouse pointer on top of the Help menu item as shown in Figure 28 and press the left mouse button. When using menus, the up arrow and down arrow keys may be used to move the selection and the enter key used to select the action.

Figure 28: Help Menu - Main Window

Help Menu Descriptions Menu Item Description Customer Support This will display information on contacting customer support. You can display customer

support information by selecting the customer support menu item in the help drop down menu or pressing ALT-SHIFT-C.

Contents This will display the contents of the available help files. You can display the contents by selecting the contents menu item in the help drop down menu or pressing F1.

What’s this This will invoke a help cursor that you can use to click on a menu item to get a short description of the items purpose. You can invoke the help cursor by selecting the “what’s this” menu item in the help drop down menu or pressing SHIFT-F1.

About This will display the date and version information for the client. You can invoke the about information selecting the about menu item in the help drop down menu or pressing ALT-SHIFT-F1.



Customer Support Window To display the Customer Support information, click the Figure 28: Help Menu - Main Window and move the mouse pointer on top of the Customer Support menu item and press the left mouse button. Or you can display the Customer Support information using the shortcut keys by depressing and holding the left Alt key and the left Shift key and then pressing the C key. You will receive a window similar to Figure 29. The contents of the window will vary depending on your type of service and location.

Figure 29: Customer Support Window

Help Contents To display the Figure 30: Help Table of Contents Window, open the Help dropdown window, move the mouse pointer on top of the Contents menu item and press the left mouse button. Or, you can display the help table of contents using the shortcut keys, by pressing function key 1 (F1). Click on the subject for more information. Figure 30: Help Table of Contents Window



What’s this? Option “What's this” provides a way to get additional information about an icon. “What's this” can be accessed by moving the mouse pointer on top of the “What's this” icon and pressing the left mouse button; opening the Help dropdown window, and moving the mouse pointer on top of “What's this” and pressing the left mouse button; or by holding down the left Shift key and then pressing function key 1 (F1). The cursor will change to the “What's this” cursor and you then left click on the icon that you want additional information.

About Window To display information about the current release of the client as shown in Figure 31, open the Help dropdown window, move the mouse pointer on top of the ‘About’ menu item and press the left mouse button.

To display information about the current release of the client using the shortcut keys, depress and hold the left Alt key and the left Shift key and then press the A key. If you need to contact customer support and you are able to start the client, please have the information presented in the about window available to give to your customer support representative.

Figure 31: About Window



Uninstall

Executing the Uninstall To start the process to uninstall the Linux client, you need to re-execute the installation setup program.

Software License Agreement Window The first window displayed is Figure 2: Software License Agreement Window that displays the standard license agreement for the AT&T Global Network Client. To continue with uninstall, you must agree to the terms and conditions specified in the license agreement by clicking on the ‘I Agree’ button. If you click on the ‘I disagree’ button, setup will terminate without uninstalling the client.

Figure 32: Software License Agreement Window

Uninstall Window On the Figure 33: Uninstall Window, click the ‘Uninstall’ button. The uninstall program will remove the client and any configuration files stored in the “$home/.attdial” directory of the Linux user that is running uninstall. If the client is used by more than one user, all other users will have to manually remove the “$home/.attdial” directory and its contents.

Figure 33: Uninstall Window



Uninstall Complete Window As shown in Figure 34, you will receive a message that uninstall is complete. Click on ‘Finished’ to close and exit the uninstall program.

Figure 34: Uninstall Complete Window



Appendix A: Problem Determination Aids

1. The client records a log of events in the file /$HOME/.attdial/dialer.log and is available after the client is terminated. The contents of the file are erased and a new log started each time the client is started. Note: The directory is “ .attdial” which means it is a hidden directory. To view the directory in one of the file managers, you must be sure to select the 'show hidden files' option.

2. In the event of an error that causes the client to terminate, such as a segmentation fault, the data in the “dialer.log” file may be incomplete. To determine the cause of the error, run the client from a terminal emulator window. To do this, start a terminal emulator window by clicking on the terminal emulator window icon on the desktop, change directories to “/opt/attdial/bin” (or the appropriate directory if installed in another location) “cd /opt/attdial/bin,” and type “./attdial.” The event messages will appear in the terminal emulator window.

3. Linux logging information about the ppp daemon can be found in: /var/log/syslog and /var/log/daemons/info for Mandrake /var/log/messages for Red Hat /var/log/ppp for Corel



Appendix B: Frequently Asked Questions

After installing the client on a Red Hat 6.2 distribution, nothing happens when the client is selected from a file manager window. When the client is run from a terminal, there is a segmentation fault. NOTE: Version 1.1.6 uses a static link of the Qt libraries. This means that problems with the Qt library levels will not be an issue. Only client versions that dynamically link to the Qt libraries are affected. Red Hat 6.2 is distributed with Qt 2.1.0 - beta 3. There is an error in the QImage function that causes the segmentation fault. If you examine “ld.so.conf,” you will see a reference to “/usr/lib/qt-2.1.0/lib.” You can resolve this problem by installing Qt 2.1.1 or greater. The following is one way to get Qt 2.1.1 on the system.

1. Create a directory name /usr/lib/qt/lib 2. Edit ld.co.conf and change /usr/lib/qt-2.1.0/lib to /usr/lib/qt/lib 3. Download qt211.tar from one of the AT&T ftp servers list on the main Linux client page 4. Extract the contents of qt211.tar to /usr/lib/qt/lib 5. Run ldconfig from a terminal.

The client should now operate normally.

If you have an Ethernet and dial connection, you may have a problem with the default route. Note: In version 1.1.6, you can force the deletion of the default route by using the pre-connect user exit. You will need to use the post disconnect exit to restore the default route if you want it to be available after you terminate the connection. This is an excerpt from Linux PPP HOWTO: If pppd refuses to set up a default route, it is because (quite correctly) it refuses to remove/replace an existing default route. The usual reason that this error occurs is that some distributions set up a default route via your Ethernet card as opposed to setting up a specific network route. See the Linux NAG (Linux Network Administrator Guide) and the Net2/3 HOWTOs for information on correctly setting up your Ethernet card and associated routes. An alternative to this is that your LAN uses a gateway/router already and your routing table has been set up to point the default route at this. Fixing up this last situation can require a fair bit of IP networking knowledge and is beyond the scope of this HOWTO. It is suggested you obtain some expert advice (via the news groups of from someone locally you can ask).


http://www.tldp.org/HOWTO/PPP-HOWTO/index.html

http://www.ibiblio.org/mdw/LDP/nag/nag.html

http://www.ibiblio.org/mdw/HOWTO/Net-HOWTO/


How do I create a desktop shortcut for the client? KDE:

1. Select the Application item in the KDE start menu. In KDE 2.0.1, this is located in Start menu->Create New->Application.

2. In the General section, change the name from Applications to ATTDial.kdelnk. The text located before “.kdelnk” is the text that will appear on the desktop.

3. In the Execute section, insert “attdial /opt/attdial/bin/attdial” in the Program Name entry field. If you have changed the install location of the client then use the directory you installed the client in for the fully qualified path name.

4. Create a symbolic link for “/opt/attdial/bin/attdial” in one of the directories in your path. GNOME:

1. Right click on the Gnome desktop and select New->Launcher. 2. Enter a name in the Name field. This is the name that will appear on the desktop. 3. Enter “attdial” in the Command field. 4. Optionally you may select an icon by clicking on the No Icon button. 5. Create a symbolic link for “/opt/attdial/bin/attdial” in one of the directories in your path.

What does the message “the libqt.so.2 was not found” mean? NOTE: For release 1.1.6, you will not need to upgrade to the Qt 2.2.2. The libraries are linked statically. This increases the size of the executable, but eliminates the need to have the Qt runtime libraries on your system. The X and GNU C libraries are still required. The client uses Qt version 2 by TrollTech ( www.troll.no ) for the end user interface. To use the client you will need to have the qt 2.2.2 run time libraries installed. Several of the latest Linux distributions include this version of Qt. To see if the correct version of Qt is on your system, do a search for “libqt.so.2.2.2.” If the distribution you are using does not include Qt 2.2.2 then you will need to download the runtime library. The RPM repository on niteowl ( www.userfriendly.net/linux/RPM/index.html ) has Qt for many distributions. This information was obtained by:

1. Selecting "index by Name" 2. Selecting "Packages beginning with letter Q" 3. Selecting "Linux/i586" at the right of the "qt2-2.2.2-2mdk" entry 4. Selecting "libqt.so.2" under the Provides heading on the page

qt-2.2.2-2.i386 The shared library for the Qt GUI toolkit. KDE Stable qt-2.2.2-2.i386 The shared library for the Qt GUI toolkit. RawHide 1.0 for i386 qt-2.2.2-2.alpha The shared library for the Qt GUI toolkit. RawHide 1.0 for Alpha qt-2.2.2-2.sparc The shared library for the Qt GUI toolkit. RawHide 1.0 for Sparc qt2-2.2.2-2mdk.i586 Shared library for the Qt2 GUI toolki Mandrake Cooker



If you cannot find the Qt 2 libraries you can get the i386 libraries in tar format from either ftp.prserv.net/pub/client/linux/qtlib.tar or 129.36.226.11/pub/client/linux129.36.226.11/pub/client/linux129.36.226.11/pub/client/linux/qtlib.tar. This is a tar from the installation on one of the development machines. The path that the library will be installed in is “usr/local/qt/lib.” This is a relative path. Once the file is untarred, you will need to copy “libqt.so.2.2.2” to a directory in your path, update “ld.so.conf” or add the new directory to your environment path variable. The Linux client requires that X ( libX11.so.6, libXext.so.6 ) and the GNU C libraries ( libc.so.6, libm.so.6, libstdc++-libc6.1-1.so.2 and ld-linux.so.2 ) are installed. If you need to obtain any of these packages and they are not on your distribution you can check “rpmfind.net.” The files for your distribution can be located by selecting the package under the required heading.

Is there a way to restore the phone list to the version I had before I did an update? If the files with the telephone numbers are received in an unusable state, the current version is renamed after the download of the latest version completes. To manually restore the files delete “/$Home/attdial/etc/phone3.dat” and “/$Home/attdial/etc/country3.dat,” then rename “/opt/attdial/etc/phone3.bak” to “/opt/attdial/etc/phone3.dat” and “/opt/attdial/etc/country3.bak” to “/opt/attdial/etc/country3.dat.” If the client has been installed in a directory other the default, then “/opt” will have to be replaced with the installation directory.

Can I have multiple users use the client? Different users can run the Linux client; each would have the user dependent files in their own home directory. It is not setup to have more than one user under a single Linux user however; I think you could write a quick little shell script that could do this. Thanks to Frederic Mora for the following script. (Note: The “agn_runasroot2” he refers to is a script provided by the IBM group that distributes the client to their users.) Yes, swapping these files works. I wrote a “SwapProfiles.sh” script that does the job cleanly. It is meant to be a wrapper of the agndialer exec invoked from “agn_runasroot2.” Feel free to use/redistribute it. I place this code under the LGPL license, i.e., you can use it even within closed source programs. This script requires a small change in agn_runasroot2 to insert the call to “SwapProfiles.sh.” $ diff agn_runasroot2 agn_runasroot2.orig < su - root -c "DISPLAY=$DISPLAY; export DISPLAY; /opt/attdial/SwapProfiles.sh $1" --- > su - root -c "DISPLAY=$DISPLAY; export DISPLAY; $1 >/dev/null" (“agn_runasroot2” is my modified version, “agn_runasroot2.orig” is the one packaged with the client) Please find below the “SwapProfiles.sh” script. Make it executable, put it in “/opt/attdial,” and change the variables at the top if the client installation directory is different. Don't forget to change the “agn_runasroot2” script as described above.



Usage notes: 1. “SwapProfiles.sh” interactively prompts the user to select a profile or save the current one if needed. A profile, in that case, is a set of files (currently “dialer.ini” and “wvdial.conf”) kept in a subdir of “/root/.attdial/profiles.” 2. If “SwapProfiles.sh” detects that the current profile has been changed (e.g., the user ran the configuration tool), the script asks for the name of a new profile. Say the user answers foo. “SwapProfiles.sh” creates a new subdir “/root/.attdial/profiles/foo” and copies the current “dialer.ini” and “wvdial.conf” to that new subdir. 3. At the next invocation of “SwapProfiles.sh,” that new profile foo is listed with the other profiles. #! /bin/sh # This interactive script allows the user to select a profile among # existing profiles saved in subdirs of $ProfileDir. # Then it calls he exec passed as arg 1. # Needs to be called from agn_runasroot2 # LICENSE INFO: # Copyright (C) 2001 Frederic Mora - fred at engineer.com # This code is placed under the LGPL license. # Permission is granted to use and redistribute provided that this # copyright notice is intact. #set -x ## DEBUG # Change this to profile dir DialerBaseDir=/root/.attdial ProfileDir=$DialerBaseDir/profiles # Files to save (files that compose a profile) declare -a FilesToSave FilesToSave=(dialer.ini wvdial.conf) # Arg 1 = name of dialer prog to execute. DialerExec=$1 # Create array of existing profiles directory declare -a ProfPathList declare -a ProfNameList ProfPathList=($(echo $ProfileDir/*)) NumProf=${#ProfPathList[*]} NumFilesToSave=${#FilesToSave[*]} # Build array of profile basenames for (( i = 0; i < NumProf; i = i + 1)) do ProfNameList[i]=$(basename ${ProfPathList[$i]}) done # Display list and prompt user echo "Please choose a profile among the following." PS3="Choose a profile (enter a number from 1 to $NumProf): " select ans in ${ProfNameList[*]} do echo "Selected profile: $ans" # Check that current profile is saved somewhere # by comparing the FilesToSave with each dir saved=0 for p in ${ProfNameList[*]} do




for f in ${FilesToSave[*]} do # Compare file quietly if ( cmp -s $DialerBaseDir/$f $ProfileDir/$p/$f ) then (( saved = saved + 1 )) fi done # for FilesToSave if (( saved == NumFilesToSave )) then break else saved=0 fi done # Warn user if current profile is nowhere in $ProfileDir if (( saved == 0 )) then echo "The current profile does not appear to be saved anywhere!" echo "Please enter a new name for that profile:" read ans2 mkdir $ProfileDir/$ans2 for f in ${FilesToSave[*]} do cp $DialerBaseDir/$f $ProfileDir/$ans2 done else echo "The current profile was $p" fi # Swap profile files echo "Switching to profile $ans" for f in ${FilesToSave[*]} do cp $ProfileDir/$ans/$f $DialerBaseDir done break done # Run attdialer $DialerExec

Documents

Linux Guide