Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Broken Pipe

A current app I'm working freezes up for about a minute when calling editingContext.saveChanges. The following message is added to the system output:


<WorkerThread3> <WOWorkerThread id=3 socket=Socket[addr=

Exception while sending response: Broken pipe

The odd thing is that no exception is actually being thrown and the changes are saved to the database. Any clues out there about what this message means?

Chuck Hill

This message means that the woadaptor did not receive a response from your application within the alloted amount of time. At this point, the woapdator hangs up on your application assuming that it is dead or overly busy. If you have multiple instances running, the woadaptor will then forward the request to another instance. For component actions this will produce a session expired or can't restore page error message.


Note: If this message happens in other contexts (i.e. not when a request takes a long time to process) it might just mean that the user hit stop in their browser or clicked another link.

Where's my stderr!?

Wotaskd launches new WOA instances using a script called that is located in /System/Library/WebObjects/JavaApplications/wotaskd.woa/Contents/Resources/ on OS X. For some reason, this script was written to throw away stderr. This means that if you ever want to get a thread stack dump, you're out of luck. Fortunately this is an easy fix. If you edit, the stock version looks like:



 $@ 1>/dev/null 2>&1 &

Notice that stream 1 goes to /dev/null, and stream 2 writes to stream 1. Boo. Change it to:



 $@ 1>>/var/log/webobjects.err 2>&1 &

The one problem now is that typically WebObjects apps run as appserver user, which means they won't be able to write to this file. To fix this, you can 'touch /var/log/webobjects.err' as root, and then chown the blank file to whatever user your WebObjects apps run as.

Can't connect to window server - not enough permissions

Ah yes, the joys of AWT. If you touch any AWT class (event the ones that don't make sense, like Dimension, or Rectangle), an AWT Toolkit will be created (in a static block) and AWT will attempt to connect to the window server. Of course when you ran in development mode, you had access to the window server and everything was peachy. As soon as you tried to deploy as the appserver user, all hell broke loose. You have a couple of options for fixing this one:

  • Just stop using them. This is the most sure fire way to not get hit by this problem. Don't use AWT classes when you don't need to. Obviously this is often easier said than done.
  • Add -Djava.awt.headless=true to your VM launch parameters. This tells AWT to use headless mode. If you are using older versions of Apple's JVM, this may still cause issues (weird debug statements requesting for you to hit a key on the console).
  • PJA Toolkit. This is actually kind of a cool library. It's a pure java implementation of an AWT toolkit. On a normal system, your AWT implementation is JNI (to talk to your native window system). PJA provides pura java implementations of all of the capabilities a normal AWT toolkit would attempt to perform. Obviously it doesn't actually use the window server, rather it's working akin to a VNC server with a virtual frame buffer.
  • Run as root. This is not generally recommended, but you can modify your /System/Library/StartupItems/WebObjects/WebObjects script to run WO as root instead of appserver user. You'll find the instructions on doing so inside of that script.

Java Monitor Issues

For those who have problem with the monitor on Mac OS X please check the following parameters:

  • Check that the machine is properly identified in the DNS including the reverse lookup.
  • Verify that when you added the machine in the monitor you included the fully qualifier name i.e. "" and not only "machine" using the shorter version may appear to work but it does not (this is documented by Apple).
  • Check the adaptor configuration (/System/Library/WebObjects/Adaptors/Apache/apache.conf) and in particular the instance discovery method: this needs to be in accordance with the command line launch of wotaskd (see the script in /System/Library/StartupItems/). You may need to modify the script by hand.
  • When everything is setup properly reboot. It should work.

WOtaskd Didn't Start

In older versions of OS X server, WOtaskd and JavaMonitor were launched using the StartupItems system. In more recent versions of OS X server and WebObjects, Apple uses its new launchd framework instead. If you install WebObjects with developer tools, you typically only end up with the Startupitem scripts, so you should follow those instructions.

WOtaskd/WOMonitor LaunchDaemon

For an overview of launchd, you can read Apple's documentation.


wotaskd and womonitor should now both be running. You can test monitor by going to http://localhost:56789Image Removed.

If this does not work, check for file system permissions on /Library/WebObjects/Configuration, which should be appserver:appserverusr or at least they should have write permission to this directory.

Running this following command in a terminal window will tell you exactly why wotaskd is not launching...

Code Block

sudo -u appserver /System/Library/WebObjects/JavaApplications/wotaskd.woa/Contents/Resources/ -appPath /System/ Library/WebObjects/JavaApplications/wotaskd.woa/wotaskd

WOtaskd/WOMonitor StartupItems

On developer installs and older Mac OS X Server installs, WebObjects is launched using the old StartupItems system. By default, wotaskd and womonitor are disabled. Fortunately, enabling them is easy:


Note: Do not follow these instructions on a MacOS X 10.4.* Server machine with WO 5.3.*. There, the process is started as LaunchDeamon (described above). If you enable the Startup Item, the system tries to start wotaskd twice which leads to nothing working at all.

Dealing with Deadlocks/Application Hanging

There are several techniques for dealing with deadlocks and application hangs.


In JDK 1.4, you will be able to see the list of object locks that each stack trace is holding. You can find deadlocks by looking for multiple threads that contain two or more overlapping locks. In JDK 1.5, the VM detects deadlock situations and will identify them in the thread stack dumps.Category:WebObjects