For Linux AT&T Global Network Client for Linux Version 1.03 build 04 Draft

Transcription

1 For Linux AT&T Global Network Client for Linux Version 1.03 build 04 Draft 2002, AT&T Corporation, All rights reserved

2 Welcome...3 How to Use This Guide...3 Distribution...4 Installation Checklist...4 Installation...6 Additional Installation Information...8 Uninstalling...9 Configuration...10 Running the configuration tool...10 User tab...11 DNS tab...12 Modem tab...12 Connection tab...13 Trace tab...13 Exits tab...13 Operation...15 Starting the AT&T Global Network Dialer for Linux...15 Connecting to AT&T Global Network...15 Password Changes...16 Software Update...17 Clearing log display window...18 Disconnecting from the AT&T Global Network...18 Ending the AT&T Global Network Dialer for Linux...19 Getting Help...20 Help menu items...20 Customer Support Window...21 Help Contents...21 What s this? Window...21 About Window...22 Problem determination aids...22 Frequently asked questions , AT&T Corporation, All rights reserved Page 2

3 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 ser vices 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, OS/2, DOS/Windows 3.1, 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 Linux Client. 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, Installation Checklist. Those sections cover prerequisites to review before you proceed. The next chapter, Installation, 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, and where to find help if problems occur. 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 3

4 System Requirements The Linux Client is supported on the following Linux distributions. Red Hat 6.2 and up Mandrake 7.0 and up SuSE 7.2 and up 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: A statically linked version of the dialer which has no special library requirements, is available. Distribution The AT&T Global Network Client for Linux can be downloaded from ftp.attglobal.net/pub/client/linux/setup The statically linked version can be downloaded from ftp.attglobal.net/pub/client/linux/static/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 Dual Access Fixed IP 3D 2002, AT&T Corporation, All rights reserved Page 4

5 Other network applications (eg: VPN software) may be run along side the connectivity, which the Linux dialer provides, to provide a complete connectivity solution. 2002, AT&T Corporation, All rights reserved Page 5

6 Installation 1. Download: Download the Linux Dialer from the AT&T Business Internet Services web ( ; Select Help Center then Download) or ftp (ftp.attglobal.net/pub/client/linux/setup) site. 2. Make it Executable: Once the file "setup" is retrieved, set the execute access permissions. The following is for those who may not be sure how to do this: 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 insure 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 not you can specify the full file name, for example chmod 777 /usr/download/setup. 3. Run 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 dialer 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. a. Installing: The first panel displayed is the license agreement. Once you have read the agreement, select the agree or disagree push button. Note: If you select Disagree, setup will terminate without installing any of the dialer files 2002, AT&T Corporation, All rights reserved Page 6

7 b. Select the Install push button. The Cancel push button will exit the installation without installing any of the dialer files. Note: It is not necessary to uninstall the dialer before installing a newer version. If any configuration file upgrades are required, these will be made the first time a user starts the dialer. c. Finally, select either Launch Dialer or Finished push button. Launch Dialer will close the installer and start the dialer. Finished will exit the installer. 2002, AT&T Corporation, All rights reserved Page 7

8 Additional Installation Information Directory /opt/attdial/backup /opt/attdial/bin /opt/attdial/etc /opt/attdial/help /opt/attdial/original /$HOME/.attdial Contents previous release when upgrading (restore source - future) dialer executable (attdial), pppd startup shells (ip-up local, ipupatt, ttypap ), dialer exit shells (attdue1.sh, attdue2.sh, attdue3.sh) and user exit shells (userexit1.sh, userexit2.sh, userexit3.sh) Note: Dialer exits shell shells exist only if the exit is enabled. User exit shells only exist if the exit is enabled and the user has provided a shell. 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 2002, AT&T Corporation, All rights reserved Page 8

9 Uninstalling To uninstall the Linux Dialer, you need to reexecute the installation setup program. 1. The first panel displayed is the license agreement. Once you have read the agreement, select the agree or disagree push button. Note: If you select Disagree, setup will terminate without removing the dialer. 2. Select the Uninstall push button. Uninstall will remove the dialer and any configuration files stored in the $home/.attdial directory of the Linux user that is running the uninstall. If the dialer is used by more than one user, the other users will have to manually remove the $home/.attdial directory and its contents. Note: It is not necessary to uninstall the dialer before installing a newer version. If any configuration file upgrades are required, these will be made the first time a user starts the dialer. 3. Finally select the Finished push button to exit the installer. 2002, AT&T Corporation, All rights reserved Page 9

