Troubleshooting Tips

From NeoWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 16:54, 4 September 2006 (edit)
Ovvldc ( | contribs)
(NeoOffice fails to start, or crashes during startup or right after starting - added permissions)
← Previous diff
Current revision (20:52, 16 August 2012) (edit) (undo)
Sardisson (Talk | contribs)
m (installation->download and installation)
 
(85 intermediate revisions not shown.)
Line 1: Line 1:
-{{fixme}}+There are several common sources of problems that cause crashes, sub-optimal performance, or other undesired behavior in NeoOffice. This page collects some common problems and tips to help narrow down the cause of, or in some cases even fix, the problem. (For problems related to installing NeoOffice or NeoOffice patches, see [[NeoOffice Download and Installation Issues]] instead.)
-There are several common sources of problems that cause crashes or sub-optimal performance in NeoOffice. This page collects some common problems and tips to help narrow down the cause of, or in some cases even fix, the problem.+
-==NeoOffice fails to start, or crashes during startup or right after starting==+To use this page, locate the problem you are experiencing under the "Common Problems" section. Then click on the link or links provided for more information about troubleshooting steps you should try. If you do not find your particular problem under Common Problems, try to find a similar issue, or ask your question in the [http://trinity.neooffice.org/modules.php?name=Forums&file=viewforum&f=7 NeoOffice Support] forum on trinity.
-* Check if the relevant <tt>soffice.*</tt> files have executable permissions.+ 
 +==Common Problems==
 + 
 +===For all problems===
 +<!--''what do we call this section?''-->
 +* [[#Install NeoOffice Patches|Install NeoOffice Patches]]
 +* [[#Update Mac OS X|Update Mac OS X]]
 + 
 +===NeoOffice takes more than a minute to launch===
 +* [[#Disable system hacks|Disable system hacks]]
 +* [[#Remove 24Uemail scripting addition|Remove 24Uemail scripting addition]]
 +* [[#Check the number of fonts installed|Check the number of fonts installed]]
 +* [[#Check for OpenOffice.org 2|Check for OpenOffice.org 2]]
 +* [[#Beware of virus scanning software|Beware of virus scanning software]]
 + 
 +===NeoOffice fails to start, or crashes during startup or right after starting===
 + 
 +* [[#Disable system hacks|Disable system hacks]]
 +* [[#Remove 24Uemail scripting addition|Remove 24Uemail scripting addition]]
 +* [[#Check the Console.log|Check the Console.log]]
 +* [[#Ensure NeoOffice has the correct permissions|Ensure NeoOffice has the correct permissions]]
 +* [[#Sample NeoOffice in hangs during the startup process|Sample NeoOffice in hangs during the startup process]]
 +* [[#Post the crash log for crashes during startup|Post the crash log for crashes during startup]]
 +* [[#Check for an up-to-date Java version|Check for an up-to-date Java version]]
 +* [[#Check for a corrupt Java installation|Check for a corrupt Java installation]]
 +* [[#Check for corrupted Java Shared Archive|Check for corrupted Java Shared Archive]]
 +* [[#Remove incompatible Java extensions|Remove incompatible Java extensions]]
 +* [[#Check for a non-standard Java installation|Check for a a non-standard Java installation]]
 +* [[#Check for corrupted user preference files|Check for corrupted user preference files]]
 + 
 +===NeoOffice crashes randomly===
 + 
 +* [[#Disable system hacks|Disable system hacks]]
 +* [[#Check for corrupted user preference files|Check for corrupted user preference files]]
 +* [[#Check the Console.log|Check the Console.log]]
 + 
 +===Problems with the menus or menu bar===
 + 
 +* [[#Disable system hacks|Disable system hacks]]
 +* [[#Disable MenuCracker|Disable MenuCracker]]
 + 
 +===Dialogs or windows appear with no text===
 +* [[#Check for the Tahoma font|Check for the Tahoma font]]
 + 
 +===Crashing in the font drop-down===
 +* [[#Disable corrupt fonts|Disable corrupt fonts]]
 + 
 +===Text appears as gibberish, or certain characters are incorrect===
 +* [[#Check for duplicate fonts|Check for duplicate fonts]]
 + 
 +===Error Loading BASIC of Document===
 +* [[#Remove macros imported from older NeoOffice versions|Remove macros imported from older NeoOffice versions]]
 + 
 +===Performance===
 +''Common causes of slow or lackluster performance''
 + 
 +* [[#Check for background processes|Check for background processes]]
 +* [[#Disable auto spell-checking|Disable auto spell-checking]]
 +* [[#Insufficient RAM|Insufficient RAM]]
 +* [[#Check the number of fonts installed|Check the number of fonts installed]]
 +* [[#Check for OpenOffice.org 2|Check for OpenOffice.org 2]]
 +* [[#Beware of virus scanning software|Beware of virus scanning software]]
 + 
 +===A patch does not appear to fix a bug it claims to fix===
 +<!--''I'm not sure this is still valid; I think Patrick has included work-arounds to prevent this condition''-->
 +* [[#Reboot to clear cached libraries|Reboot to clear cached libraries]]
 + 
 +===Preferences don't seem to stick===
 +*[[#Check for corrupted user preference files|Check for corrupted user preference files]]
 + 
 +===Certain keyboard shortcuts do not work===
 +*[[#Check for shortcuts used by Mac OS X|Check for shortcuts used by Mac OS X]]
 +*[[#Check for shortcut conflicts within NeoOffice|Check for shortcut conflicts within NeoOffice]]
 +<!--*[[#Use Java 1.4.2 instead of Java 1.5|Use Java 1.4.2 instead of Java 1.5]]-->
 + 
 +===Documents zoom in and out unexpectedly===
 +*[[#Disable trackpad gestures|Disable trackpad gestures]]
 + 
 +===NeoOffice claims a document is in use by another user after a crash===
 +*[[#Remove stuck lock files|Remove stuck lock files]]
 + 
 +==Solutions and Troubleshooting Steps==
 +Below are a series of solutions and troubleshooting steps that may help resolve common problems you may be experiencing with NeoOffice.
 + 
 +===General Troubleshooting===
 +====Install NeoOffice Patches====
 +* Always make sure that you are using the latest [http://download.neooffice.org/neojava/patch.php NeoOffice patch].
 +** NeoOffice is updated regularly through [http://download.neooffice.org/neojava/patch.php patches], and it is often the case that an issue you are experiencing has been fixed by the latest patch, so be sure you regularly install the patches.
 + 
 +====Update Mac OS X====
 +* Always make sure that you are using the latest iteration of Mac OS X (e.g., 10.3.9 or 10.4.10) and the latest available '''security and Java updates''' from Apple (see [[#Check_for_an_up-to-date_Java_version|below]] for instructions on using '''Software Update''' and checking your Java version).
 +** While NeoOffice might run on older revisions of Mac OS X 10.3 and 10.4, each patch is only qualified against the latest "point" release at the time of patch release.
 +** Similarly, each NeoOffice patch is only qualified against the latest Java update for the appropriate Mac OS X version, and '''not having the latest Java update will cause bizarre and otherwise unexplained issues'''.
 + 
 +====Disable system hacks====
 +* Disable or uninstall any installed hack-like software, or add NeoOffice to the exclusions list for any APE haxie(s).
 +*:Hack-like software, such as as InputManagers, SIMBL "plugins", or haxies (programs that use [http://www.unsanity.com/haxies/ape/ Unsanity's Application Enhancer (APE) framework]), works by injecting its code into running applications in order to customize the behavior of Mac OS X or an application in a way that neither Apple nor the application developer intended. One of these programs may have a bug that causes an application to crash, or it may simply create a condition that the application is not prepared to handle and thereby cause a crash.<br>
 +*:Because of the scope of the project and the limited time and resources of the NeoOffice developers, no effort will be made to fix a bug that only occurs when hack-like software is present. Note also that [http://lists.apple.com/archives/carbon-dev/2007/Mar/msg00225.html Apple's official support policy] is to disregard all reports of problems that occur when APE is present.
 +**Some haxies, particularly older ones, can cause NeoOffice to run up to 10 times slower than on machines that do not have the haxie.
 +** Not all random crashes are caused by haxies, but we have found a disproportionate correlation between the presence of haxies and strange NeoOffice crashes (this was particularly true of NeoOffice versions prior to 1.2 Alpha, which used Java 1.3.1). Many [http://www.glorifiedtypist.com/2005/11/labor_saving_devices.html other] [http://www.redlien.com/blog/?p=32 Mac developers] have experienced similar issues with their applications when haxies are present. <!-- we should watch out for mach_inject-using apps, too: http://rentzsch.com/mach_inject/mach_Users -->
 +*To determine if you have hack-like software, and to disable it if you do:
 +**Check to see if you have Unsanity APE installed by opening the System Preferences application. If there is an Unsanity APE icon at the bottom of the window, click on it and then disable it (or at least disable it for NeoOffice).
 +** In each of the following folders, check for any subfolders named '''ApplicationEnhancer.bundle''' or '''Smart Crash Reports''' or '''SIMBL'''. If you find any, move them out of the folders and reboot your machine:
 +**:<tt>/System/Library/SystemConfiguration</tt>
 +**:<tt>~/Library/InputManagers</tt>
 +**:<tt>~/Library/Application Support</tt>
 +**:<tt>/Library/InputManagers</tt>
 +**:<tt>/Library/Application Support</tt>
 +**::''Remember that ~/ represents your home folder, and that the leading / represents the startup volume (usually Macintosh HD).''
 + 
 +====Disable MenuCracker====
 +* MenuCracker, while not an Unsanity APE haxie, is a hack for enabling third parties to add items to the Mac OS X menu bar, and it has caused problems in the past, such as the disappearance of NeoOffice's menus from the menu bar.
 + 
 +====Disable trackpad gestures====
 +* Many users have reported that their MacBook laptop's trackpad is too sensitve and that causes NeoOffice documents to zoom in and out unexpectedly. Since Mac OS X does not provide any way to reduce trackpad sensitivity, starting with NeoOffice 2.2.5 Patch 5 users can stop unexpected zooming by disabling all trackpad magnify and swipe gestures. To disable these trackpad gestures, do the following:
 +** Make sure that you have installed the latest NeoOffice patch from the [http://www.neooffice.org/neojava/patch.php patch download page]
 +** Launch the <tt>/Applications/Utilities/Terminal</tt> application, copy the following command into the Terminal window, and press the Return key:<br/><tt>defaults write org.neooffice.NeoOffice IgnoreTrackpadGestures -bool yes</tt>
 +** Restart NeoOffice
 + 
 +====Remove stuck lock files====
 +If NeoOffice 3.0 crashes while a file is open, sometimes you will be unable to open or edit the file when you reopen it, and NeoOffice will warn you that the file is in use by another user. Beginning in OpenOffice.org 3.0, Sun engineers changed from using native file locking methods used by all applications on a particular operating system to using an invisible file only OpenOffice.org-based applications recognize. When the application crashes, the lock file is not removed and NeoOffice still thinks that the document is in use. To use the document again, you must clear the file.
 + 
 +* The preferred method of clearing the lock file is reopening and then closing the file by the same user in the same application that the crash occurred in.
 +*: For example, if you had the file open in NeoOffice and NeoOffice crashed, you need to open and close the file in NeoOffice. If a colleague opened the file in OpenOffice.org and it crashed, then your colleague must open and close the file in OpenOffice.org.
 + 
 +* If it is not feasible for the original person reopen and close the file, or if that method does not work, you can remove the lock file manually:
 +*# Launch the <tt>/Applications/Utilities/Terminal</tt> application, copy the following text, paste it into the Terminal window, and press the spacebar:
 +*#:<pre>cd</pre>
 +*# Go to the '''Finder''' and drag the ''folder'' that contains the read-only file into the Terminal window.
 +*# Copy the following text, paste it into the Terminal window, and press the {{key|Return}} key:
 +*#:<pre>; rm .~lock.*</pre>
 + 
 +You should now be able to access and edit your file again.
 + 
 +====Check for corrupted user preference files====
 +* Corrupted user preference files can cause crashes as well as unexpected behavior when the application is running. When preferences or settings changes don't seem to apply or don't stick between restarts of NeoOffice, the most likely cause is a some sort of corruption of your profile/preferences. Allowing NeoOffice to create a fresh set should fix the problem.
 +# Quit NeoOffice.
 +# Move or rename your <tt>~/Library/Preferences/NeoOffice-3.0</tt> (for 3.0) and <tt>~/Library/Preferences/NeoOffice-2.2</tt> (for 2.2.x) and <tt>~/Library/Preferences/NeoOffice-2.1</tt> (for 2.1) folders.
 +# Launch NeoOffice; it will then create a fresh preferences folder and settings.
 +* For instructions on how to narrow down the specific corrupted preference file (in order to save other preferences), see [[Recovering Settings from Old or Corrupt Preferences]].
 + 
 +====Check the Console.log====
* Check the Console.log (via <tt>/Applications/Utilities/Console.app</tt>) for messages about Java, soffice.bin, or NeoOffice * Check the Console.log (via <tt>/Applications/Utilities/Console.app</tt>) for messages about Java, soffice.bin, or NeoOffice
-* Check for a '''current''' entry in <tt>~/Library/Logs/CrashReport/soffice.bin.crash.log</tt> (the crash log for NeoOffice, and, unfortunately OpenOffice.org)+** These messages may not make any sense to you, but providing them to NeoOffice community support volunteers may enable the volunteers to identify the source of your problem.
 + 
 +====Ensure NeoOffice has the correct permissions====
 +* If the NeoOffice icon bounces in the Dock for a while and then stops, open the Terminal (<tt>/Applications/Utilities/Terminal.app</tt>) and type the following and then press return:
 +** <tt>cd /Applications/NeoOffice.app/Contents/program</tt>
 +** <tt>ls -al soffice.bin</tt>
 +*** The first few characters should contain <tt>x</tt> three times.
 +*** If not, type <tt>chmod +x soffice.bin</tt>, close the Terminal and try to launch NeoOffice again.
 + 
 +====Sample NeoOffice in hangs during the startup process====
 +* If NeoOffice starts but “hangs” during startup (longer than a minute or so on recent Macs), take a [[Bugzilla_Guide#Obtaining_a_sample_when_NeoOffice_hangs_.28displays_the_spinning_beachball.29|sample]] before force-quitting NeoOffice, one of the developers or community support team might be able to deduce the problem based on log info.
 + 
 +====Post the crash log for crashes during startup====
 +* If NeoOffice crashes, check for a '''current''' entry in <tt>~/Library/Logs/CrashReport/soffice.bin.crash.log</tt> (the crash log for NeoOffice, and, unfortunately OpenOffice.org)
*: These logs will often contain useful information, and even if they are gibberish to you, one of the developers or community support team can often deduce the problem based on log info. *: These logs will often contain useful information, and even if they are gibberish to you, one of the developers or community support team can often deduce the problem based on log info.
*: See [[Bugzilla_Guide#Obtaining_a_crashlog_when_NeoOffice_crashes|this section of the Bugzilla Guide]] for more information about obtaining the crash log. *: See [[Bugzilla_Guide#Obtaining_a_crashlog_when_NeoOffice_crashes|this section of the Bugzilla Guide]] for more information about obtaining the crash log.
-* Check to see if you are running the most up-to-date version of Java 1.4.2+ 
 +====Insufficient RAM====
 +* NeoOffice requires a Mac with at least 512 MB of RAM (memory). While NeoOffice will run on a Mac with 512 MB of RAM, it will run (and launch) more slowly, particularly if you have other applications also running (Mac OS X really runs best with 512 MB or more of RAM).
 +** Add more RAM to your Mac
 +**:Luckily, RAM is cheap; adding RAM is the most cost-efficient way to speed up your Mac. See [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=2201 this thread] for some real-life stories.
 +** Quit other applications before running NeoOffice
 + 
 +====Check for background processes====
 +* Constantly-running background processes can degrade the performance of NeoOffice. If you open the '''Activity Monitor''' application, located in the '''Utilities''' subfolder of the '''Applications''' folder, and click of the '''CPU''' or '''System Memory''' tabs, you can see which applications are using the most processing power and memory on your machine. Some known culprits include:
 +** Seti@Home
 +** Folding@Home
 +** DNET client (http://www.distributed.net/)
 +** Dashboard/widgets
 +**: disable all inessential widgets for best performance
 +* If you have any of these applications running, or if '''Activity Monitor''' identifies another application using all of your CPU or RAM, try quitting the application(s) before running NeoOffice.
 + 
 +====Disable auto spell-checking====
 +* Turn off auto spell-checking, because the wavy lines are a problem to draw.
 +*: Due to the fact that the OpenOffice.org code sets individual pixels and Cocoa and Java (used for drawing in NeoOffice) don't have any functions for setting individual pixels, NeoOffice must do a much more expensive operation of drawing a 1x1 pixel filled rectangle for each dot in the wavy lines.
 + 
 +====Beware of virus scanning software====
 +* Some virus scanners scan all files when the files are opened, and other virus scanners scan archive files (<tt>.sit</tt>, <tt>.tar</tt>, <tt>.gz</tt>, and <tt>.zip</tt> and its cousins, like <tt>.jar</tt>) when those files are accessed; NeoOffice opens and access a large number of files at startup, including a number of <tt>.zip</tt> and <tt>.jar</tt> archives.
 +** Disable virus scanning of the NeoOffice application (<tt>/Applications/NeoOffice.app</tt>) and preferences directory (<tt>~/Library/Preferences/NeoOffice-3.0</tt> for 3.0 or <tt>~/Library/Preferences/NeoOffice-2.2</tt> for 2.2.1 or <tt>~/Library/Preferences/NeoOffice-2.1</tt> for 2.1), or of just the archive-type files in the NeoOffice application and preferences directory.
 + 
 +====Remove macros imported from older NeoOffice versions====
 +*The error message '''Error Loading BASIC of document file:///xxxxx/xxxx/xxx General input/output error''' occurs when some BASIC files (macros) are imported from preferences files of older NeoOffice versions. To get rid of the annoying message, do the following:
 +*# In the {{menu|Tools}} menu, select the {{menu|Macros}} sub-menu, then the {{menu|Organize Macros}} sub-menu, and finally the {{menu|NeoOffice Basic}} item
 +*# In the dialog that appears, press the {{button|Organizer}} button
 +*# In the dialog that appears, expand all of the macros in the {{prefName|My Macros}} item and check the path in each.
 +*# For any items that have a path that does not exist, select the item and press the {{button|Delete}} button.
 + 
 +====Check for shortcuts used by Mac OS X====
 +* If you assign a keyboard shortcut in NeoOffice and it doesn't work, it may be because you've chosen a key combination that Mac OS X is already using either as a general system shortcut or is in use by one of the system-wide Services.
 +** Look in the '''System Preferences''' ({{section|Keyboard & Mouse}} preference pane, {{section|Keyboard Shortcuts}} tab) to see if your choice is in use already as a general system shortcut (''this option is only available in Mac OS X 10.4'').
 +** Open an application that supports many system Services, e.g. '''TextEdit''', and look in the {{menu|Services}} sub-menu of the application's {{menu|''Application Name''}} menu to see if any Services are using your chosen key combo (e.g., {{key|cmd-shift-L}} is often assigned to {{menu|Search with Google}}).
 +**: If you never use the Services keyboard shortcuts and want to free them up, you can install:
 +*** The [http://www.blacktree.com/apps/servicemanager/index.html Service Manager] preference pane (freeware) to disable individual Services (works in 10.3.x and 10.4.x)
 +*** The [http://www.manytricks.com/servicescrubber/ ServiceScrubber] application (freeware) to disable Services or reassign their keyboard shortcuts (10.4.x)
 + 
 +====Check for shortcut conflicts within NeoOffice====
 +* If a key combination appears in one of the NeoOffice menus as a shortcut but doesn't actually work, it may be assigned to another command in the current NeoOffice module.
 +** If you assign a shortcut as a Global NeoOffice shortcut, it may be overridden by a shortcut assigned to the particular module you're in (e.g., [[NeoWriter|Writer]], [[NeoCalc|Calc]], etc.)
 +**:This is the case with {{key|cmd-shift-F11}}, for example; the menu shows this key combination as calling up the {{Window|Preferences}} window (via the {{menu|Options}} item in the {{menu|Tools}} menu), but this doesn't work in Writer, as Writer has it assigned to something else arcane to do with templates.
 +** Once you delete the module-specific assignment, the shortcut performs the command displayed in the menu.
 + 
 +====Reboot to clear cached libraries====
 +* Mac OS X "caches" shared libraries and Java classes to improve performance; unfortunately, it has a very nasty habit of not clearing the cache when updated libraries and classes are installed (like in NeoOffice patches). If a bug doesn't appear to be fixed after applying a patch that should fix the bug, try restarting your Mac, which will clear the old versions of libraries and classes from cache. If the bug is still present after rebooting, you can then reopen the bug in [http://bugzilla.neooffice.org Bugzilla].
 + 
 +===Java-Related Troubleshooting===
 +====Check for an up-to-date Java version====
 +<!-- need to keep these updated these for Java 1.5 on 10.4, and the "latest java version" for 1.4.2 and 1.5 on 10.4.10)-->
 +* Check to see if you are running the most up-to-date version of Java 1.5 on Mac OS X 10.4 and 10.5 and Java 1.6 on Mac OS X 10.6
 +** Run the Mac OS X '''Software Update''' application (from the Apple menu) and install any Mac OS X Updates, Security Updates, and Java Updates that are offered. You may need to run Software Update multiple times in order to completely update your system. '''Do not ignore or skip installing a Java update for Java 1.5 or Java 1.6 because you only use the other version''', as a Java update for one often blocks the appearance in Softwsre Update of updates for the other.
** Open the Terminal (<tt>/Applications/Utilities/Terminal.app</tt>) and type the following and then press return:<br><pre>java -version</pre> ** Open the Terminal (<tt>/Applications/Utilities/Terminal.app</tt>) and type the following and then press return:<br><pre>java -version</pre>
-*** Mac OS X 10.3.9:<br><code>java version "1.4.2_09"<br>Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_09-233)<br>Java HotSpot(TM) Client VM (build 1.4.2-56, mixed mode)</code>+<!--*** Mac OS X 10.3.9:<br><code>java version "1.4.2_12"<br>Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_12-270)<br>Java HotSpot(TM) Client VM (build 1.4.2-70, mixed mode)</code>-->
-*** Mac OS X 10.4.3:<br><code>java version "1.4.2_09"<br>Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_09-232)<br>Java HotSpot(TM) Client VM (build 1.4.2-54, mixed mode)</code>+*** Mac OS X 10.4.10 or later:<br><code>java version "1.5.0_13"<br>Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_13-b05-241)<br>Java HotSpot(TM) Client VM (build 1.5.0_13-121, mixed mode, sharing)</code>
-* Check for a corrupt Java 1.4.2 installation+*** Mac OS X 10.5.8 : <br><code>java version "1.5.0_28"<br>Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_28-b04-382-9M3326)<br>Java HotSpot(TM) Client VM (build 1.5.0_28-157, mixed mode, sharing)</code>
 +*** Mac OS X 10.6.7 or later:<br><code></code>
 + 
 +====Check for a corrupt Java installation====
 +* Check for a corrupt Java installation
*# Create a plain-text file called '''Test.java''' and put the following lines in it, saving afterwards:<br> *# Create a plain-text file called '''Test.java''' and put the following lines in it, saving afterwards:<br>
-*#:+*#:{{preBox|<nowiki>import java.awt.*;
-<pre>import java.awt.*;+
-public class Test {+public class Test extends Panel {
 + 
 + public void paint(Graphics g) {
 + 
 + Graphics2D g2 = (Graphics2D)g;
 + g2.setColor(Color.black);
 + Font font = new Font("Arial", Font.PLAIN, 12);
 + g2.setFont(font);
 + g2.drawString("Java works", 100, 100);
 + 
 + }
public static void main(String[] args) { public static void main(String[] args) {
Frame f = new Frame(); Frame f = new Frame();
- Panel p = new Panel();+ Test p = new Test();
f.add(p); f.add(p);
f.setSize(500, 500); f.setSize(500, 500);
Line 29: Line 247:
} }
-}</pre>+}</nowiki>}}
-*# Open the Terminal (<tt>/Applications/Utilities/Terminal.app</tt>) and "cd" to the folder that you put the '''Test.java''' file in.+*# Open the Terminal (<tt>/Applications/Utilities/Terminal.app</tt>) and "<tt>cd</tt>" to the folder that you put the '''Test.java''' file in.
-*# Compile the '''Test.java''' file using the following terminal command:<br><pre><nowiki>javac Test.java</nowiki></pre>+*# Compile the '''Test.java''' file using the following terminal command:<br>
-*# Run the compiled program with Java 1.4.2 using the following terminal command:<br><pre><nowiki>/System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/Commands/java -classpath . Test</nowiki></pre>+*#:<pre><nowiki>javac Test.java</nowiki></pre>
-*# If a blank window appears when you run the program, then you know that Java 1.4.2 is working. [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=10697#10697] (modified for Java 1.4.2)+*# Run the compiled program with the version of Java you are using with NeoOffice by using the following terminal command:
-* Java Shared Archive corrupted (would this be detected by the above?)+<!--*#* Java 1.4.2 (default on Mac OS X 10.3; alternate option on Mac OS X 10.4):<br><pre><nowiki>/System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/Commands/java -classpath . Test</nowiki></pre>-->
-*: Often caused by some 10.3.x update; Apple issued another update to fix it (but other causes, too; Terry had a potential solution for them)+*#* Java 1.5.0 (default on Mac OS X 10.4 and 10.5):<br><pre><nowiki>/System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Commands/java -classpath . Test</nowiki></pre>
 +*#* Java 1.6.0 (default on Mac OS X 10.6):<br><pre><nowiki>/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Commands/java -classpath . Test</nowiki></pre>
 +*# If a blank window appears when you run the program, then you know that Java is working. [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=10697#10697] <!--(attempted to update for Java 1.6/Mac OS X 10.6)-->
 + 
 +====Remove incompatible Java extensions====
* You have installed a Java extension in one of the following folders and it is messing up your JVM [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=14040#14040]: * You have installed a Java extension in one of the following folders and it is messing up your JVM [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=14040#14040]:
** <tt>~/Library/Java/Extensions/</tt> ** <tt>~/Library/Java/Extensions/</tt>
** <tt>/Library/Java/Extensions/</tt> ** <tt>/Library/Java/Extensions/</tt>
-** <tt>/System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/Home/lib/ext/</tt>+** <tt>/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home/lib/ext/</tt>
-*: Remove the offending extension and try launching NeoOffice again ('''N.B.''': NeoOffice tries to prevent extensions in the first two directories from loading, but the last one also contains key files for the JVM and its contents cannot be forced not to load).+** <tt>/System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home/lib/ext/</tt>
-* Corrupted user preference files+<!--** <tt>/System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/Home/lib/ext/</tt>-->
-** (Force-)Quit NeoOffice, move your NeoOffice preferences folder aside, and restart (don't let NeoOffice 2.x (re-)import your NeoOffice 1.x preferences)+*: Remove the offending extension and try launching NeoOffice again ('''N.B.''': NeoOffice tries to prevent extensions in the first two directories from loading, but the last two also contain key files for the JVM and its contents cannot be forced not to load).
-*** '''NeoOffice 2.x:''' <tt>~/Library/Preferences/NeoOffice-2.x</tt>+
-*** '''NeoOffice 1.2.x:''' <tt>~/Library/Preferences/NeoOffice-1.x</tt>+
-*** '''NeoOffice/J 1.1:''' <tt>~/Library/NeoOfficeJ-1.1</tt>+
-* 24Uemail scripting addition+
-** This scripting addition has been [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=17565#17565 reported to cause Java problems]; remove it from your user's <tt>~/Library/ScriptingAdditions</tt> folder.+
-==NeoOffice crashes randomly==+====Check for a non-standard Java installation====
-* Haxies (programs that use [http://www.unsanity.com/haxies/ape/ Unsanity's APE])+* Many sites on the Internet recommend non-standard methods (hacks) of changing the default Java version for Mac OS X or provide instructions for installing unsupported Java versions on different versions of Mac OS X. Although these hacks may work fine for simple, command-line Java applications, complex applications and those which use Apple’s Mac-specific UI classes (such as NeoOffice) will usually break.
-*: Not all random crashes are caused by haxies, but we have found a disproportionate correlation between the presence of haxies and strange NeoOffice crashes (this was particularly true of NeoOffice versions prior to 1.2 Alpha, which used Java 1.3.1). Many [http://www.glorifiedtypist.com/2005/11/labor_saving_devices.html other] [http://www.redlien.com/blog/?p=32 Mac developers] have experienced similar issues with their applications when haxies are present. <!-- we should watch out for mach_inject-using apps, too: http://rentzsch.com/mach_inject/mach_Users -->+** Ensure that you have not manually changed the symlinks within <tt>/System/Library/Frameworks/JavaVM.framework/Versions/</tt> (to change the default Java version in Mac OS X, use the {{section|General}} tab of <tt>/Applications/Utilities/Java Preferences.app</tt> instead).
-*: Haxies work by injecting their code into running applications in order to customize the behvior of Mac OS X or an application in a way that neither Apple nor the application developer intended. A haxie may have a bug that causes an application to crash, or it may simply create a condition that the application is not prepared to handle and thereby cause a crash. +** Ensure that you have not installed Java 1.5 from Mac OS X 10.5 on Mac OS X 10.6, as this will cause NeoOffice to crash at startup.<!-- https://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=8345&start=0 -->
-*: Because of the scope of the project and the limited time and resources of the NeoOffice developers, no effort will be made to fix a bug that only occurs when a haxie is present.+
-** Disable any installed haxie(s), or add NeoOffice to the exclusions list for the haxie(s)+
-* Corrupted user preference files+
-** (Force-)Quit NeoOffice, move your NeoOffice preferences folder aside, and restart (don't let NeoOffice 2.x (re-)import your NeoOffice 1.x preferences)+
-*** '''NeoOffice 2.x:''' <tt>~/Library/Preferences/NeoOffice-2.x</tt>+
-*** '''NeoOffice 1.2.x:''' <tt>~/Library/Preferences/NeoOffice-1.x</tt>+
-*** '''NeoOffice/J 1.1:''' <tt>~/Library/NeoOfficeJ-1.1</tt>+
-==Problems with the menus or menu bar==+====Remove 24Uemail scripting addition====
-* Haxies and haxie-like programs+* The 24Uemail scripting addition has been [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=17565#17565 reported to cause Java problems]; remove it from your user's <tt>~/Library/ScriptingAdditions</tt> folder.
-** MenuCracker+
-**: While not an Unsanity APE haxie, this hack for enabling third parties to add items to the Mac OS X menu bar has caused problems, such as the disappearance of NeoOffice's menus from the menu bar, in the past.+
-==Crashing in the font dropdown==+<!--No longer possible
-* This is usually caused by a corrupt font that hangs or crashes Apple's text layout routines (e.g. Vivaldi)+====Use Java 1.4.2 instead of Java 1.5====
-** Check for a corrupt font and disable this font via Font Book+* If you have [[NeoOffice Menu and Keyboard Shortcuts#Using System Preferences to add additional keystrokes|assigned keyboard shortcuts]] to any menu other than the NeoOffice menu that include the {{key|⌥}} ({{key|option}}) key using '''System Preferences''', those keyboard shortcuts will not function if you are using Java 1.5 in NeoOffice. There is a bug in Java 1.5 that prevents the menus from handling the {{key|⌥}} key.
-*** Mac OS X 10.3.x: Use [http://morrisonsoftdesign.com/with_fl/index-7.html FontDoctorâ„¢] (demo mode)+** Use Java 1.4.2 for NeoOffice instead of Java 1.5
-*** Mac OS X 10.4.x: Use Font Book :+*** Choose {{menu|Preferences…}} from the {{menu|NeoOffice}} menu
-**** Select all your fonts in Font Book+*** Select <!- - what style do we use for this listbox? - ->'''Java''' in the '''NeoOffice''' section of the preference tree
-**** In the file menu, select Validate Fonts+*** Select Java 1.4.2 in the {{prefName|Java runtime environments (JRE) already installed:}} box
-**** Select Warnings in the dropdown menu while Font Book operates+** Use a keyboard shortcut that does not require the {{key|⌥}} key
-**** Then check the fonts you would like to delete and click "Delete selected fonts"+-->
 +====Check for corrupted Java Shared Archive====
 +* Java Shared Archive corrupted (would this be detected by the above?)
 +*: Often caused by some 10.3.x update; Apple issued another update to fix it (but other causes, too; Terry had a potential solution for them)
-==Performance==+===Font-Related Troubleshooting===
-''Common causes of slow or lackluster performance''+====Disable corrupt fonts====
-* Background processes+* This is usually caused by a corrupt font that hangs or crashes Apple's text layout routines (e.g. Vivaldi, DejaVu Sans Extra Light); check for a corrupt font and disable this font via Font Book
-*: Constantly-running background processes can degrade the performance of NeoOffice+** Mac OS X 10.3.x: Use [http://morrisonsoftdesign.com/with_fl/index-7.html FontDoctorâ„¢] (demo mode)
-** Seti@Home+** Mac OS X 10.4.x: Use '''Font Book''':
-** Folding@Home+*** Select all your fonts in '''Font Book'''
-** DNET client (http://www.distributed.net/)+*** In the {{menu|File}} menu, select {{menu|Validate Fonts}}
-** others?+*** Select {{menu|Warnings}} in the drop-down menu while '''Font Book''' operates
-* Less than 512 MB of RAM+*** Then check the fonts you would like to delete and click {{button|Delete selected fonts}} <!-- I'm guessing this is a button -->
-*: While NeoOffice will run on a Mac with 512 MB of RAM, it will run (and launch) more slowly, particularly if you have other applications also running (Mac OS X really runs best with 512 MB or more of RAM). Luckily, RAM is cheap; adding RAM is the most cost-efficient way to speed up your Mac. See [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=2201 this thread] for some real-life stories.+** Mac OS X 10.5.x and up: Use '''Font Book''':
-* Large number of fonts installed (see [[NeoOffice_Installation_Issues#Why_does_NeoOffice_1.2.x_.E2.80.9Chang.E2.80.9D_part-way_through_startup.3F|this section of the Installation Issues]] article)+*** Select all your fonts in '''Font Book'''
-* OpenOffice.org 2.0+*** In the {{menu|File}} menu, select {{menu|Validate Fonts}}
-*: OpenOffice.org 2.0 by default creates converted copies of all of your installed Mac fonts. Because these fonts are stored inside an application bundle in OpenOffice.org 2.0 (as opposed to simply being in a normal folder in OpenOffice.org 1.1.2), all of the duplicate fonts are loaded by the Apple Type Server (ATS) process and made available to Mac OS X apps. These duplicate fonts seriously degrade the performance of NeoOffice, may cause fonts to display incorrectly, and may even cause crashes.+*** Select {{menu|Warnings}} in the drop-down menu when '''Font Book''' has completed its scan
-** Do not use the standard OpenOffice.org 2.0 .app package; [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=1987 use Start OpenOffice.org and the "stand-alone" OpenOffice.org 2.0] instead (may not fix it?)+*** Then check the fonts you would like to delete and click {{button|Remove Checked}}
-** After using OpenOffice.org 2.0, reboot before using NeoOffice to clear the extra fonts from ATS+***: You should remove all fonts that are flagged with errors, as they will likely lead to crashes; you may be able to resolve some problems listed as warnings, such as duplicate fonts, without needing to delete the fonts. When in doubt, however, removing fonts is the safest choice.
 + 
 +====Check for duplicate fonts====
 +* Use '''Font Book''' to resolve duplicates
 +** Scan the list of fonts for a font that has a bullet (•) to the right of it
 +** Select any fonts with the bullet
 +** Choose {{menu|Resolve Duplicates}} from the {{menu|Edit}} menu
-==A patch does not appear to fix a bug it claims to fix==+====Check the number of fonts installed====
-* Mac OS X "caches" shared libraries and Java classes to improve performance; unfortuantely, it has a very nasty habit of not clearing the cache when updated libraries and classes are installed (like in NeoOffice patches). If a bug doesn't appear to be fixed after applying a patch that should fix the bug, try restarting your Mac, which will clear the old versions of libraries and classes from cache. If the bug is still present after rebooting, you can then reopen the bug in [http://bugzilla.neooffice.org Bugzilla].+* If you have a large number of fonts installed, NeoOffice will be slow to launch or slow to use (see [[NeoOffice_Download_and_Installation_Issues#Why_does_NeoOffice_1.2.x_.E2.80.9Chang.E2.80.9D_part-way_through_startup.3F|this section of the Installation Issues]] article)
-* You applied the patch while NeoOffice was running. Quit and restart NeoOffice.+** Disable fonts you are not using
 +** Turn off {{prefName|Show preview of fonts}} in the preferences
 +*** Choose {{menu|Preferences…}} from the {{menu|NeoOffice}} menu
 +*** Select <!--what style do we use for this listbox? --> '''View''' in the '''NeoOffice''' section of the preference tree
 +*** In the {{section|Font Lists}} section, un-check the box next to {{prefName|Show preview of fonts}}
-==Preferences don't seem to stick==+====Check for OpenOffice.org 2====
-When preferences or settings changes don't seem to apply or don't stick between restarts of NeoOffice, the most likely cause is a some sort of corruption of your profile/preferences. Allowing NeoOffice to create a fresh set should fix the problem.+* OpenOffice.org 2.x by default creates converted copies of all of your installed Mac fonts. Because these fonts are stored inside an application bundle in OpenOffice.org 2.x, all of the duplicate fonts are loaded by the Apple Type Server (ATS) process and made available to Mac OS X applications. This [[#Check the number of fonts installed|doubles the number of installed fonts]], and these duplicate fonts seriously degrade the performance of NeoOffice, may cause fonts to display incorrectly, and may even cause crashes.
-# Move or rename your <tt>~/Library/Preferences/NeoOffice-2.x</tt> folder (<tt>~/Library/Preferences/NeoOffice-1.x</tt> folder for NeoOffice 1.x; in this case, also rename or move aside your <tt>~/Library/NeoOfficeJ-1.1</tt> folder, if you had ever installed NeoOffice/J 1.1)+** Do not use the standard OpenOffice.org 2.x <tt>.app</tt> package; [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=1987 use Start OpenOffice.org and the "stand-alone" OpenOffice.org 2.x] instead (may not fix it?)
-# Launch NeoOffice; it will then create a fresh user profile and settings (for NeoOffice 2.0, be sure not to let the "wizard" import preferences from older versions when starting)+** After using OpenOffice.org 2.x, reboot your Mac before using NeoOffice to clear the extra fonts from ATS
-* In some cases the corruption may only be present in the NeoOffice 2.x or 1.x profile, so allowing NeoOffice to re-import your NeoOffice 1.x or NeoOffice/J 1.1 profile could restore some of your settings without reintroducing the corruption. In that case, simply move or rename only the <tt>~/Library/Preferences/NeoOffice-2.x</tt> (<tt>~/Library/Preferences/NeoOffice-1.x</tt> for NeoOffice 1.x) folder before launching NeoOffice.+
-==Certain keyboard shortcuts do not work==+====Check for the Tahoma font====
-* If you assign a keyboard shortcut in NeoOffice and then it doesn't work, it may be because you've chosen a key combo that Mac OS X is already using either as a general system shortcut, or in its Services.+* If NeoOffice dialogs or windows appear without any text in them ([http://homepage.mac.com/davidmnelson/other/neooffice_blank_windows.png like this]), you have probably experienced a bug caused by the “Tahoma” font included with Office 2004.
-** Look in the '''System Preferences''', Keyboard & Mouse preference pane, Keyboard Shortcuts tab to see if your choice is in use already as a general system shortcut (edit: this option may only be available in Mac OS X 10.4). +** Deactivate or remove the font and windows will appear normally. [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=4069]
-** Then look in e.g. '''TextEdit''''s TextEdit->Services submenu to see if any Services are using your chosen key combo (e.g. cmd-shift-L is often assigned to Search with Google).+
-***If you never use the Services keyboard shortcuts and want to free them up, you can install the very handy [http://www.macupdate.com/info.php/id/11777 Service Manager] (freeware) preference pane to disable individual Services (works in 10.2.x, 10.3.x, 10.4.x). +
-***Users of 10.4.x can also use the [http://www.versiontracker.com/dyn/moreinfo/macosx/28681 ServiceScrubber] application (freeware) to disable Services or reassign their keyboard shortcuts.+
-* If a key combo shows in one of the NeoOffice menus as a shortcut, but doesn't actually work, it may be because although it has been assigned as a Global NeoOffice shortcut, it is being overridden by a shortcut assigned to the particular module you're in (i.e. Writer, Calc etc.)<br>This is the case with cmd-shift-F11, for example; the menubar shows this key combo as calling up the Tools-Options dialogue, but this doesn't work in Writer, as Writer has it assigned to something else arcane to do with templates. Once you delete that module-specific assignment, the shortcut works as displayed in the menubar. +
-{{botlangbarEN|[[De:Problembehebung|Deutsch]]}}+{{botlangbarEN|[[Fr:Guide de dépannage|Français]] [[De:Problembehebung|Deutsch]] [[It:Problemi_Comuni_e_Soluzioni|Italiano]] [[Es:Problemas_comunes_y_soluciones|Español]] [[Nl:Probleemoplossingen|Nederlands]]}}
[[Category:NeoOffice]] [[Category:NeoOffice]]
 +__NOTOC__

Current revision

There are several common sources of problems that cause crashes, sub-optimal performance, or other undesired behavior in NeoOffice. This page collects some common problems and tips to help narrow down the cause of, or in some cases even fix, the problem. (For problems related to installing NeoOffice or NeoOffice patches, see NeoOffice Download and Installation Issues instead.)

To use this page, locate the problem you are experiencing under the "Common Problems" section. Then click on the link or links provided for more information about troubleshooting steps you should try. If you do not find your particular problem under Common Problems, try to find a similar issue, or ask your question in the NeoOffice Support forum on trinity.

Common Problems

For all problems

NeoOffice takes more than a minute to launch

NeoOffice fails to start, or crashes during startup or right after starting

NeoOffice crashes randomly

Problems with the menus or menu bar

Dialogs or windows appear with no text

Crashing in the font drop-down

Text appears as gibberish, or certain characters are incorrect

Error Loading BASIC of Document

Performance

Common causes of slow or lackluster performance

A patch does not appear to fix a bug it claims to fix

Preferences don't seem to stick

Certain keyboard shortcuts do not work

Documents zoom in and out unexpectedly

NeoOffice claims a document is in use by another user after a crash

Solutions and Troubleshooting Steps

Below are a series of solutions and troubleshooting steps that may help resolve common problems you may be experiencing with NeoOffice.

General Troubleshooting

Install NeoOffice Patches

  • Always make sure that you are using the latest NeoOffice patch.
    • NeoOffice is updated regularly through patches, and it is often the case that an issue you are experiencing has been fixed by the latest patch, so be sure you regularly install the patches.

Update Mac OS X

  • Always make sure that you are using the latest iteration of Mac OS X (e.g., 10.3.9 or 10.4.10) and the latest available security and Java updates from Apple (see below for instructions on using Software Update and checking your Java version).
    • While NeoOffice might run on older revisions of Mac OS X 10.3 and 10.4, each patch is only qualified against the latest "point" release at the time of patch release.
    • Similarly, each NeoOffice patch is only qualified against the latest Java update for the appropriate Mac OS X version, and not having the latest Java update will cause bizarre and otherwise unexplained issues.

Disable system hacks

  • Disable or uninstall any installed hack-like software, or add NeoOffice to the exclusions list for any APE haxie(s).
    Hack-like software, such as as InputManagers, SIMBL "plugins", or haxies (programs that use Unsanity's Application Enhancer (APE) framework), works by injecting its code into running applications in order to customize the behavior of Mac OS X or an application in a way that neither Apple nor the application developer intended. One of these programs may have a bug that causes an application to crash, or it may simply create a condition that the application is not prepared to handle and thereby cause a crash.
    Because of the scope of the project and the limited time and resources of the NeoOffice developers, no effort will be made to fix a bug that only occurs when hack-like software is present. Note also that Apple's official support policy is to disregard all reports of problems that occur when APE is present.
    • Some haxies, particularly older ones, can cause NeoOffice to run up to 10 times slower than on machines that do not have the haxie.
    • Not all random crashes are caused by haxies, but we have found a disproportionate correlation between the presence of haxies and strange NeoOffice crashes (this was particularly true of NeoOffice versions prior to 1.2 Alpha, which used Java 1.3.1). Many other Mac developers have experienced similar issues with their applications when haxies are present.
  • To determine if you have hack-like software, and to disable it if you do:
    • Check to see if you have Unsanity APE installed by opening the System Preferences application. If there is an Unsanity APE icon at the bottom of the window, click on it and then disable it (or at least disable it for NeoOffice).
    • In each of the following folders, check for any subfolders named ApplicationEnhancer.bundle or Smart Crash Reports or SIMBL. If you find any, move them out of the folders and reboot your machine:
      /System/Library/SystemConfiguration
      ~/Library/InputManagers
      ~/Library/Application Support
      /Library/InputManagers
      /Library/Application Support
      Remember that ~/ represents your home folder, and that the leading / represents the startup volume (usually Macintosh HD).

Disable MenuCracker

  • MenuCracker, while not an Unsanity APE haxie, is a hack for enabling third parties to add items to the Mac OS X menu bar, and it has caused problems in the past, such as the disappearance of NeoOffice's menus from the menu bar.

Disable trackpad gestures

  • Many users have reported that their MacBook laptop's trackpad is too sensitve and that causes NeoOffice documents to zoom in and out unexpectedly. Since Mac OS X does not provide any way to reduce trackpad sensitivity, starting with NeoOffice 2.2.5 Patch 5 users can stop unexpected zooming by disabling all trackpad magnify and swipe gestures. To disable these trackpad gestures, do the following:
    • Make sure that you have installed the latest NeoOffice patch from the patch download page
    • Launch the /Applications/Utilities/Terminal application, copy the following command into the Terminal window, and press the Return key:
      defaults write org.neooffice.NeoOffice IgnoreTrackpadGestures -bool yes
    • Restart NeoOffice

Remove stuck lock files

If NeoOffice 3.0 crashes while a file is open, sometimes you will be unable to open or edit the file when you reopen it, and NeoOffice will warn you that the file is in use by another user. Beginning in OpenOffice.org 3.0, Sun engineers changed from using native file locking methods used by all applications on a particular operating system to using an invisible file only OpenOffice.org-based applications recognize. When the application crashes, the lock file is not removed and NeoOffice still thinks that the document is in use. To use the document again, you must clear the file.

  • The preferred method of clearing the lock file is reopening and then closing the file by the same user in the same application that the crash occurred in.
    For example, if you had the file open in NeoOffice and NeoOffice crashed, you need to open and close the file in NeoOffice. If a colleague opened the file in OpenOffice.org and it crashed, then your colleague must open and close the file in OpenOffice.org.
  • If it is not feasible for the original person reopen and close the file, or if that method does not work, you can remove the lock file manually:
    1. Launch the /Applications/Utilities/Terminal application, copy the following text, paste it into the Terminal window, and press the spacebar:
      cd
    2. Go to the Finder and drag the folder that contains the read-only file into the Terminal window.
    3. Copy the following text, paste it into the Terminal window, and press the Return key:
      ; rm .~lock.*

You should now be able to access and edit your file again.

Check for corrupted user preference files

  • Corrupted user preference files can cause crashes as well as unexpected behavior when the application is running. When preferences or settings changes don't seem to apply or don't stick between restarts of NeoOffice, the most likely cause is a some sort of corruption of your profile/preferences. Allowing NeoOffice to create a fresh set should fix the problem.
  1. Quit NeoOffice.
  2. Move or rename your ~/Library/Preferences/NeoOffice-3.0 (for 3.0) and ~/Library/Preferences/NeoOffice-2.2 (for 2.2.x) and ~/Library/Preferences/NeoOffice-2.1 (for 2.1) folders.
  3. Launch NeoOffice; it will then create a fresh preferences folder and settings.

Check the Console.log

  • Check the Console.log (via /Applications/Utilities/Console.app) for messages about Java, soffice.bin, or NeoOffice
    • These messages may not make any sense to you, but providing them to NeoOffice community support volunteers may enable the volunteers to identify the source of your problem.

Ensure NeoOffice has the correct permissions

  • If the NeoOffice icon bounces in the Dock for a while and then stops, open the Terminal (/Applications/Utilities/Terminal.app) and type the following and then press return:
    • cd /Applications/NeoOffice.app/Contents/program
    • ls -al soffice.bin
      • The first few characters should contain x three times.
      • If not, type chmod +x soffice.bin, close the Terminal and try to launch NeoOffice again.

Sample NeoOffice in hangs during the startup process

  • If NeoOffice starts but “hangs” during startup (longer than a minute or so on recent Macs), take a sample before force-quitting NeoOffice, one of the developers or community support team might be able to deduce the problem based on log info.

Post the crash log for crashes during startup

  • If NeoOffice crashes, check for a current entry in ~/Library/Logs/CrashReport/soffice.bin.crash.log (the crash log for NeoOffice, and, unfortunately OpenOffice.org)
    These logs will often contain useful information, and even if they are gibberish to you, one of the developers or community support team can often deduce the problem based on log info.
    See this section of the Bugzilla Guide for more information about obtaining the crash log.

Insufficient RAM

  • NeoOffice requires a Mac with at least 512 MB of RAM (memory). While NeoOffice will run on a Mac with 512 MB of RAM, it will run (and launch) more slowly, particularly if you have other applications also running (Mac OS X really runs best with 512 MB or more of RAM).
    • Add more RAM to your Mac
      Luckily, RAM is cheap; adding RAM is the most cost-efficient way to speed up your Mac. See this thread for some real-life stories.
    • Quit other applications before running NeoOffice

Check for background processes

  • Constantly-running background processes can degrade the performance of NeoOffice. If you open the Activity Monitor application, located in the Utilities subfolder of the Applications folder, and click of the CPU or System Memory tabs, you can see which applications are using the most processing power and memory on your machine. Some known culprits include:
    • Seti@Home
    • Folding@Home
    • DNET client (http://www.distributed.net/)
    • Dashboard/widgets
      disable all inessential widgets for best performance
  • If you have any of these applications running, or if Activity Monitor identifies another application using all of your CPU or RAM, try quitting the application(s) before running NeoOffice.

Disable auto spell-checking

  • Turn off auto spell-checking, because the wavy lines are a problem to draw.
    Due to the fact that the OpenOffice.org code sets individual pixels and Cocoa and Java (used for drawing in NeoOffice) don't have any functions for setting individual pixels, NeoOffice must do a much more expensive operation of drawing a 1x1 pixel filled rectangle for each dot in the wavy lines.

Beware of virus scanning software

  • Some virus scanners scan all files when the files are opened, and other virus scanners scan archive files (.sit, .tar, .gz, and .zip and its cousins, like .jar) when those files are accessed; NeoOffice opens and access a large number of files at startup, including a number of .zip and .jar archives.
    • Disable virus scanning of the NeoOffice application (/Applications/NeoOffice.app) and preferences directory (~/Library/Preferences/NeoOffice-3.0 for 3.0 or ~/Library/Preferences/NeoOffice-2.2 for 2.2.1 or ~/Library/Preferences/NeoOffice-2.1 for 2.1), or of just the archive-type files in the NeoOffice application and preferences directory.

Remove macros imported from older NeoOffice versions

  • The error message Error Loading BASIC of document file:///xxxxx/xxxx/xxx General input/output error occurs when some BASIC files (macros) are imported from preferences files of older NeoOffice versions. To get rid of the annoying message, do the following:
    1. In the Tools menu, select the Macros sub-menu, then the Organize Macros sub-menu, and finally the NeoOffice Basic item
    2. In the dialog that appears, press the Organizer button
    3. In the dialog that appears, expand all of the macros in the My Macros item and check the path in each.
    4. For any items that have a path that does not exist, select the item and press the Delete button.

Check for shortcuts used by Mac OS X

  • If you assign a keyboard shortcut in NeoOffice and it doesn't work, it may be because you've chosen a key combination that Mac OS X is already using either as a general system shortcut or is in use by one of the system-wide Services.
    • Look in the System Preferences (Keyboard & Mouse preference pane, Keyboard Shortcuts tab) to see if your choice is in use already as a general system shortcut (this option is only available in Mac OS X 10.4).
    • Open an application that supports many system Services, e.g. TextEdit, and look in the Services sub-menu of the application's Application Name menu to see if any Services are using your chosen key combo (e.g., cmd-shift-L is often assigned to Search with Google).
      If you never use the Services keyboard shortcuts and want to free them up, you can install:
      • The Service Manager preference pane (freeware) to disable individual Services (works in 10.3.x and 10.4.x)
      • The ServiceScrubber application (freeware) to disable Services or reassign their keyboard shortcuts (10.4.x)

Check for shortcut conflicts within NeoOffice

  • If a key combination appears in one of the NeoOffice menus as a shortcut but doesn't actually work, it may be assigned to another command in the current NeoOffice module.
    • If you assign a shortcut as a Global NeoOffice shortcut, it may be overridden by a shortcut assigned to the particular module you're in (e.g., Writer, Calc, etc.)
      This is the case with cmd-shift-F11, for example; the menu shows this key combination as calling up the Preferences window (via the Options item in the Tools menu), but this doesn't work in Writer, as Writer has it assigned to something else arcane to do with templates.
    • Once you delete the module-specific assignment, the shortcut performs the command displayed in the menu.

Reboot to clear cached libraries

  • Mac OS X "caches" shared libraries and Java classes to improve performance; unfortunately, it has a very nasty habit of not clearing the cache when updated libraries and classes are installed (like in NeoOffice patches). If a bug doesn't appear to be fixed after applying a patch that should fix the bug, try restarting your Mac, which will clear the old versions of libraries and classes from cache. If the bug is still present after rebooting, you can then reopen the bug in Bugzilla.

Java-Related Troubleshooting

Check for an up-to-date Java version

  • Check to see if you are running the most up-to-date version of Java 1.5 on Mac OS X 10.4 and 10.5 and Java 1.6 on Mac OS X 10.6
    • Run the Mac OS X Software Update application (from the Apple menu) and install any Mac OS X Updates, Security Updates, and Java Updates that are offered. You may need to run Software Update multiple times in order to completely update your system. Do not ignore or skip installing a Java update for Java 1.5 or Java 1.6 because you only use the other version, as a Java update for one often blocks the appearance in Softwsre Update of updates for the other.
    • Open the Terminal (/Applications/Utilities/Terminal.app) and type the following and then press return:
      java -version
      • Mac OS X 10.4.10 or later:
        java version "1.5.0_13"
        Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_13-b05-241)
        Java HotSpot(TM) Client VM (build 1.5.0_13-121, mixed mode, sharing)
      • Mac OS X 10.5.8 :
        java version "1.5.0_28"
        Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_28-b04-382-9M3326)
        Java HotSpot(TM) Client VM (build 1.5.0_28-157, mixed mode, sharing)
      • Mac OS X 10.6.7 or later:

Check for a corrupt Java installation

  • Check for a corrupt Java installation
    1. Create a plain-text file called Test.java and put the following lines in it, saving afterwards:
      import java.awt.*; public class Test extends Panel { public void paint(Graphics g) { Graphics2D g2 = (Graphics2D)g; g2.setColor(Color.black); Font font = new Font("Arial", Font.PLAIN, 12); g2.setFont(font); g2.drawString("Java works", 100, 100); } public static void main(String[] args) { Frame f = new Frame(); Test p = new Test(); f.add(p); f.setSize(500, 500); f.show(); } }
    2. Open the Terminal (/Applications/Utilities/Terminal.app) and "cd" to the folder that you put the Test.java file in.
    3. Compile the Test.java file using the following terminal command:
      javac Test.java
    4. Run the compiled program with the version of Java you are using with NeoOffice by using the following terminal command:
      • Java 1.5.0 (default on Mac OS X 10.4 and 10.5):
        /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Commands/java -classpath . Test
      • Java 1.6.0 (default on Mac OS X 10.6):
        /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Commands/java -classpath . Test
    5. If a blank window appears when you run the program, then you know that Java is working. [1]

Remove incompatible Java extensions

  • You have installed a Java extension in one of the following folders and it is messing up your JVM [2]:
    • ~/Library/Java/Extensions/
    • /Library/Java/Extensions/
    • /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home/lib/ext/
    • /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home/lib/ext/
    Remove the offending extension and try launching NeoOffice again (N.B.: NeoOffice tries to prevent extensions in the first two directories from loading, but the last two also contain key files for the JVM and its contents cannot be forced not to load).

Check for a non-standard Java installation

  • Many sites on the Internet recommend non-standard methods (hacks) of changing the default Java version for Mac OS X or provide instructions for installing unsupported Java versions on different versions of Mac OS X. Although these hacks may work fine for simple, command-line Java applications, complex applications and those which use Apple’s Mac-specific UI classes (such as NeoOffice) will usually break.
    • Ensure that you have not manually changed the symlinks within /System/Library/Frameworks/JavaVM.framework/Versions/ (to change the default Java version in Mac OS X, use the General tab of /Applications/Utilities/Java Preferences.app instead).
    • Ensure that you have not installed Java 1.5 from Mac OS X 10.5 on Mac OS X 10.6, as this will cause NeoOffice to crash at startup.

Remove 24Uemail scripting addition

Check for corrupted Java Shared Archive

  • Java Shared Archive corrupted (would this be detected by the above?)
    Often caused by some 10.3.x update; Apple issued another update to fix it (but other causes, too; Terry had a potential solution for them)

Font-Related Troubleshooting

Disable corrupt fonts

  • This is usually caused by a corrupt font that hangs or crashes Apple's text layout routines (e.g. Vivaldi, DejaVu Sans Extra Light); check for a corrupt font and disable this font via Font Book
    • Mac OS X 10.3.x: Use FontDoctorâ„¢ (demo mode)
    • Mac OS X 10.4.x: Use Font Book:
      • Select all your fonts in Font Book
      • In the File menu, select Validate Fonts
      • Select Warnings in the drop-down menu while Font Book operates
      • Then check the fonts you would like to delete and click Delete selected fonts
    • Mac OS X 10.5.x and up: Use Font Book:
      • Select all your fonts in Font Book
      • In the File menu, select Validate Fonts
      • Select Warnings in the drop-down menu when Font Book has completed its scan
      • Then check the fonts you would like to delete and click Remove Checked
        You should remove all fonts that are flagged with errors, as they will likely lead to crashes; you may be able to resolve some problems listed as warnings, such as duplicate fonts, without needing to delete the fonts. When in doubt, however, removing fonts is the safest choice.

Check for duplicate fonts

  • Use Font Book to resolve duplicates
    • Scan the list of fonts for a font that has a bullet (•) to the right of it
    • Select any fonts with the bullet
    • Choose Resolve Duplicates from the Edit menu

Check the number of fonts installed

  • If you have a large number of fonts installed, NeoOffice will be slow to launch or slow to use (see this section of the Installation Issues article)
    • Disable fonts you are not using
    • Turn off Show preview of fonts in the preferences
      • Choose Preferences… from the NeoOffice menu
      • Select View in the NeoOffice section of the preference tree
      • In the Font Lists section, un-check the box next to Show preview of fonts

Check for OpenOffice.org 2

  • OpenOffice.org 2.x by default creates converted copies of all of your installed Mac fonts. Because these fonts are stored inside an application bundle in OpenOffice.org 2.x, all of the duplicate fonts are loaded by the Apple Type Server (ATS) process and made available to Mac OS X applications. This doubles the number of installed fonts, and these duplicate fonts seriously degrade the performance of NeoOffice, may cause fonts to display incorrectly, and may even cause crashes.

Check for the Tahoma font

  • If NeoOffice dialogs or windows appear without any text in them (like this), you have probably experienced a bug caused by the “Tahoma” font included with Office 2004.
    • Deactivate or remove the font and windows will appear normally. [3]


This article in other languages: Français Deutsch Italiano Español Nederlands
Personal tools