Modified: incubator/ooo/ooo-site/trunk/content/download/common/java.html URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/download/common/java.html?rev=1379766&r1=1379765&r2=1379766&view=diff ============================================================================== --- incubator/ooo/ooo-site/trunk/content/download/common/java.html (original) +++ incubator/ooo/ooo-site/trunk/content/download/common/java.html Sat Sep 1 14:57:09 2012 @@ -1,60 +1,52 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> - <title>Information for downloaders: Java & OpenOffice.org</title> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <title>Information for downloaders: Java & Apache OpenOffice, OpenOffice.org</title> </head> <body> <h1>Java & Apache OpenOffice, OpenOffice.org</h1> -<p>Java is required for complete OpenOffice (OpenOffice.org) functionality. Java is mainly -required for the HSQLDB database engine (used by our database product Base) -and to make use of accessibility and assistive technologies. Furthermore some -wizards rely on Java technology. See additional topics pertaining to the use of Java -in OpenOffice.org and Apache OpenOffice in the <a href="">Installation FAQ</a></p> - -<p>So what does this imply for me? Base (the database component) relies -completely on Java technologies to run, but other programs (like Writer, Calc -and Impress) only need Java for special functionality. -If you do not need to use Base and do not want to use any of the Wizards, then you do not need to have Java installed and configured -for running Apache OpenOffice (and older versions of OpenOffice.org). -You can completely prevent OpenOffice from prompting you about the use of Java by -telling OpenOffice not to use a Java runtime environment (JRE). From the OpenOffice main menu use: -<strong>Tools -> OpenOffice.org -> Java</strong>, and uncheck "Use a Java runtime environment". -However, we do recommend that you have a Java Runtime Environment on your system to take -full advantage of OpenOffice's features without any issues.</p> - -<p> Legacy versions of OpenOffice.org (3.3 and below) -included a JRE packaged with the download. The latest Apache OpenOffice 3.4 does not.</p> - -<p>If you already have a JRE installed on your system in one of the standard areas for -Java installation, OpenOffice should detect this installation and let you choose it for use -in OpenOffice via the <strong>Tools-> OpenOffice.org -> Java</strong>. -If you have a JRE installed that is not detected, you should be able to add it through -this same menu.</p> - -<p>If you choose not to configure OpenOffice with Java (or just forgot -about it) you can easily install Java afterwards to get the missing -functionality to work.</p> - -<p>The current version, Apache OpenOffice 3.4, has worked reliably in a variety of -environments using both <a href="http://java.com">Oracle Java</a> and <a href="http://openjdk.java.net/">openJDK</a>. -Feel free to download a JRE from either of these sites if you feel you need this functionality. -</p> - -<p><strong>The current version, Apache OpenOffice 3.4, has reported problems with using the 32-bit JRE on 64-bit Windows 7 -systems. However, this problem can not be reproduced in all cases. Java 1.7 is the latest Java from Oracle. </strong> -</p> - -<p>Please report any problems you experience with using Java on OpenOffice through -our bug reporting system, <a href="https://issues.apache.org/ooo/">Bugzilla</a>, or one of the other support venues listed -in the <a href="http://www.openoffice.org/support/">support</a> page, either the users list or forums.</p> +<p>Java is required for complete OpenOffice (OpenOffice.org) functionality. Java is mainly required for the HSQLDB database +engine (used by our database product Base) and to make use of accessibility and assistive technologies. Furthermore some +wizards rely on Java technology. See additional topics pertaining to the use of Java in OpenOffice.org and Apache +OpenOffice in the <a href="">Installation FAQ</a></p> + +<p>So what does this imply for me? Base (the database component) relies completely on Java technologies to run, but other +programs (like Writer, Calc and Impress) only need Java for special functionality. If you do not need to use Base and do not +want to use any of the Wizards, then you do not need to have Java installed and configured for running Apache OpenOffice +(and older versions of OpenOffice.org). You can completely prevent OpenOffice from prompting you about the use of Java by +telling OpenOffice not to use a Java runtime environment (JRE). From the OpenOffice main menu use: +<strong>Tools -> OpenOffice.org -> Java</strong>, and uncheck "Use a Java runtime environment". However, we do recommend +that you have a Java Runtime Environment on your system to take full advantage of OpenOffice's features without any +issues.</p> + +<p>Legacy versions of OpenOffice.org (3.3 and below) included a JRE packaged with the download. The latest Apache OpenOffice +3.4.1 does not.</p> + +<p>If you already have a JRE installed on your system in one of the standard areas for Java installation, OpenOffice should +detect this installation and let you choose it for use in OpenOffice via the <strong>Tools-> OpenOffice.org -> Java</strong>. +If you have a JRE installed that is not detected, you should be able to add it through this same menu.</p> + +<p>If you choose not to configure OpenOffice with Java (or just forgot about it) you can easily install Java afterwards to +get the missing functionality to work.</p> + +<p>The current version, Apache OpenOffice 3.4, has worked reliably in a variety of environments using both +<a href="http://java.com">Oracle Java</a> and <a href="http://openjdk.java.net/">openJDK</a>. Feel free to download a JRE +from either of these sites if you feel you need this functionality.</p> + +<p><strong>The current version, Apache OpenOffice 3.4, has reported problems with using the 32-bit JRE on 64-bit Windows 7 +systems. However, this problem can not be reproduced in all cases. Java 1.7 is the latest Java from Oracle. </strong></p> + +<p>Please report any problems you experience with using Java on OpenOffice through our bug reporting system, +<a href="https://issues.apache.org/ooo/">Bugzilla</a>, or one of the other support venues listed in the +<a href="http://www.openoffice.org/support/">support</a> page, either the users list or forums.</p> <p>For installing Java on Windows machines, one might appreciate: -<a href="http://java.com/en/download/help/windows_offline_download.xml"> -Download Instructions for Windows offline</a>.</p> +<a href="http://java.com/en/download/help/windows_offline_download.xml">Download Instructions for Windows offline</a>.</p> </body> </html> +
Modified: incubator/ooo/ooo-site/trunk/content/download/common/linux_instructions.html URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/download/common/linux_instructions.html?rev=1379766&r1=1379765&r2=1379766&view=diff ============================================================================== --- incubator/ooo/ooo-site/trunk/content/download/common/linux_instructions.html (original) +++ incubator/ooo/ooo-site/trunk/content/download/common/linux_instructions.html Sat Sep 1 14:57:09 2012 @@ -1,184 +1,133 @@ -.<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> - <title>Instructions for Downloading and Installing Apache OpenOffice 3.4</title> - - + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <title>Instructions for Downloading and Installing Apache OpenOffice 3.4 on Linux</title> </head> <body> -<h2><font color="#FF3300">*DRAFT* Last updated: 2012-08-15</font><br />Instructions for Downloading and Installing <br /> +<h2><font color="#FF3300">*DRAFT* Last updated: 2012-09-01</font><br /> +Instructions for Downloading and Installing <br /> Apache OpenOffice.org 3.4 on Linux</h2> +<h2 id="linux"> Linux Installations</h2> -<h2> Linux Installations<a name="linux"></a></h2> -The following preinstallation steps are recommended for Linux distributions. These should be taken to assure that you +<p>The following preinstallation steps are recommended for Linux distributions. These should be taken to assure that you have a clean install of Apache OpenOffice due to internal considerations and/or the installation of LibreOffice, if it -exists, on your system. +exists, on your system.</p> <ol> -<li> Check to see if LibreOffice has re-routed the OpenOffice binary to itself instead.<br> - Type <code>"whereis soffice"</code> from a console.</br> - <br>If this is symlinked to libreoffice, remove the symlink. (see your favorite reference for how to do this)</br> - <br>This will NOT remove LibreOffice, this will only disallow LibreOffice to redirect the normal OpenOffice binary -- - typically <code>/usr/bin/soffice</code> -- to libreoffice instead.</br></li> - <li>Remove your old version of OpenOffice completely.<br> - The safest way to do this for most users is to use a GUI package manager to search for OpenOffice and remove - all packages.</br></li> + <li> Check to see if LibreOffice has re-routed the OpenOffice binary to itself instead.<br /> + Type <code>"whereis soffice"</code> from a console.<br /><br /> + If this is symlinked to libreoffice, remove the symlink. (see your favorite reference for how to do this)<br /><br /> + This will NOT remove LibreOffice, this will only disallow LibreOffice to redirect the normal OpenOffice binary -- + typically <code>/usr/bin/soffice</code> -- to libreoffice instead.</li> + <li>Remove your old version of OpenOffice completely.<br /> + The safest way to do this for most users is to use a GUI package manager to search for OpenOffice and remove all + packages.</li> </ol> -<h3>Linux RPM-based Installation (command line)<a name="linux-rpm"></a></h3> -<h4>Prerequisites</h3> +<h3 id="linux-rpm">Linux RPM-based Installation (command line)</h3> -<p>If you want Java integration, you want to make sure you have the latest -JRE installed. It should be at least JRE 1.6. You can find the JRE for Linux -at the <a href="http://www.java.com/en/download/linux_manual.jsp"> Java JRE -for Linux</a> download site. Alternatively, a JRE might be included on the -installation media of your distro as part of a complete Java development -environment.</p> +<h4>Prerequisites</h4> +<p>If you want Java integration, you want to make sure you have the latest JRE installed. It should be at least JRE 1.6. +You can find the JRE for Linux at the <a href="http://www.java.com/en/download/linux_manual.jsp"> Java JRE for Linux</a> +download site. Alternatively, a JRE might be included on the installation media of your distro as part of a complete Java +development environment.</p> <h4>Installation Steps</h4> <ol> - - <li> - Review the - <a href="http://www.openoffice.org/dev_docs/source/sys_reqs_aoo34.html"> - System Requirements</a> - </li> - <li><a href="http://www.openoffice.org/download">Download your favorite Linux version of Apache OpenOffice</a></a></li> - <li>Review helpful information and installation options in the + <li>Review the <a href="http://www.openoffice.org/dev_docs/source/sys_reqs_aoo34.html">System Requirements</a></li> + <li><a href="http://www.openoffice.org/download">Download your favorite Linux version of Apache OpenOffice</a></li> + <li>Review helpful information and installation options in the <a href="http://documentation.openoffice.org/setup_guide2/index.html#12">Setup Guide.</a></li> - <li> - Unpack the downloaded image to prepare for installation. <br/> - The following command should work: <code>tar -xvzf "linux package name".tar.gz</code> <br/> - where "linux package name" is the beginning part of the archive you just downloaded.<br /> - <br /> - This will create an installation directory.<br /> - The name of the installation directory will likely be - the language abbreviation for the install set, e.g. en-US. - <li> - <tt>su</tt> to root, if necessary, and navigate to Apache OpenOffice - installation directory (the unpacked archive).<br/> - <em>You will likely need to be root to run the rpm command to install the software.</em> - </li> - <li> - <tt>cd</tt> into the RPMS subdirectory of the installation directory.<br/> - You should see a lot of rpms here and one sub-directory called - "desktop-integration". - </li> - <li> - Install this new version by typing <tt>rpm -Uvih *rpm</tt>.<br/> - By default, this will install OpenOffice in your <tt>/opt</tt> - directory.<br/> - <br>Alternatively, you can use a GUI package installer, reference the installation directory, and - install all rpms at the top level. This may also aid you in determing any dependency problems if they exist.</br> - <p> - </li> - <li> - Install the desktop integration features for your setup. <br /> - <tt>cd</tt> to <tt>desktop-integration</tt> in the installation directory,<br /> - and, depending on your package manager/system, install the appropriate desktop interface using RPM. - </li> + <li>Unpack the downloaded image to prepare for installation.<br /> + The following command should work: <code>tar -xvzf "linux package name".tar.gz</code><br /> + where "linux package name" is the beginning part of the archive you just downloaded.<br /><br /> + This will create an installation directory.<br /> + The name of the installation directory will likely be the language abbreviation for the install set, e.g., en-US.</li> + <li><tt>su</tt> to root, if necessary, and navigate to Apache OpenOffice installation directory (the unpacked + archive).<br /> + <em>You will likely need to be root to run the rpm command to install the software.</em></li> + <li><tt>cd</tt> into the RPMS subdirectory of the installation directory.<br /> + You should see a lot of rpms here and one sub-directory called "desktop-integration".</li> + <li>Install this new version by typing <tt>rpm -Uvih *rpm</tt>.<br /> + By default, this will install Apache OpenOffice in your <tt>/opt</tt> directory.<br /><br /> + Alternatively, you can use a GUI package installer, reference the installation directory, and install all rpms at the top + level. This may also aid you in determing any dependency problems if they exist.<br /></li> + <li>Install the desktop integration features for your setup.<br /> + <tt>cd</tt> to <tt>desktop-integration</tt> in the installation directory,<br /> + and, depending on your package manager/system, install the appropriate desktop interface using RPM.</li> <li>Finally, start up Apache OpenOffice 3.4 to insure it's working.</li> </ol> -<h3>Linux deb-based Installation (command line)<a name="linux-deb"></a></h3> +<h3 id="linux-deb">Linux deb-based Installation (command line)</h3> <h4>Prerequisites</h4> -<p>If you want Java integration, you want to make sure you have the latest -JRE installed. It should be at least JRE 1.6. You can find the JRE for Linux -at the <a href="http://www.java.com/en/download/linux_manual.jsp"> Java JRE -for Linux</a> download site. Alternatively, a JRE might be included on the -installation media of your distro as part of a complete Java development -environment.</p> - +<p>If you want Java integration, you want to make sure you have the latest JRE installed. It should be at least JRE 1.6. +You can find the JRE for Linux at the <a href="http://www.java.com/en/download/linux_manual.jsp"> Java JRE for Linux</a> +download site. Alternatively, a JRE might be included on the installation media of your distro as part of a complete Java +development environment.</p> <h4>Installation Steps</h4> <ol> - - <li> - Review the - <a href="http://www.openoffice.org/dev_docs/source/sys_reqs_aoo34.html"> - System Requirements</a> - </li> - <li><a href="http://www.openoffice.org/download">Download your favorite Linux version of Apache OpenOffice</a></a></li> - <li>Review helpful information and installation options in the + <li>Review the <a href="http://www.openoffice.org/dev_docs/source/sys_reqs_aoo34.html">System Requirements</a></li> + <li><a href="http://www.openoffice.org/download">Download your favorite Linux version of Apache OpenOffice</a></li> + <li>Review helpful information and installation options in the <a href="http://documentation.openoffice.org/setup_guide2/index.html#12">Setup Guide.</a></li> - <li> - Unpack the downloaded image to prepare for installation. <br/> - The following command should work: <code>tar -xvzf "linux package name".tar.gz</code> <br/> - where "linux package name" is the beginning part of the archive you just downloaded.<br /> - <br /> - This will create an installation directory.<br /> - The name of the installation directory will likely be - the language abbreviation for the install set, e.g. en-US. - <li> - <tt>su</tt> to root, if necessary, and navigate to Apache OpenOffice - installation directory (the unpacked archive).<br/> - <em>You will likely need to be root to run the deb command.</em> - </li> - <li> - <tt>cd</tt> into the DEBS subdirectory of the installation directory.<br/> - You should see a lot of debs here and one sub-directory called - "desktop-integration". - </li> - <li> - Install this new version by typing <tt>sudo dpkg -i *.deb</tt>.<br/> - By default, this will install Apache OpenOffice in your <tt>/opt</tt> - directory.<br/> - <br>Alternatively, you can use a GUI package installer, reference the installation directory, and - install all debs at the top level. This may also aid you in determing any dependency problems if they exist.</br> - <p> - </li> - <li> - Install the desktop integration features for your setup. <br /> - <tt>cd</tt> to <tt>desktop-integration</tt> in the installation directory,<br /> - and, depending on your package manager/system, install the appropriate desktop interface using dpkg. - </li> + <li>Unpack the downloaded image to prepare for installation. <br /> + The following command should work: <code>tar -xvzf "linux package name".tar.gz</code><br /> + where "linux package name" is the beginning part of the archive you just downloaded.<br /><br /> + This will create an installation directory.<br /> + The name of the installation directory will likely be the language abbreviation for the install set, e.g., en-US.</li> + <li><tt>su</tt> to root, if necessary, and navigate to Apache OpenOffice installation directory (the unpacked + archive).<br /> + <em>You will likely need to be root to run the deb command to install the software.</em></li> + <li><tt>cd</tt> into the DEBS subdirectory of the installation directory.<br /> + You should see a lot of debs here and one sub-directory called "desktop-integration".</li> + <li>Install this new version by typing <tt>sudo dpkg -i *.deb</tt>.<br /> + By default, this will install Apache OpenOffice in your <tt>/opt</tt> directory.<br /><br /> + Alternatively, you can use a GUI package installer, reference the installation directory, and install all debs at the top + level. This may also aid you in determing any dependency problems if they exist.<br /></li> + <li>Install the desktop integration features for your setup.<br /> + <tt>cd</tt> to <tt>desktop-integration</tt> in the installation directory,<br /> + and, depending on your package manager/system, install the appropriate desktop interface using dpkg.</li> <li>Finally, start up Apache OpenOffice 3.4 to insure it's working.</li> </ol> +<h3 id="other_linux">Packages for Linux Distributions (Not compiled by Apache OpenOffice developers)</h3> + +<p>The Linux downloads provided on the Apache OpenOffice site (mirrors) are generic for either the RPM- or DEB-based package +managers. If you have experience in directly installing these types of packages on your system, one of these types of +installs should work for you. They are not specific to a particular Linux distribution.</p> + +<p>Many Linux distributions now include a version of Apache OpenOffice in their own native package manager format (.rpm, +.deb, etc.) either from their own repositories or community repositories which they support. These packages have been built +and are supported by the distributions' own teams or community members, not by Apache OpenOffice. Some distributions have +strict policies around licensing, which means they have chosen to disable parts of Apache OpenOffice which rely on software +which does not meet their criteria (e.g. the Fedora rpms have disabled the parts of Apache OpenOffice which require +Java).</p> + +<p><b>Note:</b> Please check carefully before using a third-party build that it does actually include all the parts of +Apache OpenOffice that you will require. Replacing a 'native' distribution build with the full Apache OpenOffice original +build can be tricky, but can usually be successfully accomplished by completely removing the existing 'native' install.</p> +<hr /> + +<h2 id="problems">Installation Problems</h2> + +<p>The best resources to help you with installation problems are: -<h3>Packages for Linux Distributions (Not compiled by Apache OpenOffice developers) -<a name="other_linux"></a></h3> - -<p> The Linux downloads provided on the Apache OpenOffice site (mirrors) are generic for - either the RPM- or DEB-based package managers. If you have experience in directly installing - these types of packages on your system, one of these types of installs should work for you. - They are not specific to a particular Linux distribution.</p> - -<p>Many Linux distributions now include a version of Apache OpenOffice in their -own native package manager format (.rpm, .deb, etc.) either from their own repositories -or community repositories which they support. These packages have -been built and are supported by the distributions' own teams or community members, not by -Apache OpenOffice. Some distributions have strict policies around licensing, -which means they have chosen to disable parts of Apache OpenOffice which rely -on software which does not meet their criteria (e.g. the Fedora rpms have -disabled the parts of Apache OpenOffice which require Java).</p> - - - -<p><b>Note:</b> Please check carefully before using a third-party build that -it does actually include all the parts of Apache OpenOffice that you will -require. Replacing a 'native' distribution build with the full Apache OpenOffice -original build can be tricky, but can usually be successfully accomplished by -completely removing the existing 'native' install. </p> - - -<hr/> -<h2>Installation Problems<a name="problems"></a></h2> -The best resources to help you with installation problems are: <ul> -<li><a href="http://incubator.apache.org/openofficeorg/mailing-lists.html">the Users mailing list</a></li> -<li><a href="http://user.services.openoffice.org/">the Apache OpenOffice User Support Forums</a></li> + <li><a href="http://incubator.apache.org/openofficeorg/mailing-lists.html">the Users mailing list</a></li> + <li><a href="http://user.services.openoffice.org/">the Apache OpenOffice User Support Forums</a></li> </ul> </body> -</html> \ No newline at end of file +</html> +
