==================================================== = RS/6000 TECHNICAL LIBRARY - = = Information = = Version 3 Release 3 = = = = HTML Format = ==================================================== ---------------------------------------------------------------------------- IMPORTANT NOTICES ---------------------------------------------------------------------------- Please read Section 11 of this file for special notices about this release. ---------------------------------------------------------------------------- SECTION I. Introduction ---------------------------------------------------------------------------- Thank you for purchasing the AIX Technical Library/6000* CD. Please send email to "techlib@austin.ibm.com" with any suggestions or limitations you encounter. This CD-ROM contains all of the AIX 4.3 Documentation in HTML format. Plus, information from RS/6000 Redbooks are included with the search engine. Fixes, faxes, technical documentation, manuals and redbooks can all be searched together. In summary, the AIX Technical Library/6000 HTML CD-ROM is the largest collection of RS/6000 and AIX information available under one search engine. Here is what you can find in this README file: Section I. Introduction Section II. Accessing the AIX Technical Library Information Section 1. What is HTML, and How Do I Read HTML Files? Section 2. Why HTML and do I need an Internet Connection? Section 3. Requirements for Reading the CD Section 4. Where Can I Obtain a Web Browser? Section 5. About the Provided Search Engine Section 6. Where Can I Obtain a Search Engine? Section 7. Unmounting the CD on AIX Section 8. Deinstalling the HTML CD on AIX Section 9. Copying the HTML Files to Disk Section 10. Problem Reporting Section 11. Changes From Previous Release ---------------------------------------------------------------------------- SECTION II. Accessing the AIX Technical Library Information ---------------------------------------------------------------------------- Use one of the following methods to view the HTML files: o With Xwindows Running: - Log onto the AIX system. - Run "/usr/bin/techlib.sh" o From a remote client to the AIX machine: - Browse URL: http://[machine]:[port]/techlib/index.htm - Search URL: http://[machine]:[port]/cgi-bin/techlib?AUSSRV=[machine] Replace [machine] with the actual network name of your AIX system and [port] with the port number your Web server is listening on. o From any web browser with CD-ROM mounted on local system: - Browse URL: file:/index.htm - Search engine requires techlibd daemon running on an AIX system ---------------------------------------------------------------------------- SECTION 1. What is HTML, and How Do I Read HTML Files? ---------------------------------------------------------------------------- HTML stands for 'HyperText Markup Language', a text-formatting language used to describe how a document should be structured. In order to interpret the language, you need an application which is capable of reading hypertext language. These are commonly referred to as 'web browsers'. A web browser has the ability to take an HTML file, interpret the markup language embedded in the file, and generate a readable document for the viewer. This is a very general description of what HTML is and does, since it would take hundreds of lines to properly describe HTML and the web. It is recommended that you visit your local bookstore if you wish to learn more about this increasingly popular form of on-line publishing. For the purposes of this README, it is probably enough to understand that in order to read HTML formatted files, you will need special application software, called a web browser. However, you do not need a connection to the Internet in order to view the HTML files on this CD-ROM. A web browser can access the files on the local CD, interpret the HTML language and present the files without the need for a network or internet connection of any kind. Access to the search engine will require that TCP/IP be configured on AIX but no internet connection is necessary. ---------------------------------------------------------------------------- SECTION 2. Why HTML and do I need an Internet Connection? ---------------------------------------------------------------------------- In a continuing effort to improve our products, an HTML version is being offered. Today, the percentage of information provided in hypertext format is increasing even as you are reading this, as is the demand for information to be available in HTML format. As long as the HTML files are set up to be accessed by a web server, anyone on the network can access the information by simply pointing their web browser to the server. And, since the browser is the one who is interpreting the hypertext language, HTML is platform-independent. Many documents today are being offered in HTML format. An internet connection is not necessary to use the CD-ROM. In fact, a network card is not even necessary. The web browser can be told to read the HTML files right from the local CD-ROM drive. How does this relate to InfoExplorer, which uses a different format? With InfoExplorer, you were first required to connect to the system which had the library installed, and start up an InfoExplorer session on that system. This requires a significant amount of system resources on the server, as more and more users access the database. With HTML, since the web browser is installed on the local system, all the server has to do is provide a copy of the file to the requesting browser; it is then up to the local system's browser and resources to process the file. In addition, only the browser software is required on the viewing system; only the system providing a copy of the HTML file needs to have the server software installed. ---------------------------------------------------------------------------- SECTION 3. Requirements for Reading the CD ---------------------------------------------------------------------------- This CD has been created to support multiple platforms, from DOS to UNIX. The CD conforms to the following formats: PC CD-ROM Format: ISO 9660 UNIX CD-ROM Format: ISO 9660 with Rockridge Extension Windows 95 and NT 4.0 Format: Joliet For RS/6000's, the IBM 7210 family of CD-ROMs supports the ISO 9660 format, and will be able to read the AIX Technical Library/6000 CD. If you are using another platform, or a third party vendor CD-ROM for the RS/6000, consult with the vendor to check for compatibility. NOTE: If "ls -l" on the CD-ROM files produces errors with AIX version 3.2 then you will need to apply PTF U447693. You will also need a web browser installed on your system. Netscape Navigator is provided on the CD for AIX version 4. Some of the more common web browsers available, depending on what platform you are using, are: o Netscape Navigator ** o NCSA Mosaic *** o Microsoft Internet Explorer + o Lynx ++ (an ASCII-based web browser) The HTML files on the CD have been formatted with tables and active links within tables. Unfortunately, some older browsers do not support the full functionality of these components. As such, although the files may be viewed by these browsers, some of the functionality may be lost and the format altered. However, the basic content should still be viewable. In general, any browser which supports HTML Version 3.0 or higher will be able to utilize the full functionality of this CD. This version of the CD also includes the ability to search. In order to take advantage of this, the 'search engine' which has been included on the CD should be installed. More information about the search engine, and search engines in general, follows in sections 5 and 6. ---------------------------------------------------------------------------- SECTION 4. Where Can I Obtain a Web Browser? ---------------------------------------------------------------------------- A licensed copy of Netscape for AIX is available for the RS/6000. It is available for AIX versions 4.1.5 and higher, or 4.2.0 and higher. To check if Netscape is installed on your AIX system, run the following command: | # lslpp -l | grep -i netscape | | A copy of the Netscape Navigator for the above AIX versions has been | included with the base AIX installation media package (a separate Netscape | CD would have been included), or on the AIX Bonus Pack CD. Note that the | browser is not compatible with AIX Version 3. An alternative is to visit | the Netscape home page; a version of the browser for AIX is available. For non-AIX systems which are not equipped with web browsers, some internet sites which provide web browsers for many different platforms are another alternative: DISCLAIMER: The following sites are not officially endorsed by IBM; they are just listed here for your convenience. Usage of these products are the responsibility of the reader. The reader is not limited to the use of the products available at these download sites. o For Netscape http://home.netscape.com --- Netscape Home Page - choose the "Download" option - versions for AIX, Windows95, WindowsNT, HP, Sun, Macintosh and others available ftp[2-8].netscape.com --- Netscape anonymous ftp sites - multiple ftp servers, from ftp2.netscape.com to ftp8.netscape.com - directory is pub/navigator/ o For NCSA Mosaic http://www.ncsa.uiuc.edu --- NCSA Home Page - choose the "Software Tech" option - versions for AIX 3.2, Windows, HP, Sun, Macintosh, and others available ftp.ncsa.uiuc.edu --- NCSA anonymous ftp site - view the README file for more information o For Microsoft Internet Explorer http://home.microsoft.com/ie --- Explorer Home Page - choose the "Download" option - versions for Windows95, WindowsNT, and Macintosh available o For Lynx (a text-based browser) http://lynx.browser.org --- Lynx Home Page http://www.cc.ukans.edu/about_lynx --- another site ---------------------------------------------------------------------------- SECTION 5. About the Provided Search Engine ---------------------------------------------------------------------------- All HTML files were indexed and built into a search database using an IBM in house search engine. The binaries for this search engine only run on AIX. IBM employees are welcome to learn more about the search engine at http://miker.austin.ibm.com or see it in action at http://pitstop.austin.ibm.com. The AIX Technical Library also has an IBM internal web site at http://techlib.austin.ibm.com. These web sites are only available on the IBM internal network. For faster response time, a daemon is started at boot time from the inittab called techlibd. The search engine itself is called through http daemons. - By default the http protocol uses port 80. The http daemons included with the CD were obtained from the Apache Group at http://www.apache.org/. IBM and The Apache Group disclaim any expressed or implied warranties pertaining to the Apache software. The search html file is created at installation time and named
/search/index.html. Please send all comments and suggestions regarding the search capabilities to techlib@austin.ibm.com. ---------------------------------------------------------------------------- SECTION 6. Where Can I Obtain a Search Engine? ---------------------------------------------------------------------------- The search engine provided on the CD is compatible only with AIX. If you want to set up the AIX Technical Library/6000 with search capabilities on another platform, you will need to find a search engine which will run on that platform, and set up the database to use your search engine instead. You can research the internet for search engines. A good place to start would be by using a network search facility such as Yahoo or Alta Vista: o Yahoo http://www.yahoo.com - select "Computers and Internet" "Internet" "World Wide Web" "Databases and Searching" o Alta Vista http://www.altavista.digital.com - start with some search words such as "databases" ---------------------------------------------------------------------------- SECTION 7. Unmounting the CD on AIX ---------------------------------------------------------------------------- To unmount the AIX Technical Library CD, at the command line type: # /usr/bin/techlib.sh -unmount This will allow you to remove the CD-ROM from the drive. Note that it may be necessary to stop the web server daemons servicing AIX Technical Library first. ---------------------------------------------------------------------------- SECTION 8. Deinstalling the HTML CD on AIX ---------------------------------------------------------------------------- To de-install AIX Technical Library, at the command line type: # /usr/bin/techlib.sh -deinstall This will remove all entries from /etc/inittab and all files copied from the CD-ROM to disk during installation. ---------------------------------------------------------------------------- SECTION 9. Copying HTML Files to Disk ---------------------------------------------------------------------------- | If you do not wish to tie up your CD-ROM drive, and you have enough | free space on your hard disk, you can copy the contents of the AIX | Technical Library CD to disk, thus eliminating the need for a dedicated | CD-ROM drive. Step 1: Take note of current CD-ROM mount point. - Type "mount | grep techlib" at the command line Step 2: Unmount the HTML CD-ROM. - Type "/usr/bin/techlib.sh -unmount" at the command line Step 3: Mount the CDROM over /cdrom or any other mount point besides the mount point obtained in step 1. - See instruction booklet on mounting a CD-ROM filesystem Step 4: Copy files from CD-ROM to disk - Type "cp -R ---------------------------------------------------------------------------- SECTION 10. Problem Reporting ---------------------------------------------------------------------------- | Support Family members can call 1-800-CALL-AIX to report any | problems. All others may send email to "techlib@austin.ibm.com" to | report any installation, search engine, or general operating problems | with AIX Technical Library. ---------------------------------------------------------------------------- SECTION 11. Changes From Previous Release ---------------------------------------------------------------------------- | ********** | ATTENTION! | ********** | There have been significant changes between version 2 and version 3 of AIX | Technical Library. | | Due to the nature of the changes in this version of AIX Technical Library, | it is strongly recommended that you re-run the installation procedure to | update all necessary files if you are running a lower version of TechLib. | Please specify "no" when asked if you would like to use the existing | settings. | | The following updates/changes were made to AIX Technical Library this | release (V3R3): | | o "AIX Technical Library" has now been renamed to | "RS/6000 Technical Library - Information", and now includes an | additional component, "Software Service", which allows for the | installation of software updates (fixes). | | o If the Software Service component is installed, the ability to | install fixes chosen and saved from the "Fixes" portion of the | CD may now be implemented. | | o A new web page design has been implemented to mirror the RS/6000 | Technical Library internet site at http://techlib.services.ibm.com. | | o Links placed in the masthead (banner) require an internet connection | for access. Also, some links in the left navigation bar require an | internet connection for access. The following updates/changes were made to AIX Technical Library this release (V3R2): o No design changes have been made since the last release. The following updates/changes were made to AIX Technical Library this release (V3R1): o The installation script has been renamed from "install.sh" to "install.tl". The installation script now logs all output of an install to the file "/tmp/TLinstall.log". o The "install.tl" installation script has been equipped with a non-interactive install option, by specifying command-line arguments. To view syntax requirements, type "install.tl -h". o The "/usr/lpp/TechLib/config" configuration file syntax has changed. o The "/usr/bin/techlib.sh" command has changed to reflect the updates to the configuration file. o The ability to save a list of fileset updates, to be used for the purpose of applying updates to the system, has been included. This is for a forthcoming enhancement to AIX Technical Library. o An additional CGI directory must be declared to allow for the previous bullet's implementation. The additional directory is the "cgi_bin" directory from the CD. This must be implemented manually if you are using an existing web server. This additional directory declaration is made automatically if installing the supplied Apache web server. More details are provided during the installation. o The legal notice on the home page has been changed to a copyright notice. o A "License.txt" file has been included on the CD with licensing information. The following updates/changes were made to AIX Technical Library in V2R3: o This section has been added. o The "Faxes" HTML documents have been created using a different file naming convention. If you have bookmarked any faxes previously, these will need to be updated. o The feedback link has been changed to take you to the "Feedback" main page. From there, you may submit your comments to the IBM AIX Technical Library team. o The notice on the home page has been updated to explicitly state that the information provided by AIX Technical Library MAY NOT appear on the world wide web. _________________________________________________________________________ Trademark Information * AIX and the RS/6000 is a registered trademark of IBM. ** Netscape is a licensed trademark of Netscape Communications. *** NCSA Mosaic is a licensed trademark of The National Center for Supercomputing Applications at the University of Illinois at Urbana-Champaign. + Microsoft Internet Explorer is a licensed trademark of Microsoft Corporation. ++ Lynx is a product of the Distributed Computing Group within Academic Computing Services of The University of Kansas.