Combining permissions

You might grant one FilePermission that Modified: db/derby/docs/trunk/src/devguide/tdevdvlp20349.dita URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevdvlp20349.dita?rev=1533453&r1=1533452&r2=1533453&view=diff ============================================================================== --- db/derby/docs/trunk/src/devguide/tdevdvlp20349.dita (original) +++ db/derby/docs/trunk/src/devguide/tdevdvlp20349.dita Fri Oct 18 13:52:51 2013 @@ -41,6 +41,10 @@ Shutting down instance a816c00e-0139-bfe database directory C:\sampledb with class loader sun.misc.Launcher$AppClassLoader@9931f5 ---------------------------------------------------------------- +

If you are running with a security manager on JDK 8 or higher, you must grant + permission to +deregister the embedded driver in order to fully shut down the system. See + for details.

Typically, an application using an embedded engine shuts down just before Modified: db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita?rev=1533453&r1=1533452&r2=1533453&view=diff ============================================================================== --- db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita (original) +++ db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita Fri Oct 18 13:52:51 2013 @@ -34,6 +34,10 @@ down Derbyusing database conn jdbc:derby:;shutdown=true

A successful shutdown always results in an SQLException to indicate that has shut down and that there is no other exception.

If you are running with a security manager on JDK 8 or higher, you must grant + permission to +deregister the embedded driver in order to fully shut down the system. See + for details.

If you have enabled user authentication at the system level, you will need to specify credentials (that is, username and password) in order to shut down a system, and the Modified: db/derby/docs/trunk/src/ref/rrefattrib16471.dita URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattrib16471.dita?rev=1533453&r1=1533452&r2=1533453&view=diff ============================================================================== --- db/derby/docs/trunk/src/ref/rrefattrib16471.dita (original) +++ db/derby/docs/trunk/src/ref/rrefattrib16471.dita Fri Oct 18 13:52:51 2013 @@ -43,8 +43,9 @@ if and only if you do not specify a d shutting down a single database, it lets perform a final checkpoint on the database.

When you are shutting down a system, it lets perform a -final checkpoint on all system databases, deregister the JDBC driver, and -shut down within the JVM before the JVM exits. A successful shutdown always +final checkpoint on all system databases, deregister the JDBC driver (if +permitted; see deregister=false), +and shut down within the JVM before the JVM exits. A successful shutdown always results in an SQLException indicating that has shut down and that there is no connection. Once is shut down, you can restart it by reloading the driver. For details on restarting DriverManager with a shutdown=true attribute raises an exception.

Combining with other attributes

This attribute may be combined with the -deregister=true +deregister=false attribute.

When you shut down a database, if authentication is turned on, you must specify this attribute in conjunction with the JDBC driver from the DriverManager after a shutdown, so that the classes can be garbage-collected.

+
If you are running with a security manager on JDK 8 or higher, you must grant +the following permission to derby.jar to allow the JDBC driver to be +deregistered:
+permission java.sql.SQLPermission "deregisterDriver"; +
See "Granting permissions to +" in the + for details. If you do not grant +this permission when using a security manager, an error message and stack trace +will appear in derby.log on shutdown, and the embedded JDBC driver +will remain registered.
+
If you are running with a security manager on JDK 7 or earlier, you do not +need to set this permission.

You initially register the embedded driver by doing one of the following:

Call the method