NeoOffice Download and Installation Issues

From NeoWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 02:06, 22 February 2016 (edit)
( | contribs)
m (Reverted edits by Pluby (); changed back to last version by Sardisson)
← Previous diff
Revision as of 02:07, 22 February 2016 (edit) (undo)
( | contribs)
(Undo accidental rollback)
Next diff →
Line 1: Line 1:
-==Downloading NeoOffice==+{{bluebox|SendUsInstallationProblemsNotice}}
-===I can't figure out how to purchase NeoOffice download and support services===+==Downloading NeoOffice Class Edition from our website==
-Beginning in 2011 and reaching overwhelming levels in summer 2012, rude and nasty messages, complaints, and disputes/refund requests from new Mac and NeoOffice users placed an extraordinary burden on the NeoOffice project and its one full-time engineer. These abusive messages and payments-followed-by-refund-requests were so numerous that handling them took almost all the time available, severely diminishing the ability to ensure compatibility with new Mac OS X releases and fix bugs. This situation was unsustainable and threatened the very existance of NeoOffice.+===Existing users who have made a payment during the last year===
- +
-As a result, in July of 2012, [https://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=63025#63025 all new payments] for NeoOffice download and support services were disabled. This drastic measure by and large had the desired effect of eliminating abusive freeloaders and allowed NeoOffice development and bug-fixing for NeoOffice 3.3 Beta/Mac OS X 10.8 “Mountain Lion” support to continue.+
- +
-After about a month, new payments for NeoOffice download and support services were again being accepted. However, very quickly new users began to overwhelm the payment system with unreasonable emails, payment disputes, and refund requests, including what appeared to be a large-scale coordinated attempt to "game" the system and to prevent the NeoOffice engineer from fixing bugs and supporting long-time existing NeoOffice users.+
- +
-Since new users overwhelmingly created administrative hassles while most existing NeoOffice users rarely issued complaints or payment disputes/refund requests, in mid-August 2012 '''payments for NeoOffice download and support services were once again [https://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=63438#63438 restricted], this time to only users who have paid for services in the past and have not filed any disputes'''.+
- +
-While as of late August 2012, the ability to make payments for NeoOffice download and support services is available to everyone, it is possible that this ability will be restricted again in the future if new users continue to create unreasonable burdens on NeoOffice support and development. Certain payment levels may also be restricted at times when NeoOffice engineering is near maximum implementation capacity.+
- +
-If the ability to make payments is again restricted, unfortunately, it means that the latest versions of NeoOffice are not available to users who have not previously paid for NeoOffice download and support services (note that NeoOffice 3.2.1 is still available for [http://www.neooffice.org/neojava/download.php?fragment=download download] by anyone on Mac OS X 10.5-10.7 Intel (without Retina displays), although this release is not supported). While we wish we could afford to include new users, the reality is that throughout the last year it has become clear that many new NeoOffice users not only do not appreciate or understand the sacrifices NeoOffice developers have made to make a low cost, Mac-specific office suite, but their actions are also actively undermining the ability to continue providing NeoOffice to long-time loyal NeoOffice users.+
- +
-====Existing users with a payment during the last year====+
If you are an existing NeoOffice user who has made a payment within the last year, you will be able to [http://www.neooffice.org/neojava/download.php?fragment=download download] the newest NeoOffice releases as normal. When your services expire in the future, you will be able to make a new payment using the method described [[#Existing users without a payment during the last year|below]]. If you are an existing NeoOffice user who has made a payment within the last year, you will be able to [http://www.neooffice.org/neojava/download.php?fragment=download download] the newest NeoOffice releases as normal. When your services expire in the future, you will be able to make a new payment using the method described [[#Existing users without a payment during the last year|below]].
-=====Upgrading your service level=====+===Existing users who have not made a payment during the last year===
-If you are an existing NeoOffice user who has made a payment within the last year and would like to upgrade your service level (for instance, from "download access only" to "direct support from NeoOffice engineers"), follow the first two steps [[#Existing users without a payment during the last year|below]] to log in to the NeoOffice Downloads system. Then cancel the NeoOffice download that begins and click on the "Services" link on the top of the page; you can make an additional payment from the Services page while logged in to the NeoOffice Downloads system.+
- +
-Note that it is not possible to make an additional payment of only the difference between the amount of your existing service level and the amount of the desired new service level.+
-====Existing users without a payment during the last year==== 
If you are an existing NeoOffice user who has not made a payment within the last year, has not made a payment dispute in the past, and would like to download one of the newest NeoOffice releases, follow these steps in order to make a new payment: If you are an existing NeoOffice user who has not made a payment within the last year, has not made a payment dispute in the past, and would like to download one of the newest NeoOffice releases, follow these steps in order to make a new payment:
-# Visit the [http://www.neooffice.org/neojava/download.php?fragment=download NeoOffice download page] and click on the download link for the version of NeoOffice you would like to download.+# Visit the [http://www.neooffice.org/neojava/download.php?fragment=download NeoOffice download page] and click on {{Button|NeoOffice Classic Edition}}.
-# Log in to the NeoOffice Downloads system using the email address you used previously when making a payment for NeoOffice download and support services.+# Login using the e-mail address that you used when you made your last PayPal payment.
-# Upon logging in to the NeoOffice Downloads system, you will be presented with the familiar payment form. Follow the instructions on that page to make a new payment.+# If you have not made a payment during the last year, a PayPal payment form will appear. Follow the instructions on that page to make a new payment.
-(Note: Beginning on November 27, 2012, as a way of thanking the most generous users, NeoOffice 3.3 downloads were [https://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=63767#63767 made available] to all users who have paid a total of $100 or equivalent, even if the last payment was made over a year ago. This expanded availability applies only to NeoOffice 3.3 download access; it '''does not''' include other services, such as direct support from NeoOffice engineers, which still require a payment made within the last year. In other words, if you have paid a total of $100 and only want to download NeoOffice 3.3, you do not need to make a new payment at this time.)+=== Download fails or cannot open downloaded file===
-=== Do I have to make a payment? ===+This error usually means that the NeoOffice .dmg file was not completely downloaded. The NeoOffice download file is very large and some internet service providers disconnect your connection to our web server before the download has finished.
-The NeoOffice project is funded entirely by payments from our users. The newest versions of NeoOffice do require payment. The oldest version does not require payment. There are other special [http://www.planamesa.com/neojava/services.php services] to thank our most generous users. Currently there are three levels of services (each with a term of one year from the time of your payment): +To fix this problem, try the following steps. These steps will use Safari to resume the download without starting a new download. Safari has the ability to resume the download if your internet service provider disconnects your connection. Note: these steps only work in Safari and they do not work in Firefox or Chrome:
-# Download access only+
-# Download access '''plus''' the ability to suggest and vote on new features+
-# Download access '''plus''' the ability to suggest and vote on new features '''plus''' direct support from NeoOffice engineers on any bugs you may encounter+
-During periods when a beta release is available, users who have subscribed to a level of services lower than the top level ''may'' be able to post in the Beta Support forum; always consult the [http://www.neooffice.org/neojava/services.php Services] page for the most current information.+# [[Image:Safari resume downloading.png|right]]Launch the Safari web browser and load the [http://www.neooffice.org/neojava/download.php?fragment=download NeoOffice download page] in Safari
 +# Start a new download of NeoOffice by clicking on the {{Button|NeoOffice Classic Edition}} button and logging in using your e-mail address
 +# Every few minutes, check on the download by clicking the {{Button|Downloads}} toolbar button as shown in the screen snapshot to the right. If the progress bar in the {{prefName|Downloads}} popup window is replaced by an error message, press the {{Button|Resume downloading}} icon that is circled in red.
 +# After pressing the {{Button|Resume downloading}} icon, the download progress bar should reappear and the download should resume. If the download stops again, repeat the previous step.
-Note that at certain times, only NeoOffice users who have previously made a payment and have not filed a dispute are able to make new payments (see [[#I can't figure out how to purchase NeoOffice download and support services|above]] for more information about this change).+===I want to download NeoOffice 3.4.1 but I only see NeoOffice 2015 Classic Edition===
-===I see information about NeoOffice 3.2.1 but can't find the download link===+If you are running Mac OS X 10.6 - 10.10 and you do not want to upgrade to NeoOffice 2015 Classic Edition, you can download the older NeoOffice 3.4.1 version [http://www.neooffice.org/neojava/mirrors.php?file=NeoOffice-3.4.1.18-Intel.dmg here].
-NeoOffice 3.2.1 requires an Intel-based Macintosh running Mac OS X 10.5-10.7 (without a Retina display). Make sure you are browsing the NeoOffice web site from a Mac that meets those system requirements, and make sure that your browser is properly [http://whatsmyuseragent.com/ identifying] itself (see [[#I can't download NeoOffice (or a patch) even though I'm using Mac OS X|below]] for more details).+==Downloading NeoOffice from the Mac App Store==
-===I can't download NeoOffice (or a patch) even though I'm using Mac OS X===+A version of NeoOffice is in Apple's Mac App Store which you can download from [https://itunes.apple.com/us/app/neooffice/id639210716?mt=12 here]. Although our Mac App Store version costs more than our Classic Edition versions, you only need to purchase the Mac App Store version once and then all upgrades to future Mac App Store versions will be free.
- +
-If you see the "Sorry, you requested a file that can only be downloaded to a Mac OS X machine and your web browser does not appear to be running on a Mac OS X machine." error message from the NeoOffice web site when attempting to download NeoOffice and you are on a Mac OS X computer, some software on your computer, or on a computer between you and the NeoOffice website, is corrupting your browser's attempt to [http://whatsmyuseragent.com/ identify] itself.+
- +
-Because of a persistent problem with mass downloads from Windows computers in various parts of the world eating up NeoOffice download bandwidth and increasing NeoOffice hosting costs, the NeoOffice website checks to make sure that the web browser attempting to download NeoOffice (or a patch) is running on a Mac. Unfortunately, some third-party anti-virus and firewall software corrupts the standard browser identification string that web browsers send to all websites, causing the NeoOffice website to be unable to identify your browser as one running on Mac OS X. In addition, some proxy servers (possibly one you have installed on your Mac, or possibly run by your ISP or your ISP's internet provider) also corrupt (or remove) the browser identification string.+
- +
-If you encounter this problem, first check any third-party anti-virus, firewall, or proxy server software you have installed on your Mac and try temporarily disabling it (or turning off the software's option to anonymize your browser, if such an option is present). If this does not allow you to download NeoOffice successfully, try using the instructions on [[Using curl to download NeoOffice]] instead to download NeoOffice or the patch.+
==Before Installing== ==Before Installing==
Line 60: Line 38:
===Do I need to uninstall a previous version of NeoOffice first?=== ===Do I need to uninstall a previous version of NeoOffice first?===
-Users often ask if they need to [[Uninstalling NeoOffice|uninstall]] NeoOffice before installing a newer version. The short answer is '''NO'''; in fact, completely uninstalling NeoOffice using the linked instructions before launching the new version may actually cause your old preferences to be reset and dictionaries, macros and other user files to be deleted.+No. NeoOffice will install over an existing NeoOffice installation. After upgrading, you may want to [[Adding Additional Dictionaries#Installing Third-Party Dictionaries for OpenOffice.org|check for upgrades to any third-party dictionaries that you may have previously installed]].
-NeoOffice will install over top of an existing NeoOffice installation, replacing the old version while preserving a number of "user" files that live inside of the application bundle. On first launch, the newly installed version of NeoOffice will also offer to import your existing NeoOffice preferences. After upgrading, you should be sure to [[Changing_the_Language_of_the_User_Interface#Upgrading_NeoOffice_and_language_packs|install the most current version of any language packs]] and [[Adding Additional Dictionaries#Installing Third-Party Dictionaries for OpenOffice.org|check for upgrades to any installed dictionaries]].+===Can I have two versions of NeoOffice installed on the same machine?===
-===Can I have two versions of NeoOffice installed simultaneously?===+Yes. To install a second version of NeoOffice, use the following steps:
-Users, especially those in institutional settings, often ask if they can have multiple copies of NeoOffice installed simultaneously, for example as they qualify a new version for their environment. This has been possible since NeoOffice 2.0 Alpha, and this procedure is used regularly by NeoOffice developers and testers/bug triage team members to check bugs against multiple versions and in [[NeoOffice Early Access FAQ|Early Access]] periods.+# In the Finder, create a copy of your NeoOffice installation by navigating to the <tt>/Applications</tt> fodler and right-clicking or Control-clicking on the NeoOffice icon. In the popup menu that appears, select the {{prefName|Duplicate}} menu item. This will create a new NeoOffice installation in the <tt>/Applications</tt> folder.
 +# Install the new version of NeoOffice. The installer will upgrade either the original installation or the copied installation that you created but it will not upgrade both.
 +# When you no longer need to use one of the versions, drag the undesired version of NeoOffice from the <tt>/Applications</tt> folder to the Trash, empty the Trash.
-To install a second version of NeoOffice, use the following steps:+Note: while you can have two versions of NeoOffice installed on the same machine, in most cases only one version can be run at a time. You must quit the running version of NeoOffice before you launch a different version of NeoOffice.
-# Move or rename your existing <tt>/Applications/NeoOffice.app</tt>, as this is where the new NeoOffice will install to. +===Do I need to uninstall OpenOffice or LibreOffice first?===
-#: For example, I renamed my NeoOffice 2.2.5 installation <tt>/Applications/NeoOffice-2.2.5.app</tt>.+
-#: '''N.B.''' When renaming your existing NeoOffice and installing a new version, many macros, language packs, dictionaries, and other items that are installed inside the NeoOffice application itself will not be preserved as they are during a normal installation. Your should re-install these items.+
-# Install the new version of NeoOffice+
-# Be sure to always launch the desired copy of NeoOffice by double-clicking on the appropriate NeoOffice icon in the <tt>/Applications</tt> folder in the Finder.+
-#: Do this as your Dock icon may still point to your moved/renamed installation, and LaunchServices (the part of the OS that handles opening files via double-clicks) may randomly choose the version of NeoOffice it opens.+
-# When you no longer need to use one of the versions,+
-## Simply drag the undesired version of NeoOffice from the <tt>/Applications</tt> folder to the Trash.+
-## Be sure to '''empty the Trash'''; otherwise documents may fail to open in the remaining version (this is an Apple bug)+
-## Rename your remaining NeoOffice installation "NeoOffice" (if applicable).+
-You can use two versions of NeoOffice on the same machine; however, due to the size of NeoOffice, we recommend that you don't run both at the same time.+No. NeoOffice will not harm your OpenOffice or LibreOffice installation. NeoOffice uses separate folders to store your user preferences, macros, and extensions so you do not need to uninstall either OpenOffice or LibreOffice.
-===Do I need to uninstall OpenOffice.org first? Can I get rid of OpenOffice.org?===+To have the Finder open files in NeoOffice instead of in OpenOffice or LibreOffice, see [[Setting_the_Default_Application|Setting the default application]].
-NeoOffice will not harm your OpenOffice.org installation; both applications use separate locations for e.g. preferences, macros, and other add-ons. (Due to the limitations of the Mac OS X file association system, NeoOffice and OpenOffice.org may fight over which application will open shared file formats [<tt>.sxw</tt>, <tt>.odt</tt>, etc.] by default.)+== NeoOffice Class Edition Installation Issues ==
-You do not need to get rid of OpenOffice.org, but you also do not need to keep OpenOffice.org if you are happy with NeoOffice.+=== When double-clicking on the .dmg file, there is an error about "image not recognized" ===
-== Installation Issues ==+This error usually means that the NeoOffice .dmg file was not completely downloaded. To fix this problem, [[#Download_fails_or_cannot_open_downloaded_file|try these steps]].
-=== When double-clicking on the .dmg file, there is an error about "No mountable file systems" ===+=== Installation stalls when it gets to the "Select Destination" panel ===
-This error usually means that the NeoOffice .dmg was not completely downloaded. Some combinations of browsers and internet connections frequently cause large downloads like NeoOffice to stop before the entire file is downloaded but do not inform the user that the download has failed.+The installer sometimes hangs when it gets to the "Select Destination" panel and no drives in that panel will be selectable.
- +
-In this case, you might try using the command-line <tt>curl</tt> tool to complete the download (this tool is also useful if you are on a dial-up connection and may need to stop and start the download to use the phone line). Instructions on using <tt>curl</tt> to download NeoOffice can be found [[Using curl to download NeoOffice|here]].+
- +
-=== When running the NeoOffice installer, the "test" returns with "NeoOffice can not be installed on this computer." ===+
- +
-The BSD subsystem is installed by default on 10.3.x and 104.x as part of the '''BaseSystem.pkg.''' If this problem occurs on 10.3.x machines, your BSD subsystem may have been somehow removed or messed up. It is not recommended that you reinstall '''BaseSystem.pkg''' alone, since this may leave your system in an unuseable state. Instead, reinstall Mac OS X from your retail CD; select the "Upgrade" option to preserve all of your settings, documents, etc. Then reinstall the latest Mac OS X updates and security updates to return you system to an up-to-date state.+
- +
-'''N.B.''': ''Since this requires a fairly significant amount of work, and perhaps time, you should probably check the [http://trinity.neooffice.org/modules.php?name=Forums trinity forums] first and see if someone can determine if something else is the problem and find another solution.''+
- +
-=== Installation stalls when it gets to the "Select Destination" screen ===+
- +
-Installation sometimes stalls or hangs when it gets to the "Select Destination" screen (and no drives will appear to choose from).+
====Unreachable or unreadable volumes on your Mac==== ====Unreachable or unreadable volumes on your Mac====
Line 125: Line 84:
<pre>Install Failed. The source media you are installing from is damaged</pre> <pre>Install Failed. The source media you are installing from is damaged</pre>
-If you see this message, most likely the disk image you downloaded was not completely downloaded (but somehow still passed the Mac OS X disk image validation). To verify that the disk image is actually the same size as the original on the NeoOffice.org servers, you can follow these steps:+If you see this message, most likely the disk image you downloaded is corrupted. We recommend that you delete the corrupted file and redownload NeoOffice.
-# Select the downloaded file in the Finder+===Why does the NeoOffice installer request my administrator password?===
-# Choose {{menu|Get Info}} from the Finder’s {{menu|File}} menu+
-# Compare the number of bytes (listed in parentheses at the end of the {{prefName|Size:}} line in the Get Info window) to the number of bytes listed on the [http://www.neooffice.org/neojava/maindownload.php NeoOffice download page], [http://www.neooffice.org/neojava/langpackdownload.php Language Pack download page], or [http://www.neooffice.org/neojava/patch.php Patch download page] for the file you downloaded.+
-# If the size does not match, your download is incomplete.+
-You can also compare the '''MD5SUM''' for the file you downloaded to the '''MD5SUM''' of the original files, which are listed on the [[NeoOffice MD5 Checksums]] page along with instructions for computing the '''MD5SUM'''.+The NeoOffice installer is designed to not only support launching NeoOffice on a single user machine, but also to support launching NeoOffice from a shared network volume and launching NeoOffice by any user on a multi-user machine. We have found that installing as an administrative user is the only reliable way to handle all of these types of installation.
-If your download was incomplete, you may be able to complete it by using the <code>curl</code> Terminal command instead of re-downloading the entire file. For instructions on using the <code>curl</code> method, see [[Using_curl_to_download_NeoOffice#Using_curl_to_complete_a_.E2.80.9Cfailed.E2.80.9D_download_begun_by_a_web_browser|Using curl to download NeoOffice]].+== Mac App Store Installation Issues ==
-=== Installation fails with a "generic" error message ===+=== The Mac App Store has not finished installing NeoOffice after several minutes ===
-For some users, installation will fail and the following error message will appear:+If you see the {{Button|Installing}} button in Apple's App Store application for more than a few minutes, this usually means that the App Store application is still downloading NeoOffice from Apple's servers. NeoOffice is a very large download so Apple's App Store application will show the {{Button|Installing}} button for at least a few minutes and, if you have a slow internet connection, 15 minutes or longer.
-<pre>There were errors installing the software+To see the NeoOffice download progress, click on the {{Button|Purchases}} toolbar button in the App Store application as shown in the screen snapshot below. The App Store application will usually finish the installation within a minute or two after the download is finished.
-Please try installing again.</pre>+
-If you see this message, you need to open the System Preferences application (<tt>/Applications/System Preferences</tt>), click on the '''International''' icon, select the '''Languages''' tab, move '''English''' to the top of the list, log out, login again, and then rerun the installer. After installation, you can (and should) [[NeoOffice_Installation_Issues#Check your language settings before launching NeoOffice|revert to your preferred language]].+[[Image:NeoOffice download progress macappstore.png]]
-This behavior is required to work around a rare but serious bug in the Mac OS X Installer on some versions of Mac OS X; for more information, see [http://www.planamesa.com/neojava/download.php#problems this section of the Download instructions].+== Java Installation Issues ==
-=== Why does the NeoOffice installer request my administrator password? ===+=== NeoOffice Classic Edition ===
-In [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=1210 this thread], Patrick Luby explains the reasons for this requirement:+Some features in NeoOffice Classic Edition require Java. If you see the dialog shown below while running NeoOffice Classic Edition, you need to install the [http://www.neooffice.org/neojava/javadownload.php Java SE Development Kit (JDK) from Oracle].
-:Administrator access is required because Neo/J uses OpenOffice.org's multi-user installation. This doesn't require admin access, but in the early days of Neo/J testing, we found that the OOo code has a very bad habit of trying to edit the installed files if the files are owned by the same user that is running Neo/J. This can really muck up a Neo/J installation over time.+To download the Java SE Development Kit (JDK) from Oracle, press the {{button|Download}} button in the dialog shown below or download it from [http://www.neooffice.org/neojava/javadownload.php here]. Note: only Oracle's JDK will work NeoOffice Classic Edition. Neither Apple's Java nor Oracle's Java SE Runtime Environment (JRE) will work.
-:So, to prevent the OOo code from editing any of the files in the installation, the installer executes <tt>chown -Rf root:admin</tt> and <tt>chmod -Rf a-w</tt> all of the Neo/J files.+[[Image:Java not found dialog.png]]
-== Patching Issues ==+=== Mac App Store ===
-=== The patch installation fails with a "generic" error message ===+Apple does not allow applications in the Mac App Store to use Java so [http://www.neooffice.org/neojava/macappstore.php?fragment=javapython all features that require Java have been removed] from the Mac App Store version of NeoOffice.
-For some users, installation will fail and the following error message will appear:+If you purchased NeoOffice from the Mac App Store but you need to use a feature that uses Java, we recommend that you do the following steps:
-<pre>There were errors installing the software+# [[#How do I uninstall NeoOffice?|Uninstall the Mac App Store version of NeoOffice]]
-Please try installing again.</pre>+# Purchase NeoOffice Classic Edition from the [http://www.neooffice.org/neojava/download.php?fragment=download NeoOffice download page]
 +# [http://www.labnol.org/software/mac-app-store-refund-purchase/28774/ Ask Apple for a refund] of your Mac App Store purchase
-See [[#Installation fails with a "generic" error message|Installation fails with a "generic" error message]] in the '''Installation Issues''' section above.+== Patch Installation Issues ==
=== The patch installer refuses to start the installation. === === The patch installer refuses to start the installation. ===
-Under Mac OS X 10.3.x and 10.4.x, the installer will provide a red "stop" sign with exclamation point; clicking on the volume will produce the error message "You cannot install this software on this volume" as well as some further information about the problem (or on 10.4.x, "Could not find specified message for index 16", which is a bug in the 10.4.x installer).+If none of the volumes in the installer's "Select a Destination" panel are selectable, there are possible causes for this:
- +
-There are two cases in which these messages might appear.+
==== The patch is for a version of NeoOffice newer than the version installed on your computer ==== ==== The patch is for a version of NeoOffice newer than the version installed on your computer ====
-Patches for the latest version of NeoOffice '''will not apply''' to earlier versions of NeoOffice. Each time NeoOffice moves to a new version of the OpenOffice.org codebase (including OpenOffice.org minor point releases), the patches for the new version will be incompatible with older versions of NeoOffice. The latest version of NeoOffice uses a certain OpenOffice.org codebase while earlier versions of NeoOffice used a different (also earlier) OpenOffice.org codebase. As described in [http://www.macosxhints.com/article.php?story=2005012811400696 this thread], "It would be like trying to apply the Mac OS X 10.3.1 updater to Mac OS X 10.2.8...."+Patches for the latest version of NeoOffice '''will not apply''' to earlier versions of NeoOffice. Patches can only be installed when a specific version of NeoOffice is already installed. For example, NeoOffice 2015 Classic Edition must already be installed before you can install NeoOffice 2015 Classic Edition Patch 1.
- +
-If you open NeoOffice and select "About" from the "Help" menu, the version reported in the About window should be the latest version of NeoOffice. See the [[NeoOffice Release Notes]] to learn which version is the latest.+
-To fix this problem, drag '''NeoOffice''' from the '''Applications''' folder to the '''Trash'''. Then download and install the latest version and the new patch that goes with it. +To fix this problem, download and install the latest version of NeoOffice from the [http://www.neooffice.org/neojava/download.php?fragment=download NeoOffice download page]. After installing the latest version, select the {{prefName|Help}} > {{prefName|Check for Updates}} menu to check if you have the latest patch.
==== NeoOffice is not located in the <tt>/Applications</tt> folder ==== ==== NeoOffice is not located in the <tt>/Applications</tt> folder ====
-The message will also appear if you have moved NeoOffice from your <tt>/Applications</tt> folder, or if you have renamed NeoOffice. The patch installer will only search the <tt>/Applications</tt> folder for NeoOffice installations; <tt>/Applications</tt> is the only supported location for installing NeoOffice.+The message will also appear if you have moved NeoOffice from your <tt>/Applications</tt> folder, or if you have renamed NeoOffice. The patch installer will only search the <tt>/Applications</tt> folder for NeoOffice installations. If you have moved NeoOffice out of the <tt>/Applications</tt> folder, quit the installer, move NeoOffice back into your <tt>/Applications</tt> folder, run the installer, and then move NeoOffice back to its original folder.
- +
-To fix this problem, quit the installer and move NeoOffice back into your <tt>/Applications</tt> folder (or rename the application "NeoOffice"). Because the underlying OpenOffice.org stores a number of absolute pathnames in its configuration and preference files, you will also have to delete the <tt>~/Library/Preferences/NeoOffice-''x.x''</tt> folder or you will experience errors running NeoOffice in the future. Then run the installer again to install the patch.+
== Post-Installation and First Launch Issues == == Post-Installation and First Launch Issues ==
-===Check your language settings before launching NeoOffice===+====Cannot save documents====
-NeoOffice adopts the uppermost language of the '''Languages:''' box of the '''International''' pane of the Mac OS X System Preferences as its own language for spellchecking (assuming that the necessary [http://www.neooffice.org/neojava/download.php#installlanguages language pack] is already installed or the language is one of the default 12 languages). +[[Image:NeoOffice cannot save free edition.png|right]]If you see the dialog shown in the screen snapshot to the right when you edit or try to save a document, then the problem is that you have launched NeoOffice Viewer. NeoOffice Viewer can only view files and cannot save documents.
-Be aware that some languages have more than one form (e.g., English has US English, British English, Australian English, etc.) as the possible selection; click the '''Edit List...''' button in the '''Language''' tab of the '''International''' pane of the Mac OS X System Preferences to add your version of the language, and then drag and drop it to the top of the list in the '''Languages:''' box before launching NeoOffice for the first time. +To fix this problem, right-click or Control on the NeoOffice icon in the Dock while NeoOffice Viewer is still running. In the popup menu that appears, select the {{prefName|Options}} > {{prefName|Show in Finder}} menu item. A Finder window will appear. Quit NeoOffice, drag the NeoOffice application in that Finder window to the Trash, and empty the Trash.
-See [[Troubleshooting Spellcheck]] for further details on issues with certain languages.+If you have not already installed NeoOffice Classic Edition or NeoOffice from the Mac App Store, install either now. If you already installed on of them, double-clicking on a NeoOffice file in the Finder should now launch NeoOffice Classic Edition or NeoOffice from the Mac App Store.
-<!--+
-===Why does NeoOffice 1.2.x “hang” part-way through startup?===+
-NeoOffice 1.2.x will appear to "hang" (the progress bar will stall between the "n" and "O" in "OpenOffice.org" in the tagline) during startup. This is normal behavior; the delay is caused by the initialization of native fonts. NeoOffice/J 1.1 and earlier initialized native fonts during the long delay prior to the appearance of the splashscreen, so the problem was less noticeable—although that behavior often caused people to wonder if the application was actually launching!+===Check your language settings before launching NeoOffice===
-The length of this delay will vary depending on the number of fonts you have installed; you can shorten the delay considerably by using Font Book to disable fonts you do not use. (Make sure not to disable [http://docs.info.apple.com/article.html?artnum=301332 fonts required by Mac OS X] [[http://docs.info.apple.com/article.html?artnum=25710 10.3.x list]], of course.) Note also that every major update to OSX will automatically reenable all your disabled fonts, so in Font Book, it's worth setting up a new 'keep disabled' collection and adding to it all the fonts you want to keep disabled - then after you update OSX, you can simply select all the fonts in the 'keep disabled' collection and disable them all at once. <!- -need a link to list of fonts req'd by the OS and Apple apps- ->+NeoOffice uses the first language in the '''Preferred languages:''' list in the '''Language & Region''' panel in the System Preferences application.
-You may also experience slow startup after you rebooted your Mac. This is normal as the first time that NeoOffice is run, all fonts get fully loaded. This is because the OpenOoffice.org code needs data on all available fonts. This loading takes extends the startup phase the first time that NeoOffice is run (i.e. a cold start). Successive launches (i.e. warm restarts) will be much faster since all fonts are already fully loaded.+Some languages have more than one form (English has US English, British English, Australian English, etc.). To add another language or language form, launch the System Preferences application, click on the '''Language & Region''' icon, and click the {{Button|+}} button below the '''Preferred languages:''' list. After adding a new language, move that language to the top of the '''Preferred languages:''' list and restart NeoOffice.
-This is no longer an issue in NeoOffice 2.0 Alpha 4 with Patch-1 or higher; native fonts are now only initialized when they are needed (as a result of this change, the Font drop-down menu now displays font names using the standard UI font).+See [[Troubleshooting Spellcheck]] for further details on issues with certain languages.
--->+
-===Why doesn't NeoOffice let me run it as “root”?===+
-In [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=2077 this thread], Patrick Luby explains the reasons for this requirement:+===Why doesn't NeoOffice let me run it as "root"?===
-:Running as root is disabled on purpose. Over a year ago I added this code because we found that running as root causes the underlying OpenOffice.org code to act like it is in "single-user install" mode. In this mode, OpenOffice.org starts writing user preferences in the <tt>/Applications/NeoOffice.app</tt> files. This, in turn, makes Neo pretty much unusable for any other user account on your machine.+Running as root is disabled on purpose. Several years ago we found that when running as root, NeoOffice's underlying OpenOffice code would modify files with the <tt>/Applications/NeoOffice.app</tt> folder. This, in turn, caused NeoOffice to not be launchable from a shared network volume or launchable by any non-root user on a multi-user machine.
-<!--+
-:The only way to run Neo while logged in as root is to execute Neo as a non-root user in a terminal:+
-:<pre>sudo -H -u <non-root-user-name> /Applications/NeoOffice.app/Contents/MacOS/soffice.bin</pre>+If you are logged in as "root", you can run NeoOffice as a non-root user using the following steps:
-:'''Note that the "-H" and "-u" parameters must be used.''' -->+# Launch the <tt>/Applications/Utilties/Terminal</tt> application
 +# Execute the following command in the Terminal window. Note: replace <tt>"<non-root user>"</tt> with the name of a non-root user on your machine:
 +<pre>sudo -H -u <non-root-user-name> /Applications/NeoOffice.app/Contents/MacOS/soffice.bin</pre>
-Also note that running as (or even enabling) root is discouraged under Mac OS X, and one should only use root if one is an experienced UNIX admin and has a good reason to do so.+=== Why does NeoOffice Classic Edition access the internet after the first launch? ===
-=== Why does NeoOffice access the Internet after the first launch? ===+When you first install a version of NeoOffice Classic Edition and once a week thereafter, NeoOffice will connect to our servers to check if there is any NeoOffice updates. If an update is available, NeoOffice will display a dialog prompting you to download the latest update.
-NeoOffice is regularly being improved. Bugs are being fixed and new features are constantly being added.+If you do need to disable this update checking feature (for example, you are in a managed environment and will be handling mass-deployment of NeoOffice patches yourself), see [[Disabling Patch Checking]] for instructions. If you disable patch checking, we recommend that you to follow us on Twitter [http://twitter.com/NeoOffice @NeoOffice] to get notified of all NeoOffice release announcements.
-When you first install a version of NeoOffice, and about once a week thereafter, the application will check the Internet to inform you of any [[NeoOffice Release Notes|new recommended patches or updates]] so that you can be sure that your version is always up-to-date. 
- 
-If a new patch is found, your preferred web browser should open and take you to the patch download page. 
- 
-Staying up-to-date will not only increase the stability of your software, it will cut down on the large number of "duplicate" bugs filed that have already been fixed in released patches. This helps ensure that limited development time can be spent on unfixed bugs and adding new features. 
-<!-- 
-This "patch-check" feature is often disabled in final release versions, since they are relatively stable and well-tested, and because users wish to deploy final releases in computer labs and enterprise environments.--> 
- 
-If you do need to disable the "patch-check" feature (for instance, you are in a managed environment and will be handling mass-deployment of NeoOffice patches yourself), see [[Disabling Patch Checking]] for instructions. ''If you disable patch checking, we '''strongly''' urge you to subscribe to the [http://www.neooffice.org/neojava/contact.php NeoJUpdate mailing list], closely watch the [[NeoOffice Release Notes]] page in this wiki, or use another method to keep aware of the latest patches.'' 
-<!-- 
-=== NeoOffice performance is rather lackluster and I see redrawing. Can I speed this up? === 
- 
-The redrawing is an unavoidable result of the combination of OpenOffice.org code and Java. Some of this will always remain. On a fast machine, it is so quick as to be barely noticable. 
- 
-In order to maximize your performance (and security) with NeoOffice, you should download and install Apple's lastest Java 1.4.2 update. There is a version for [http://www.apple.com/support/downloads/java131and142release2.html Tiger] and for [http://www.apple.com/support/downloads/javasecurityupdate.html Panther]. 
- 
-You can check your version by opening a terminal and typing <tt>java -version</tt>. If you get an output that says <tt>java version "1.4.2_09"</tt> (the latest at the time of writing) or higher, you should get good performance. You can find a chronological list of updates from [http://docs.info.apple.com/article.html?artnum=61798 Apple's website]. 
- 
-For other tips on improving performance, see [[Troubleshooting_Tips#Performance|the Performance section]] of the [[Troubleshooting Tips]] article. 
- 
-=== Why does NeoOffice ask me to register when I first run it? === 
- 
-Registration is not required to use NeoOffice. It is simply a way for developers to get a sense of who is using NeoOffice and to connect you with the web site, support fora, and Bugzilla. 
---> 
===Troubleshooting=== ===Troubleshooting===
Troubleshooting tips for other common problems can be found on the [[Troubleshooting Tips]] page. Troubleshooting tips for other common problems can be found on the [[Troubleshooting Tips]] page.
-=== How do I get rid of NeoOffice? ===+==How do I uninstall NeoOffice?==
- +
-You have tried NeoOffice and decided it is not for you. This happens sometimes. You can use these [[Uninstalling NeoOffice|instructions]] to remove NeoOffice without leaving any trace. Please note that you will no longer be able to read any spreadsheet ('''.ods'''), presentation ('''.odp'''), database ('''.odb'''), math ('''.odm'''), or graphics ('''.odg''') documents you may have saved in the OpenDocument file formats (TextEdit will open word processing ['''.odt'''] files).+
- +
-<!--Please leave a message in the [http://trinity.neooffice.org/modules.php?name=Forums&file=viewforum&f=8 NeoOffice Testing forum] describing what you found lacking in the application so that we know what improvements people are looking for.-->+
-===How do I cancel a recurring payment (subscription) to NeoOffice?===+
- +
-If you have decided that NeoOffice no longer fits your needs and had previously set up a recurring (monthly) payment via PayPal, the following methods will allow you to cancel that payment.+
- +
-'''Method 1:'''+
-# Log into your PayPal account+
-# Visit your account's "My Account" > "Overview" page.+
-# Click on a recent NeoOffice payment listed on that page.+
-#: This will display the details of that payment and you should see a link to the PayPal subscription number.+
-# Click on that subscription number link, and the page that appears should have a "cancel subscription" button.+
-'''Method 2:'''+To uninstall the NeoOffice application, go to the Finder and drag NeoOffice from the <tt>/Applications</tt> folder to the Trash and empty the Trash. If you also want to remove any folders that contain your NeoOffice user preferences, macros, and extensions, see [[Uninstalling NeoOffice|Uninstalling NeoOffice]].
-# Log into your PayPal account.+
-# Go to "My account" > "Profile" > "My money" > "My pre-approved payments" > "Update" to see a list of recurring payments.+
-# You can then cancel those recurring payments you no longer wish to continue, e.g., the one for NeoOffice.+
-If these steps are not clear or you need more help, vist the PayPal Help Center and search for "How do I cancel a subscription?" to see PayPal’s step-by-step walkthrough.+==Send us a description of your installation problem==
-{{botlangbarEN|[[Fr:Problèmes d'installation de NeoOffice|Français]] [[de:Installationsprobleme_und_Lösungen|Deutsch]] [[It:Installare_NeoOffice|Italiano]] [[Es:Cómo instalar NeoOffice|Español]] [[nl:Installatie Vragen en Oplossingen|Nederlands]]}}+{{bluebox|SendUsInstallationProblemsInstructions}}
[[Category:NeoOffice]][[Category:Tips and Hints]] [[Category:NeoOffice]][[Category:Tips and Hints]]

Revision as of 02:07, 22 February 2016

Contents

Downloading NeoOffice Class Edition from our website

Existing users who have made a payment during the last year

If you are an existing NeoOffice user who has made a payment within the last year, you will be able to download the newest NeoOffice releases as normal. When your services expire in the future, you will be able to make a new payment using the method described below.

Existing users who have not made a payment during the last year

If you are an existing NeoOffice user who has not made a payment within the last year, has not made a payment dispute in the past, and would like to download one of the newest NeoOffice releases, follow these steps in order to make a new payment:

  1. Visit the NeoOffice download page and click on NeoOffice Classic Edition.
  2. Login using the e-mail address that you used when you made your last PayPal payment.
  3. If you have not made a payment during the last year, a PayPal payment form will appear. Follow the instructions on that page to make a new payment.

Download fails or cannot open downloaded file

This error usually means that the NeoOffice .dmg file was not completely downloaded. The NeoOffice download file is very large and some internet service providers disconnect your connection to our web server before the download has finished.

To fix this problem, try the following steps. These steps will use Safari to resume the download without starting a new download. Safari has the ability to resume the download if your internet service provider disconnects your connection. Note: these steps only work in Safari and they do not work in Firefox or Chrome:

  1. Launch the Safari web browser and load the NeoOffice download page in Safari
  2. Start a new download of NeoOffice by clicking on the NeoOffice Classic Edition button and logging in using your e-mail address
  3. Every few minutes, check on the download by clicking the Downloads toolbar button as shown in the screen snapshot to the right. If the progress bar in the Downloads popup window is replaced by an error message, press the Resume downloading icon that is circled in red.
  4. After pressing the Resume downloading icon, the download progress bar should reappear and the download should resume. If the download stops again, repeat the previous step.

I want to download NeoOffice 3.4.1 but I only see NeoOffice 2015 Classic Edition

If you are running Mac OS X 10.6 - 10.10 and you do not want to upgrade to NeoOffice 2015 Classic Edition, you can download the older NeoOffice 3.4.1 version here.

Downloading NeoOffice from the Mac App Store

A version of NeoOffice is in Apple's Mac App Store which you can download from here. Although our Mac App Store version costs more than our Classic Edition versions, you only need to purchase the Mac App Store version once and then all upgrades to future Mac App Store versions will be free.

Before Installing

Do I need to uninstall a previous version of NeoOffice first?

No. NeoOffice will install over an existing NeoOffice installation. After upgrading, you may want to check for upgrades to any third-party dictionaries that you may have previously installed.

Can I have two versions of NeoOffice installed on the same machine?

Yes. To install a second version of NeoOffice, use the following steps:

  1. In the Finder, create a copy of your NeoOffice installation by navigating to the /Applications fodler and right-clicking or Control-clicking on the NeoOffice icon. In the popup menu that appears, select the Duplicate menu item. This will create a new NeoOffice installation in the /Applications folder.
  2. Install the new version of NeoOffice. The installer will upgrade either the original installation or the copied installation that you created but it will not upgrade both.
  3. When you no longer need to use one of the versions, drag the undesired version of NeoOffice from the /Applications folder to the Trash, empty the Trash.

Note: while you can have two versions of NeoOffice installed on the same machine, in most cases only one version can be run at a time. You must quit the running version of NeoOffice before you launch a different version of NeoOffice.

Do I need to uninstall OpenOffice or LibreOffice first?

No. NeoOffice will not harm your OpenOffice or LibreOffice installation. NeoOffice uses separate folders to store your user preferences, macros, and extensions so you do not need to uninstall either OpenOffice or LibreOffice.

To have the Finder open files in NeoOffice instead of in OpenOffice or LibreOffice, see Setting the default application.

NeoOffice Class Edition Installation Issues

When double-clicking on the .dmg file, there is an error about "image not recognized"

This error usually means that the NeoOffice .dmg file was not completely downloaded. To fix this problem, try these steps.

Installation stalls when it gets to the "Select Destination" panel

The installer sometimes hangs when it gets to the "Select Destination" panel and no drives in that panel will be selectable.

Unreachable or unreadable volumes on your Mac

The Apple Installer is known to hang when probing all of the volumes on your system if any of your volumes are unreadable.

Try opening each of the volumes on your desktop in the Finder and unmounting any iPods. Once you can open all volumes, then try rerunning the installer. If opening any volumes causes the Finder to hang, you have found the cause of the problem and you might need to reboot to force Mac OS X to unmount the offending volume.

Virus Barrier X6 software

VirusBarrier X6 is known to crash while scanning NeoOffice’s pre-installation scripts, thereby blocking the Apple Installer from continuing. Sometimes after a period of 10 minutes Apple’s installer will recover.

You may be able to prevent this problem from occurring by temporarily disabling the “Scanning & Firewall” feature of VirusBarrier X6 before trying to install NeoOffice or a NeoOffice patch.

If neither temporarily disabling the “Scanning & Firewall” feature of VirusBarrier X6 nor waiting 10 minutes of the Apple Installer to recover works, you may have to completely uninstall VirusBarrier X6.

Installation fails with a "Install Failed. The source media you are installing from is damaged" error message

For some users, installation will fail and the following error message will appear:

Install Failed. The source media you are installing from is damaged

If you see this message, most likely the disk image you downloaded is corrupted. We recommend that you delete the corrupted file and redownload NeoOffice.

Why does the NeoOffice installer request my administrator password?

The NeoOffice installer is designed to not only support launching NeoOffice on a single user machine, but also to support launching NeoOffice from a shared network volume and launching NeoOffice by any user on a multi-user machine. We have found that installing as an administrative user is the only reliable way to handle all of these types of installation.

Mac App Store Installation Issues

The Mac App Store has not finished installing NeoOffice after several minutes

If you see the Installing button in Apple's App Store application for more than a few minutes, this usually means that the App Store application is still downloading NeoOffice from Apple's servers. NeoOffice is a very large download so Apple's App Store application will show the Installing button for at least a few minutes and, if you have a slow internet connection, 15 minutes or longer.

To see the NeoOffice download progress, click on the Purchases toolbar button in the App Store application as shown in the screen snapshot below. The App Store application will usually finish the installation within a minute or two after the download is finished.

Image:NeoOffice download progress macappstore.png

Java Installation Issues

NeoOffice Classic Edition

Some features in NeoOffice Classic Edition require Java. If you see the dialog shown below while running NeoOffice Classic Edition, you need to install the Java SE Development Kit (JDK) from Oracle.

To download the Java SE Development Kit (JDK) from Oracle, press the Download button in the dialog shown below or download it from here. Note: only Oracle's JDK will work NeoOffice Classic Edition. Neither Apple's Java nor Oracle's Java SE Runtime Environment (JRE) will work.

Image:Java not found dialog.png

Mac App Store

Apple does not allow applications in the Mac App Store to use Java so all features that require Java have been removed from the Mac App Store version of NeoOffice.

If you purchased NeoOffice from the Mac App Store but you need to use a feature that uses Java, we recommend that you do the following steps:

  1. Uninstall the Mac App Store version of NeoOffice
  2. Purchase NeoOffice Classic Edition from the NeoOffice download page
  3. Ask Apple for a refund of your Mac App Store purchase

Patch Installation Issues

The patch installer refuses to start the installation.

If none of the volumes in the installer's "Select a Destination" panel are selectable, there are possible causes for this:

The patch is for a version of NeoOffice newer than the version installed on your computer

Patches for the latest version of NeoOffice will not apply to earlier versions of NeoOffice. Patches can only be installed when a specific version of NeoOffice is already installed. For example, NeoOffice 2015 Classic Edition must already be installed before you can install NeoOffice 2015 Classic Edition Patch 1.

To fix this problem, download and install the latest version of NeoOffice from the NeoOffice download page. After installing the latest version, select the Help > Check for Updates menu to check if you have the latest patch.

NeoOffice is not located in the /Applications folder

The message will also appear if you have moved NeoOffice from your /Applications folder, or if you have renamed NeoOffice. The patch installer will only search the /Applications folder for NeoOffice installations. If you have moved NeoOffice out of the /Applications folder, quit the installer, move NeoOffice back into your /Applications folder, run the installer, and then move NeoOffice back to its original folder.

Post-Installation and First Launch Issues

Cannot save documents

If you see the dialog shown in the screen snapshot to the right when you edit or try to save a document, then the problem is that you have launched NeoOffice Viewer. NeoOffice Viewer can only view files and cannot save documents.

To fix this problem, right-click or Control on the NeoOffice icon in the Dock while NeoOffice Viewer is still running. In the popup menu that appears, select the Options > Show in Finder menu item. A Finder window will appear. Quit NeoOffice, drag the NeoOffice application in that Finder window to the Trash, and empty the Trash.

If you have not already installed NeoOffice Classic Edition or NeoOffice from the Mac App Store, install either now. If you already installed on of them, double-clicking on a NeoOffice file in the Finder should now launch NeoOffice Classic Edition or NeoOffice from the Mac App Store.

Check your language settings before launching NeoOffice

NeoOffice uses the first language in the Preferred languages: list in the Language & Region panel in the System Preferences application.

Some languages have more than one form (English has US English, British English, Australian English, etc.). To add another language or language form, launch the System Preferences application, click on the Language & Region icon, and click the + button below the Preferred languages: list. After adding a new language, move that language to the top of the Preferred languages: list and restart NeoOffice.

See Troubleshooting Spellcheck for further details on issues with certain languages.

Why doesn't NeoOffice let me run it as "root"?

Running as root is disabled on purpose. Several years ago we found that when running as root, NeoOffice's underlying OpenOffice code would modify files with the /Applications/NeoOffice.app folder. This, in turn, caused NeoOffice to not be launchable from a shared network volume or launchable by any non-root user on a multi-user machine.

If you are logged in as "root", you can run NeoOffice as a non-root user using the following steps:

  1. Launch the /Applications/Utilties/Terminal application
  2. Execute the following command in the Terminal window. Note: replace "<non-root user>" with the name of a non-root user on your machine:
sudo -H -u <non-root-user-name> /Applications/NeoOffice.app/Contents/MacOS/soffice.bin

Why does NeoOffice Classic Edition access the internet after the first launch?

When you first install a version of NeoOffice Classic Edition and once a week thereafter, NeoOffice will connect to our servers to check if there is any NeoOffice updates. If an update is available, NeoOffice will display a dialog prompting you to download the latest update.

If you do need to disable this update checking feature (for example, you are in a managed environment and will be handling mass-deployment of NeoOffice patches yourself), see Disabling Patch Checking for instructions. If you disable patch checking, we recommend that you to follow us on Twitter @NeoOffice to get notified of all NeoOffice release announcements.

Troubleshooting

Troubleshooting tips for other common problems can be found on the Troubleshooting Tips page.

How do I uninstall NeoOffice?

To uninstall the NeoOffice application, go to the Finder and drag NeoOffice from the /Applications folder to the Trash and empty the Trash. If you also want to remove any folders that contain your NeoOffice user preferences, macros, and extensions, see Uninstalling NeoOffice.

Send us a description of your installation problem

Personal tools