home *** CD-ROM | disk | FTP | other *** search
/ Enter 1999 October / ENTER10_1.bin / OS2 / PLUGIN / readme.icp < prev    next >
Encoding:
Text File  |  1999-07-14  |  21.0 KB  |  586 lines
  1. OS/2(R) Plug-in Pack v. 3.0 (Beta version)
  2. Installation and Configuration README
  3.  
  4. This README file contains the information about installing and 
  5. configuring the feature. 
  6.  
  7. Note: To help you locate information in this README, you can use
  8.       the Find option under the Edit menu of the OS/2 System
  9.       Editor. You can print the file by dragging it to your
  10.       printer object or by selecting Print from the file object's 
  11.       pop-up menu. Using the right mouse button, click the object
  12.       to display the pop-up menu.
  13.  
  14. In the following sections, Netscape Communicator refers to Netscape 
  15. Communicator 4.61 for OS/2 Warp and Plug-in Pack refers to OS/2
  16. Plug-in Pack v. 3.0.
  17.  
  18. CONTENTS
  19. __________________________________________________________________
  20.      
  21. 1.0 Installation
  22. 2.0 Plug-in Support
  23. 3.0 OS/2 MPEG Support
  24. 4.0 CID Installation Information
  25. 5.0 Notices
  26.  
  27. 1.0 INSTALLATION
  28. __________________________________________________________________
  29.  
  30. The following sections describe installing the Plug-in Pack. 
  31. Be sure that you have installed Netscape Communicator before 
  32. installing the Plug-in Pack.
  33.  
  34. 1.1 Hardware and Software Requirements
  35. ------------------------------------------------------------------
  36.  
  37. Hardware Requirements:
  38.  
  39. At least 2.5 MB of free hard disk space and 10 MB of temporary 
  40. disk space.
  41.  
  42. Note: If you plan to use IBM(R) MPEG support, see section 3.0 
  43. OS/2 MPEG Support.
  44.      
  45. Software Requirements:
  46.  
  47. Netscape Communicator 4.61 for OS/2 Warp
  48.  
  49. The OS/2 Plug-in Pack v. 3.0 is installable on the following 
  50. operating systems:
  51.  
  52.   o OS/2 Warp 4
  53.  
  54.   o OS/2 Warp Server Version 4
  55.  
  56.   o OS/2 Warp Server Advanced Version 4
  57.  
  58.   o OS/2 Warp Server Advanced SMP Feature
  59.  
  60.   o OS/2 Warp Server for e-business
  61.  
  62. 1.2 Installing the Plug-in Pack
  63. ------------------------------------------------------------------
  64.  
  65. For information on CID installations, see section 4.0 CID 
  66. Installation Information.
  67.  
  68. After you have installed Netscape Communicator, you can install 
  69. the Plug-in Pack.
  70.  
  71. Note:  If you plan to use Microsoft(R) Windows(R) 3.1 Plug-ins, 
  72.        install the Plug-in Pack into a directory with a name 
  73.        no more than 8 characters long.
  74.  
  75. To install the Plug-in Pack using the graphical user 
  76. interface (GUI):
  77.  
  78.   1. Open the folder where you downloaded the os2pip30.exe file.
  79.  
  80.   2. Double-click os2pip30.exe to unpack the files for 
  81.      installing the Plug-in Pack.
  82.  
  83.   3. Double-click install.exe to start the installation.
  84.  
  85.   4. Follow the online instructions.
  86.  
  87.      o If you have previously installed the OS/2 Plug-in Pack v. 
  88.        2.1, during the installation you are asked the following
  89.        question:
  90.  
  91.                    EPFIQ139: 'x:\MMOS2\DLL\MMPLUGS.DLL' already exists on the workstation. 
  92.                    Do you want to replace the file?
  93.  
  94.                    (where x: is the drive where OS/2 is installed and MMOS2\DLL\MMPLUGS.DLL 
  95.                    is one of several plug-in files)
  96.  
  97.                    Click Yes to All when asked.
  98.  
  99.   5. Shut down and restart your operating system.
  100.  
  101.  
  102. To install the Plug-in Pack from the command line:
  103.  
  104.   1. From a command line, change to the directory where you
  105.      downloaded the os2pip30.exe file.
  106.  
  107.   2. Type os2pip30 to unpack the files for installing the Plug-in 
  108.      Pack.
  109.  
  110.   3. Type INSTALL to start the installation.
  111.  
  112.   4. Follow the online instructions.
  113.  
  114.   5. Shut down and restart your operating system.
  115.  
  116.  
  117. 1.3 Uninstalling a Previously Installed Version
  118. ------------------------------------------------------------------
  119.  
  120. If you have more than one version of the OS/2 Plug-in Pack 
  121. installed and you want to uninstall one or more versions but not 
  122. all versions, you must update the version of the Plug-in Pack 
  123. that remains on your system. This update is required because the 
  124. uninstall procedure deletes some of the files used by all versions 
  125. of the Plug-in Pack.
  126.  
  127. After uninstalling any version, you must update the version of 
  128. the Plug-in Pack that remains on your system. 
  129.  
  130. To update the Plug-in Pack, follow the instructions in section
  131. 1.2 Installing the Plug-in Pack. Click Update the Currently 
  132. Installed Product when prompted.
  133.   
  134. 2.0 PLUG-IN SUPPORT
  135. __________________________________________________________________
  136.  
  137. The following sections describe some of the plug-ins provided in
  138. the Plug-in Pack.
  139.  
  140. 2.1 OS/2 Multimedia Plug-ins
  141. ------------------------------------------------------------------
  142.  
  143. The native OS/2 Multimedia Plug-ins in this package provide 
  144. support for multimedia MIME Types and file extensions such as 
  145. .mpg, .avi, .voc, .aif, .wav, .MID, and many others.
  146.  
  147. The OS/2 Multimedia Plug-ins provide support for streaming 
  148. multimedia. Certain files that support streaming can be played 
  149. while they are downloaded. A Multimedia Internet Manager program is 
  150. provided to access these files and it can be started from the 
  151. System setup folder after you install the plug-ins. The 
  152. Multimedia Internet Manager stores temporary files in 
  153. [X:]\MMOS2\INETTEMP (where X is the drive where multimedia 
  154. support is installed).
  155.  
  156. Note: When files are downloaded using the native OS/2 Multimedia 
  157.       Plug-ins, they are not deleted by the system even after you 
  158.       have exited Netscape Communicator. This can cause additional
  159.       disk space to be consumed. The Multimedia Internet Manager
  160.       in the System Setup folder allows you to remove some or
  161.       all of these files as well as change the directory that 
  162.       contains this multimedia data.
  163.  
  164.  
  165. 2.2 Windows(R) 3.1 Plug-ins
  166. ------------------------------------------------------------------  
  167.  
  168. When you install a Windows 3.1 plug-in, change the default 
  169. directory for installation to 
  170.  
  171. x:\netscape\PROGRAM\WIN16\PLUGINS
  172.  
  173. where x:\netscape are the drive and directory where you installed 
  174. Netscape Communicator.
  175.  
  176. Some Windows 3.1 plug-ins require specific installation steps:
  177.  
  178.   o Shockwave: The Shockwave installer should be run from
  179.                WIN-OS/2 File Manager or from the Program Manager
  180.                command line. After installation is completed, 
  181.                exit Program Manager.
  182.  
  183.   o Sizzler:   Sizzler displays a test window for an extended
  184.                period of time the first time it is used. A Timeout
  185.                message box might display. Click Retry until the 
  186.                test window completes its test.
  187.  
  188. If you prefer not to use the Windows 3.1 Plug-ins support after 
  189. installation, delete the Windows 3.1 Plug-in Support component 
  190. using the Plug-in Pack installation utility in the directory 
  191. where you installed Netscape Communicator.
  192.  
  193. To delete the Windows 3.1 Plug-in Support:
  194.  
  195.   1. Double-click the Installation Utility located in the 
  196.      folder where you extracted the os2pip21.exe file.
  197.  
  198.   2. Click Windows 3.1 Plug-in Support, and then click delete.
  199.  
  200.   3. Shut down and restart your operating system.
  201.  
  202.  
  203. 3.0 IBM MPEG SUPPORT
  204. __________________________________________________________________
  205.  
  206. The IBM MPEG support includes software MPEG video file playback 
  207. that does not require special MPEG hardware.
  208.  
  209. 3.1 Recommended Hardware Configuration
  210. ------------------------------------------------------------------
  211.  
  212. A Pentium(R) or compatible microprocessor is required. Software 
  213. MPEG support can be used with a 486 microprocessor, but the video 
  214. quality is minimal.
  215.  
  216. Software MPEG audio support is available, but performs best on 
  217. systems with a Pentium or compatible microprocessor at 90MHz or
  218. higher.
  219.  
  220. Hardware MPEG audio is supported with IBM Mwave(R) cards or 
  221. REALmagic cards.
  222.  
  223. MPEG hardware is used transparently, if it is available. An 
  224. updated REALmagic driver set is provided and installable if the 
  225. hardware configuration includes the REALmagic drivers. These 
  226. drivers should not be installed unless the hardware exists in 
  227. the machine where the drivers are being installed. For hardware 
  228. video support, VSDOM1.INI must be installed in the \MMOS2 
  229. directory. Using the OS/2 Multimedia MPEG Support installation, 
  230. select the MPEG card installed in the system.
  231.  
  232. A 2-speed CD-ROM drive that supports long reads is required to 
  233. play CD-i or Video CD content. Some OS/2 CD-ROM drivers do not 
  234. support the long reads that CD-i requires. CD-i content is not 
  235. readable through the file system. Playing this content requires a 
  236. dummy file named _VIDCDI.MPG. Playback quality is very choppy for
  237. polling CD-ROMs.
  238.  
  239. 3.2 Configurations with Existing MPEG Hardware Support
  240. ------------------------------------------------------------------
  241.  
  242. To configure OS/2 Multimedia MPEG Support to be used as the 
  243. default hardware MPEG device:
  244.  
  245.   1. In the Multimedia Setup, on the Association page for the
  246.      existing MPEG hardware, select the MPEG data type and remove 
  247.      all current extensions.
  248.  
  249.   2. On the OS/2 Multimedia MPEG Support Association page, select 
  250.      the MPEG data type and add the following extensions:
  251.      MPG, CDI, VBS, DAT, M1T, M2T, M2P.
  252.  
  253. 3.3 Installing MPEG Hardware
  254. ------------------------------------------------------------------
  255.  
  256. OS/2 Multimedia MPEG Support installs hooks for the following 
  257. hardware devices:
  258.  
  259.   o  ThinkPad(R) 760CD MPEG
  260.  
  261.   o  ThinkPad 760ED MPEG
  262.  
  263.   o  Sigma Designs REALmagic
  264.  
  265.   o  Sigma Designs REALmagic Pro
  266.  
  267.   o  Visual Circuits ReelTime
  268.  
  269. If MPEG hardware is installed after the Plug-in Pack is installed, 
  270. the VSDOM1.INI file must be created by running the MKVSDINI.CMD 
  271. file in the \MMOS2 directory. For new MPEG hardware not in the 
  272. preceding list, modify the MKVSDINI.CMD file with the appropriate 
  273. PDD and VSD DLL. The PDD and VSD are defined in the MMPM2.INI file. 
  274. Do not include the $ character for the PDD.
  275.  
  276. In addition, if the DSP requires special loading, use the 
  277. appropriate numbers for the .dsp field to signify the following:
  278.  
  279.   o 1 Load DSP Only
  280.  
  281.   o 2 Load With MPEG Stream Info
  282.  
  283. 3.4 Backward Compatibility for MCI applications
  284. ------------------------------------------------------------------
  285.  
  286. A video Media Control Device (MCD) is provided for backward 
  287. compatibility for existing applications that utilize the Media 
  288. Control Interface (MCI). This means the existing media player 
  289. provided with OS/2 Multimedia can be used to play MPEG content.
  290.  
  291.  
  292. 3.5 MPEG Limitations
  293. ------------------------------------------------------------------
  294.  
  295.   o MPEG-2 Transport streams with buffered play works only with 
  296.     188 byte size buffers. All others are rejected.
  297.  
  298.   o Playback from content on slow CD-ROMS (less than 4X) results 
  299.     in poor video playback quality.
  300.  
  301.   o If audio fails to play:
  302.  
  303.       1. Open the Multimedia Setup notebook in the System Setup 
  304.          folder. 
  305.  
  306.       2. Click the OpenMPEG tab to go to the OpenMPEG page.
  307.  
  308.       3. Select Software Only.
  309.  
  310.     This change could be necessary for workstations using 
  311.     Audiovation sound cards.
  312.  
  313.   o To improve software MPEG performance, go to the OpenMPEG page 
  314.     in the Multimedia Setup notebook and change the 
  315.     synchronization factor to greater than 40 or to the maximum. 
  316.     (This slider is not proportional in changes.) Increasing the 
  317.     synchronization factor decreases the video quality but 
  318.     improves CPU performance so that software MPEG is not taking 
  319.     the maximum out of the CPU. This synchronization factor has 
  320.     no effect on hardware MPEG performance.
  321.  
  322.   o Video CD and CD-i content is supported with Software Video CD 
  323.     in the Multimedia folder. Systems with MPEG hardware, such as 
  324.     a ThinkPad 760, might have Video CD Player. This allows Video 
  325.     CD to run through the existing MPEG device. If Software Video 
  326.     CD is used on systems with MPEG hardware, OS/2 Multimedia MPEG 
  327.     Support attempts to play the content using hardware. Use the
  328.     Software Video CD if the system has been customized with OS/2 
  329.     Multimedia MPEG Support as the default MPEG device.
  330.  
  331.  
  332.  
  333. 4.0  CID INSTALLATION INFORMATION
  334. __________________________________________________________________
  335.  
  336. CID installation is accomplished by using response files to install 
  337. the Plug-in Pack in a CID environment.
  338.  
  339. A response file is a flat ASCII file that consists of a series of 
  340. lines separated by newline sequences (0x0A, 0x0D, or a combination 
  341. of these two sequences). 
  342.  
  343. Each line in a response file has a maximum line length of 255 
  344. bytes. 
  345.  
  346. A response file has two kinds of lines: 
  347.  
  348.   o Comment lines contain only white space characters or have 
  349.     either an asterisk (*) or a semicolon (;) as the first nonwhite 
  350.     space character on the line. 
  351.  
  352.   o Response lines are used by Software Installer to determine 
  353.     the options and configurations to install on the target 
  354.     system. 
  355.  
  356. Response lines have the following syntax: 
  357.  
  358. keyword = value
  359.     
  360.   o Keywords cannot contain imbedded spaces. 
  361.  
  362.   o Keywords are not case-sensitive. 
  363.  
  364. You can group keywords together in value lists using the following 
  365. syntax: 
  366.  
  367.     keyword = (
  368.                keyword1 = value
  369.                keyword2 = value
  370.                .
  371.                .
  372.                keywordn = value
  373.               )
  374.     
  375.   
  376. Keyword-value pairs used in a response file can be in any order. 
  377. However, only one pair is allowed per line. 
  378.  
  379. If you use any keyword names other than the supported keywords, 
  380. they are treated as installation variables. For example, 
  381. MONITOR = VGA creates a installation variable with the name of 
  382. MONITOR and a value of VGA.
  383.  
  384. Note: Do not use quotes around the component name, even when the 
  385. name is more than one word with blanks between words. 
  386.  
  387. 4.1 Sample Response File
  388. ------------------------------------------------------------------
  389.  
  390. The following command is an example of the command needed to start
  391. a response file installation of the Plug-in Pack:
  392.  
  393. INSTALL /X /A:I /NMSG /O:DRIVE /R:responsefile /L2:outputfile
  394.  
  395. The following is an example of a response file used to install 
  396. OS/2 Plug-in Pack v. 3.0 in a US English environment: 
  397.  
  398. Sample Response File
  399.  
  400.       COMP         = OS/2 Multimedia Plug-Ins for Netscape Communicator
  401.       COMP         = 16-bit Plug-In Support for Netscape Communicator
  402.       COMP         = OS/2 Multimedia MPEG Support
  403.       CFGUPDATE    = AUTO
  404.       DELETEBACKUP = NO
  405.       OVERWRITE    = YES
  406.       SAVEBACKUP   = NO
  407.       NAV_PRESENT  = TRUE
  408.  
  409. 4.2 OS/2 Plug-in Pack v. 3.0 keywords
  410. ------------------------------------------------------------------
  411.  
  412. The following response file keyword is required to install the 
  413. Plug-in Pack in a CID environment. The possible values for the 
  414. keyword are TRUE or FALSE:
  415.  
  416.      NAV_PRESENT - Netscape Communicator 4.61 for OS/2 Warp has 
  417.                    been already installed
  418.  
  419. Notes:
  420.  
  421.   o The FILE keyword should point to the directory where 
  422.     Netscape Communicator was installed. 
  423.  
  424.     For example:
  425.  
  426.     FILE = C:\NETSCAPE
  427.  
  428.   o The AUX1 keyword should print to the directory where OS/2 
  429.     Multimedia was installed. 
  430.  
  431.     For example:
  432.  
  433.     AUX1 = C:\MMOS2
  434.  
  435.   o The value given in the COMP keyword in the response file must 
  436.     exactly match the string specified by the NAME keyword of the 
  437.     COMPONENT entry of the .PKG file. Refer to the OS2PIP21.PKG 
  438.     file at approximately line 125 for the OS/2 Multimedia 
  439.     Plug-ins, 295 for the 16-bit Plug-in Support, and 370 for the 
  440.     OS/2 Multimedia MPEG Support for the possible component names 
  441.     to specify.
  442.  
  443. 5.0  NOTICES
  444. __________________________________________________________________
  445. This information was developed for products and services offered 
  446. in the U.S.A. IBM may not offer the products, services, or 
  447. features discussed in this document in other countries. Consult 
  448. your local IBM representative for information on the products and 
  449. services currently available in your area. Any reference to an IBM
  450. product, program, or service is not intended to state or imply 
  451. that only that IBM product, program, or service may be used. Any 
  452. functionally equivalent product, program, or service that does not 
  453. infringe any IBM intellectual property right may be used instead. 
  454. However, it is the user's responsibility to evaluate and verify the
  455. operation of any non-IBM product, program, or service. 
  456.  
  457. IBM may have patents or pending patent applications covering 
  458. subject matter in this document. The furnishing of this document 
  459. does not give you any license to these patents. You can send 
  460. license inquiries, in writing, to: 
  461.  
  462. IBM Director of Licensing
  463. IBM Corporation
  464. North Castle Drive
  465. Armonk, NY 10504-1758 
  466. U.S.A.
  467.  
  468. For license inquiries regarding double-byte (DBCS) information, 
  469. contact the IBM Intellectual Property Department in your country 
  470. or send inquiries, in writing, to: 
  471.  
  472. IBM World Trade Asia Corporation Licensing
  473. 2-31 Roppongi 3-chome, Minato-ku
  474. Tokyo 106, Japan
  475.  
  476. The following paragraph does not apply to the United Kingdom or 
  477. any other country where such provisions are inconsistent with 
  478. local law:
  479.  
  480. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  481. KIND. IBM AND NETSCAPE DISCLAIMS ALL WARRANTIES, WHETHER
  482. EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE
  483. IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
  484. MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS
  485. DOCUMENT. BY FURNISHING THIS DOCUMENT, NETSCAPE
  486. COMMUNICATIONS GRANTS NO LICENSES TO ANY PATENTS OR
  487. COPYRIGHTS.
  488.  
  489. Some states do not allow disclaimer of express or implied 
  490. warranties in certain transactions, therefore, this statement may 
  491. not apply to you. 
  492.  
  493. This information could include technical inaccuracies or 
  494. typographical errors. Changes are periodically made to the 
  495. information herein; these changes will be incorporated in new 
  496. editions of the information. IBM may make improvements and/or 
  497. changes in the product(s) and/or the program(s) described in this 
  498. information at any time without notice. 
  499.  
  500. Any references in this information to non-IBM Web sites are 
  501. provided for convenience only and do not in any manner serve as an 
  502. endorsement of those Web sites. The materials at those Web sites 
  503. are not part of the materials for this IBM product and use of 
  504. those Web sites is at your own risk.
  505.  
  506. IBM may use or distribute any of the information you supply in any 
  507. way it believes appropriate without incurring any obligation to 
  508. you.
  509.  
  510. Licensees of this program who wish to have information about it 
  511. for the purpose of enabling: (i) the exchange of information 
  512. between independently created programs and other programs 
  513. (including this one) and (ii) the mutual use of the information 
  514. which has been exchanged, should contact: 
  515.  
  516. IBM Corporation
  517. Department LZKS
  518. 11400 Burnet Road
  519. Austin, TX 78758
  520. U.S.A.
  521.  
  522. Such information may be available, subject to appropriate terms 
  523. and conditions, including in some cases, payment of a fee. 
  524.  
  525. The licensed program described in this document and all licensed 
  526. material available for it are provided by IBM under terms of the 
  527. IBM Customer Agreement, IBM International Program License 
  528. Agreement or any equivalent agreement between us. 
  529.  
  530. Any performance data contained herein was determined in a 
  531. controlled environment. Therefore, the results obtained in other 
  532. operating environments may vary significantly. Some measurements 
  533. may have been made on development-level systems and there is no 
  534. guarantee that these measurements will be the same on generally 
  535. available systems. Furthermore, some measurement may have been 
  536. estimated through extrapolation. Actual results may vary. Users 
  537. of this document should verify the applicable data for their 
  538. specific environment. 
  539.  
  540. Information concerning non-IBM products was obtained from the 
  541. suppliers of those products, their published announcements or 
  542. other publicly available sources. IBM has not tested those 
  543. products and cannot confirm the accuracy of performance, 
  544. compatibility or any other claims related to non-IBM products. 
  545. Questions on the capabilities of non-IBM products should be 
  546. addressed to the suppliers of those products. 
  547.  
  548. All statements regarding IBM's future direction or intent are 
  549. subject to change or withdrawal without notice, and represent 
  550. goals and objectives only. 
  551.  
  552. 5.1 Trademarks
  553. ------------------------------------------------------------------
  554.  
  555. The following terms are registered trademarks of the IBM 
  556. Corporation in the United States or other countries or both:
  557.  
  558.   o IBM
  559.  
  560.   o OS/2
  561.  
  562.   o ThinkPad
  563.  
  564.   o Mwave
  565.  
  566. The following are trademarks of other companies:
  567.  
  568. Netscape, Netscape Navigator, and the Netscape N logo are 
  569. registered trademarks of Netscape Communications Corporation in 
  570. the United States and other countries. Netscape Collabra, Netscape 
  571. Composer, Netscape Messenger, and Netscape Communicator are also 
  572. trademarks of Netscape Communications Corporation, which may be 
  573. registered in other countries.
  574.  
  575. Microsoft and Windows are registered trademarks of Microsoft 
  576. Corporation.
  577.  
  578. Pentium is a registered trademark of Intel Corporation in the US 
  579. and other countries.
  580.  
  581. Other company, product, and service names may be trademarks or 
  582. service marks of others.
  583.  
  584. (C) Copyright International Business Machines (IBM) Corporation and
  585. Netscape Communications Corporation 1995, 1999. All rights reserved.
  586.