10 Configuration When you start the dialer for the first time or run the dialer from a new Linux user, you will receive the following warning message: This means that this is the first time that this Linux user has used the dialer and needs to go to the configuration tool and complete at least the User, Modem, and Connection sections, before they can connect to the Network. 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 by using the icon, move the mouse pointer on top of the configuration tool icon and press the left mouse button. To start the configuration tool 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 Configure menu item 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. To start the configuration tool using the shortcut keys, press function key 4 (F4). 2002, AT&T Corporation, All rights reserved Page 10

11 User tab The user tab is used to identify the user and select the type of service. An additional window to change the Domain Name Service (DNS) names will be presented when changing the type of service. Input Item Account User Password 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 push buttons at the bottom of each configuration page are for every page in configuration dialog. Their functions are: 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. 2002, AT&T Corporation, All rights reserved Page 11

12 DNS tab The Type of Service dropdown field in the User tab of the configuration tool controls the selection of Domain Name Service (DNS) names. Select any type of service, including the current one, will cause the popup to appear. For internet, the information will be provided from the dialer although this can be changed if needed. For dual access and secureip, this information must be obtained from your network administrator. Input Item Domain Name Primary name server Secondary name server Description Enter the domain name that you have been given by your administrator. Enter the domain name that you have been given by your administrator. Enter the domain name that you have been given by your administrator. Modem tab The modem tab is used to select a modem. The auto detect feature will locate any modem attached to the system and allow the user to select the modem for the dialer to use. Input Item Modem Port Modem Speed Description Enter name of port that has your modem connection. 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 dialer to attempt to automatically configure the modem. Auto detect will attempt to locate modems on each defined device. If this is a long list then the detection process may take running for several seconds. For all the details on Linux and modems see the Modem-HOWTO. See the user tab help section for information about the buttons at the bottom of each page. 2002, AT&T Corporation, All rights reserved Page 12

13 Connection tab The connection tab is used to locate the phone number of the nearest access point. Input Item County/Region Phone Number Dialable Number Customer Support Number Description Select a country that you will be calling. If the country has regions, these an additional list will be display. Select a region within the country. Select the phone number you want to use. 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 local special dialing considerations. 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. See the user tab help section for information about the buttons at the bottom of each page. Trace tab This page is used to set the amount of detail that is displayed in the dialer log window See the user tab help section for information about the buttons at the bottom of each page. Exits tab The exits tab allows the user to perform actions a pre-defined points in the connection process. 2002, AT&T Corporation, All rights reserved Page 13

14 Input Item Delete the default route prior to connect 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 Call user exit 3 after disconnect Description Selecting this check box will cause the dialer to delete any exiting default route in the IP routing table before dialing the network. Before the route is deleted, the dialer 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 dialer 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 dialer 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 dialer to launch Netscape after the connection completes. Selecting this check box will cause the dialer to call the user written shell, userexit1.sh before connecting to the network. The script must be in the dialer bin directory. The call to this script is synchronous. The dialer 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 dialer to call the user written shell, userexit2.sh after connecting to the network. The script must be in the dialer bin directory. The call to this script is synchronous. The dialer 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. Selecting this check box will cause the dialer to call the user written shell, userexit3.sh after disconnecting from the network. The script must be in the dialer bin directory. The call to this script is synchronous. The dialer 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. See the user tab help section for information about the buttons at the bottom of each page. 2002, AT&T Corporation, All rights reserved Page 14

15 Operation Starting the AT&T Global Network Dialer for Linux The name of the AT&T Global Network Dialer for Linux executable is attdial. The executable is installed in the directory /opt/attdial/bin. The installation directory can be changed when running the setup program. If the default directory is changed then the location of the executable will be the (directory name)/attdial/bin. If this is the first time the current user has run attdial, a popup message will be displayed tell the user to run the Configuration tool. Connecting to AT&T Global Network A connect to the AT&T Global Network can be made from the main window by using the icons, menus or shortcut keys. This option will be disabled if a connection exists. To start the connection process using the icon, move the mouse pointer on top of the connect icon and press the left mouse button. To start the connection process 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 Connect menu item 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. 2002, AT&T Corporation, All rights reserved Page 15

