Author: kschenk
Date: Mon May 21 20:46:36 2012
New Revision: 1341197
URL: http://svn.apache.org/viewvc?rev=1341197&view=rev
Log:
kls -- changes to improve Linux installation experience
Modified:
incubator/ooo/ooo-site/trunk/content/download/common/instructions.html
Modified: incubator/ooo/ooo-site/trunk/content/download/common/instructions.html
URL:
http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/download/common/instructions.html?rev=1341197&r1=1341196&r2=1341197&view=diff
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/download/common/instructions.html
(original)
+++ incubator/ooo/ooo-site/trunk/content/download/common/instructions.html Mon
May 21 20:46:36 2012
@@ -8,8 +8,8 @@
<body>
<h2>Instructions for Downloading and Installing <br />
-Apache OpenOffice.org 3.4 and OpenOffice.org 3.x.x</h2>
-<p>Last updated: 2012-05-06</p>
+Apache OpenOffice.org 3.4 </h2>
+<p>Last updated: 2012-05-21</p>
<p>A more extensive, though older, <b>Installation Guide</b> is available in
<a
href="http://wiki.services.openoffice.org/w/images/7/7e/Installation_Guide_OOo3.pdf";>PDF</a>
@@ -17,6 +17,7 @@ and <a href="http://wiki.services.openof
formats from the
<a href="http://wiki.services.openoffice.org/wiki/Documentation";>
OpenOffice.org Documentation Project</a>.</p>
+<p>You may also find the <a
href="http://wiki.services.openoffice.org/wiki/Documentation/FAQ/Installation";>Installation
FAQs</a> useful as well.</p>
<p><em>Please note: With this new 3.4 release, a JRE (Jave Runtime
Environment) is no longer packaged with OpenOffice. However,
you may still need a JRE for full functionality of AOO 3.4. (See <a
href="java.html">Java and OpenOffice.org</a>).
@@ -29,11 +30,12 @@ Please ensure that your system has at le
<li><a href="#fileassoc">File Associations</a></li>
</ul>
</li>
- <li><a href="#linux">Linux RPM-based</a></li>
+ <li> <a href="#linux"> Linux, General Information</a></li>
+ <ul>
+ <li><a href="#linux-rpm">Linux RPM-based</a></li>
<li><a href="#linux-deb">Linux DEB-based</a></li>
- <ul>
<li><a href="#other_linux">Packages for Linux Distributions</a></li>
- </ul>
+ </ul>
<li><a href="#apple">Apple Macintosh</a></li>
<li> <a href="#problems">Installation Problems</a></li>
</ul>
@@ -342,8 +344,24 @@ site by clicking the Support tab availab
<hr/>
-<h2>Linux RPM-based Installation<a name="linux"></a></h2>
-<h3>Prerequisites</h3>
+<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
+have a clean install of Apache OpenOffice due to internal considerations
and/or the installation of LibreOffice, if it
+exists, on your system.
+
+<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>
+</ol>
+
+<h3>Linux RPM-based Installation<a name="linux-rpm"></a></h3>
+<h4>Prerequisites</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
@@ -353,7 +371,7 @@ installation media of your distro as par
environment.</p>
-<h3>Installation Steps</h3>
+<h4>Installation Steps</h4>
<ol>
@@ -363,6 +381,8 @@ environment.</p>
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
+ <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/>
@@ -370,7 +390,7 @@ environment.</p>
<br />
This will create an installation directory.<br />
The name of the installation directory will likely be
- the langueage abbreviation for the install set, e.g. en-US.
+ 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/>
@@ -385,10 +405,9 @@ environment.</p>
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/>
- <b>NOTE:</b> See additional installation options and other useful
- information in the
- <a href="http://documentation.openoffice.org/setup_guide2/index.html#12";>
- Setup Guide</a>.
+ <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 />
@@ -398,9 +417,9 @@ environment.</p>
<li>Finally, start up Apache OpenOffice 3.4 to insure it's working.</li>
</ol>
-<h2>Linux deb-based Installation<a name="linux-deb"></a></h2>
+<h3>Linux deb-based Installation<a name="linux-deb"></a></h3>
-<h3>Prerequisites</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
@@ -410,7 +429,7 @@ installation media of your distro as par
environment.</p>
-<h3>Installation Steps</h3>
+<h4>Installation Steps</h4>
<ol>
@@ -420,6 +439,8 @@ environment.</p>
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
+ <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/>
@@ -427,7 +448,7 @@ environment.</p>
<br />
This will create an installation directory.<br />
The name of the installation directory will likely be
- the langueage abbreviation for the install set, e.g. en-US.
+ 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/>
@@ -442,10 +463,9 @@ environment.</p>
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/>
- <b>NOTE:</b> See additional installation options and other useful
- information in the
- <a href="http://documentation.openoffice.org/setup_guide2/index.html#12";>
- Setup Guide</a>.
+ <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 />
