Forgot to add that Yes, the documentation note should be fixed to mention that if authentication has been enabled, then you do need to authenticate in order to shutdown a Derby system.


On Mon, Sep 14, 2009 at 3:52 PM, Francois Orsini <> wrote:
You have to set it _if_ you have defined Derby's BUILT-IN user authentication at the System level (e.g. setting username / password in file) versus having defined users at the database level (e.g. database-level properties) - note that both types of users are NOT exclusive, meaning you can have users defined at the system and database levels.

"Setting the property as a system-wide property creates system-wide users. Setting the property as a database-wide property creates users for a single database only."

See database-level properties versus system-level ones:

Hope this helps


On Mon, Sep 14, 2009 at 3:20 PM, dev@xx <> wrote:
The documentation says : << Applications in an embedded environment shut down the Derby system by specifying the shutdown=true attribute in the connection URL. To shut down the system, you do not specify a database name, and **you must not specify any other attribute**.>>
Even if authentication is enabled it doesn't seams that you have to set the user/password attributes, only database shutdown needs these attributes.
In fact I HAVE TO set the user/password attributes to shutdown the system or I have a "Connection authentication failure occurred" exception.
So my question is : is-it an error in the documentation or a bug or a misunderstanding ?
JY Linet