16 To start the connection process using the shortcut keys, press function key 2 (F2). Password Changes Passwords changes can be made prior to connecting to the Network. This option will be disabled if a connection exists. Password changes can be made from the main window menus or shortcut keys. To start the password change process using the menus, 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 and press the left mouse button. Depressing and holding the left ALT key and then pressing the S key can also open the Services dropdown menu. When using menus, the up arrow and down arrow keys may be used to select the action. To start the password change process using the shortcut keys, depress and hold the left Alt key and the left Shift key and then press the P key. Enter the new password and the verify new password in the change password window. Click OK to accept the new password or Cancel to discard the change request. 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. 2002, AT&T Corporation, All rights reserved Page 16

17 Software Update Software updates can be made after connecting to the Network. This option will be disabled if a connection does not exist. Software updates be made from the main window menus or shortcut keys. To start the software update process using the menus, 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 Software Update menu item and press the left mouse button. Depressing and holding the left ALT key and then pressing the V key can also open the Services dropdown menu. When using menus, the up arrow and down arrow keys may be used to select the action. 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. Once the software update tool is started the current and available date of the phone file and version of the program will be displayed. This process may take a few seconds. After the available version information is complete, check the checkboxes for the items you want to update and select Download. If you do not want to update any items select Exit. When the download starts 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. You may cancel the update before the download completes by selecting Cancel. 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 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 2002, AT&T Corporation, All rights reserved Page 17

18 /opt/attdial/etc/country3.dat. If the dialer has been installed in a directory other the default, then /opt will have to be replaced with the installation directory. Clearing log display window The window contain the log messages can be erased from from the main window menus or shortcut keys. 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 and press the left mouse button. Depressing and holding the left ALT key and then pressing the V key can also open the View dropdown menu. When using menus, the up arrow and down arrow keys may be used to select the action. 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. 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 the connection using the icon, move the mouse pointer on top of the Disconnect icon and press the left mouse button. 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. 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. 2002, AT&T Corporation, All rights reserved Page 18

19 To terminate a connection using the shortcut keys, press function key 3 (F3). Ending the dialer will also cause the connection to be terminated. Ending the AT&T Global Network Dialer for Linux The dialer may be ended from the main window by using the icons, menus or shortcut keys. To end the dialer using the icon, move the mouse pointer on top of the exit icon and press the left mouse button. 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 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. To exit using the shortcut keys, press function key 12 (F12). In addition to the dialer 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 initiated a dialer exit. If you have an active session when exit, you will be asked to confirm that you want to disconnect from the Network. Selecting Yes will end the session and the dialer. Selecting No will return you to the dialer window. 2002, AT&T Corporation, All rights reserved Page 19

20 Getting Help Help menu items A variety of help information is available in the AT&T Global Network Dialer for Linux. This information can be accessed from the main window by using the icons, menus or shortcut keys. To display the menu of help items, move the mouse pointer on top of the Help menu item and press the left mouse button. Depressing and holding the left Alt key and then pressing the H key can also open the Help dropdown menu. 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. 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 What s this About This will display the contents of the available help files. You can change display the contents by selecting the contents menu item in the help drop down menu or pressing F1. 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. This will display the date and version information for the dialer. You can invoke the about information selecting the about menu item in the help drop down menu or pressing ALT-SHIFT-F , AT&T Corporation, All rights reserved Page 20

21 Customer Support Window To display the Customer Support information, open the Help dropdown window, move the mouse pointer on top of the Customer Support menu item and press the left mouse button. The contents window will vary depending on type of service and location. To display the Customer Support information using the shortcut keys, depress and hold the left Alt key and the left Shift key and then press the C key. Help Contents To display the the help table of contents, open the Help dropdown window, move the mouse pointer on top of the Contents menu item and press the left mouse button. To display the the help table of contents using the shortcut keys, press function key 1 (F1). What s this? Window What's this provides a way to get additional information about and icon. What's this can be access 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 for which you want additional information. Below is an example to the additional information for the Exit icon. 2002, AT&T Corporation, All rights reserved Page 21

