Linux Guide

For Linux
AT&T Global Network Client for Linux Version 1.03.4 Draft
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
Users Guide
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 Whats 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
Users Guide
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.
Page iv
Users Guide
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
Page v
Users Guide
Dual Access Fixed IP 3D Other network applications (eg: VPN software) may be run along side the Linux client for a complete connectivity solution.
Page vi
Users Guide
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.
Page 1
Users Guide
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
Page 2
Users Guide
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 any configuration file upgrades are required, these will be made the first time you start the client.
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
Page 3
AT&T Global Network Client for Linux Additional Installation Information

Directory /opt/attdial/backup /opt/attdial/bin
Users Guide
/opt/attdial/etc /opt/attdial/help /opt/attdial/original /$HOME/.attdial
Contents previous release when upgrading (restore source - future) 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. data files, phone and country lists (country3.dat, phone3.dat) help files, license agreement, change history (*.html, *.png, legal.html, history.txt) dynamic backup of ip-up.local, resolv.conf and options.ttyXX user versions of wvdial.conf and attdial.ini and the trace log file dialer.log
Page 4
Users Guide
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
Page 5
Users Guide Running the Configuration Tool Using the Menu

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
Page 6
AT&T Global Network Client for Linux User Field Descriptions

Input Item Account User Password
Users Guide
Description Enter the account you have been given to access the AT&T Global Network. Enter the user identification you have been given to access the AT&T Global Network. 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: Save the information on every page and exit the dialog. OK 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.
Page 7
AT&T Global Network Client for Linux 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
Users Guide
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/ModemHOWTO.html.
Figure 10: Configuration Modem Tab
Modem Field Descriptions

Input Item Modem Port Modem Speed Initialization String 1 Initialization String 2 Auto Detect Description Enter name of port that has your modem connection. Enter the speed of your modem. Enter any special modem initialization strings needed by your modem. Enter any special modem initialization strings needed by your modem. You may click the auto detect button if you want the client to attempt to automatically configure the modem.
Page 8
Users Guide
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 County/Region Description 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. 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. Edit the number for any required prefix. 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.
Phone Number Dialable Number Customer Support Number
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
Page 9
AT&T Global Network Client for Linux Exits Tab

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

Input Item Delete the default route prior to connect Description 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. 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. 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. Selecting this check box will cause the client to launch Netscape after the connection completes. 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. 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.
Restore the default route after disconnect Default route IP address
Launch Netscape after connect Call user exit 1 before connecting
Call user exit 2 after connected
Page 10

Call user exit 3 after disconnect
Users Guide
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.
Page 11
Users Guide
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
Page 12
AT&T Global Network Client for Linux 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.
Users Guide
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
Page 13
Users Guide
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 reenter 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.
Page 14
Users Guide
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
Page 15
AT&T Global Network Client for Linux 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.
Users Guide
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.
Page 16
Users Guide
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
Page 17
Users Guide
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 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 24: Disconnect Using Menus - Main Window
Page 18
Users Guide
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
Page 19
Users Guide
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
Page 20
AT&T Global Network Client for Linux Getting Help
Users Guide
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. Whats 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 whats 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 ALTSHIFT-F1.
Page 21
AT&T Global Network Client for Linux Customer Support Window
Users Guide
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
Page 22
AT&T Global Network Client for Linux Whats this? Option
Users Guide
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
Page 23
Users Guide
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
Page 24
Users Guide
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
Page 25
Users Guide
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
Page 26
Users Guide
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. 2. 3. 4. 5. Create a directory name /usr/lib/qt/lib Edit ld.co.conf and change /usr/lib/qt-2.1.0/lib to /usr/lib/qt/lib Download qt211.tar from one of the AT&T ftp servers list on the main Linux client page Extract the contents of qt211.tar to /usr/lib/qt/lib 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).
Page 27
Users Guide
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. 2. 3. 4. 5. Right click on the Gnome desktop and select New->Launcher. Enter a name in the Name field. This is the name that will appear on the desktop. Enter attdial in the Command field. Optionally you may select an icon by clicking on the No Icon button. 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. 2. 3. 4. Selecting "index by Name" Selecting "Packages beginning with letter Q" Selecting "Linux/i586" at the right of the "qt2-2.2.2-2mdk" entry Selecting "libqt.so.2" under the Provides heading on the page qt-2.2.2-2.i386 qt-2.2.2-2.i386 qt-2.2.2-2.alpha qt-2.2.2-2.sparc qt2-2.2.2-2mdk.i586 The shared library for the Qt GUI toolkit. The shared library for the Qt GUI toolkit. The shared library for the Qt GUI toolkit. The shared library for the Qt GUI toolkit. Shared library for the Qt2 GUI toolki KDE Stable RawHide 1.0 for i386 RawHide 1.0 for Alpha RawHide 1.0 for Sparc Mandrake Cooker
Page 28
Users Guide
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.
Page 29

Usage notes:
Users Guide
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
Page 30

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
Users Guide
Page 31

Linux Guide

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Linux Guide

Uploaded by

Copyright:

Available Formats

For Linux

AT&T Global Network Client for Linux Version 1.03.4 Draft

2002, AT&T Corporation, All rights reserved

AT&T Global Network Client for Linux

AT&T Global Network Client for Linux

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

How to Use This Guide

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

Downloading the AT&T Global Network Client for Linux

Figure 1: FTP Download GUI

Making the File Executable

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

Installing the AT&T Global Network Client for Linux

Software License Agreement Window

Figure 2: Software License Agreement Window

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

Figure 3: Installation Window

Figure 4: Installation Complete

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux Additional Installation Information

/opt/attdial/etc /opt/attdial/help /opt/attdial/original /$HOME/.attdial

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

Running the Configuration Tool

Running the Configuration Tool Using the Icon

Figure 6: Main Window

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

Users Guide Running the Configuration Tool Using the Menu

Figure 7: Main Window Using the Menu

Figure 8: Configuration Window User Tab

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux User Field Descriptions

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux DNS Tab

Modem Field Descriptions

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

Figure 11: Configuration Connection Tab

Connection Field Descriptions

Phone Number Dialable Number Customer Support Number

Figure 12: Configuration Trace Tab

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux Exits Tab

Figure 13: Configuration Exits Tab

Exits Tab Descriptions

Restore the default route after disconnect Default route IP address

Launch Netscape after connect Call user exit 1 before connecting

Call user exit 2 after connected

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

2002, AT&T Corporation, All rights reserved.

AT&T Global Network Client for Linux

Main Menu Options

Figure 15: Main Window Using Icon to Connect

2002, AT&T Corporation, All rights reserved.