22 About Window To display information about the current release of the dialer, 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 dialer using the shortcut keys, depress and hold the left Alt key and the left Shift key and then press the A key. If you do need to contact customer support and you are able to start the dialer, please have the information presented in the window available to give to your customer support representative. Problem determination aids The dialer records a log of events in the file /$HOME/.attdial/dialer.log and is available after the dialer is terminated. The contents of the file are erase and a new log started each time the dialer 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. In the event of an error that causes the dialer to terminate, such as a segmentation fault, the data in the dialer.log file may be incomplete. To determine the cause to the error, run the dialer from a terminal emulator window. To do this, start a terminal emulator window by click 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. Linux logging information about the ppp deamon can be found in /var/log/syslog and /var/log/daemons/info for Mandrake /var/log/messages for RedHat /var/log/ppp for Corel 2002, AT&T Corporation, All rights reserved Page 22

23 Frequently asked questions After installing the dialer on a Red Hat 6.2 distribution, nothing happens when the dialer is selected from a file manager window. When the dialer is run from a terminal, there is a segmentation fault. NOTE: Version uses a static link of the Qt libraries. This means that problems with the Qt library levels will not be an issue. Only dialer versions that dynamic link of the Qt libraries are affected. Red Hat 6.2 is distributed with Qt beta 3. There is an error in the QImage function which 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 or greater. The following is one way to get Qt on the system. 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 dialer page. extract the contents of qt211.tar to /usr/lib/qt/lib. run ldconfig from a terminal. The dialer 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 a excerpt from Linux PPP HOWTO. If pppd refuses to set up a default route, it is because (quite correctly) it refuses 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). 2002, AT&T Corporation, All rights reserved Page 23

24 How do I create a desktop shortcut for the dialer? KDE Select the Application item in the KDE start menu. In KDE 2.0.1, this is located in Start menu->create New->Application. In the General section, change the name from Applications to ATTDial.kdelnk. The text in before.kdelnk is the text that will appear on the desktop. 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 dialer then use the directory you installed the dialer in for the fully qualified path name. Create a symbolic link for /opt/attdial/bin/attdial in one of the directories in your path. GNOME Right click on the Gnome desktop and selcet 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 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 dialer use Qt version 2 by TrollTech ( ) for the end user interface. To use the dialer you will need to have the qt 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 If the distribution you are using does not include Qt then you will need to download the runtime library. The RPM repository on niteowl ( ) has Qt for many distributions. This information was obtained by: selecting "index by Name" selecting "Packages beginning with letter Q" selecting "Linux/i586" at the right of the "qt mdk" entry selecting "libqt.so.2" under the Provides heading on the page. qt i386 The shared library for the Qt GUI toolkit. KDE Stable qt i386 The shared library for the Qt GUI toolkit. RawHide 1.0 for i386 qt alpha The shared library for the Qt GUI toolkit. RawHide 1.0 for Alpha qt sparc The shared library for the Qt GUI toolkit. RawHide 1.0 for Sparc qt mdk.i586 Shared library for the Qt2 GUI toolki Mandrake Cooker 2002, AT&T Corporation, All rights reserved Page 24

25 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 /pub/client/linux /pub/client/linux /pub/client/li nux/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 to a directory in your path, update ld.so.conf or add the new directory to your environment path variable. The linux dialer 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 requires 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 dialer has been installed in a directory other the default, then /opt will have to be replaced with the installation directory. Can I have multiple user use the dialer? (This is still being formatted ) The Linux dialer can be run by different users, 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 the IBM group that distributes the dialer 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 dialer) Please find below the SwapProfiles.sh script. Make it executable, put it in /opt/attdial, and change the variables at the top if the dialer installation directory is different. Don't forget to change the agn_runasroot2 script as described above. Usage notes: 2002, AT&T Corporation, All rights reserved Page 25

26 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 invokation of SwapProfiles.sh, that new profile foo is listed with the other profiles cut here #! /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 2002, AT&T Corporation, All rights reserved Page 26

27 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 2002, AT&T Corporation, All rights reserved Page 27