Derby Server and Administration Guide Version 10.8 Derby Document build: November 2, 2012, 12:31:32 PM (PDT) Version 10.8 Derby Server and Administration Guide Contents Copyright................................................................................................................................4 License................................................................................................................................... 5 About this guide....................................................................................................................9 Purpose of this guide................................................................................................9 Audience..................................................................................................................... 9 How this guide is organized.....................................................................................9 Part one: Derby Server Guide........................................................................................... 11 Derby in a multi-user environment........................................................................ 11 Derby in a server framework...............................................................................11 About this guide and the Network Server documentation...................................14 Using the Network Server with preexisting Derby applications..........................14 The Network Server and JVMs...........................................................................14 Installing required jar files and adding them to the classpath............................. 14 Starting the Network Server................................................................................15 Shutting down the Network Server..................................................................... 17 Obtaining system information..............................................................................18 Accessing the Network Server by using the network client driver.......................20 Accessing the Network Server by using a DataSource object............................ 27 XA and the Network Server................................................................................ 29 Using the Derby tools with the Network Server.................................................. 29 Differences between running Derby in embedded mode and using the Network Server.................................................................................................................. 30 Setting port numbers...........................................................................................33 Managing the Derby Network Server.....................................................................33 Overview.............................................................................................................. 34 Setting Network Server properties...................................................................... 34 Verifying Startup.................................................................................................. 40 Managing the Derby Network Server remotely by using the servlet interface.................................................................................................................... 40 Start-up page.......................................................................................................41 Running page...................................................................................................... 41 Trace session page.............................................................................................42 Trace directory page........................................................................................... 42 Set Network Server parameters .........................................................................42 Derby Network Server advanced topics................................................................42 Network Server security...................................................................................... 42 Running the Network Server under the security manager.................................. 43 Running the Network Server with User Authentication....................................... 47 Network encryption and authentication with SSL/TLS........................................ 48 Configuring the Network Server to handle connections...................................... 51 Controlling logging by using the log file.............................................................. 52 Controlling tracing by using the trace facility...................................................... 52 Derby Network Server sample programs.............................................................. 53 The NsSample sample program......................................................................... 53 Network Server sample programs for embedded and client connections........... 56 Part two: Derby Administration Guide..............................................................................59 Maintaining database integrity............................................................................... 59 Checking database consistency............................................................................ 59 The SYSCS_CHECK_TABLE function................................................................59 Sample SYSCS_CHECK_TABLE error messages............................................. 60 i Version 10.8 Derby Server and Administration Guide Sample SYSCS_CHECK_TABLE queries.......................................................... 60 Backing up and restoring databases.....................................................................61 Backing up a database....................................................................................... 61 Restoring a database from a backup copy......................................................... 65 Creating a database from a backup copy...........................................................65 Roll-forward recovery.......................................................................................... 66 Importing and exporting data.................................................................................68 Methods for running the import and export procedures...................................... 68 Bulk import and export requirements and considerations................................... 68 Bulk import and export of large objects.............................................................. 69 File format for input and output...........................................................................70 Importing data using the built-in procedures.......................................................71 Exporting data using the built-in procedures.......................................................75 Examples of bulk import and export................................................................... 77 Running import and export procedures from JDBC............................................ 79 How the import and export procedures process NULL values............................79 CODESET values for import and export procedures.......................................... 79 Replicating databases............................................................................................. 79 Starting and running replication.......................................................................... 80 Stopping replication............................................................................................. 81 Forcing a failover.................................................................................................82 Replication and security...................................................................................... 82 Replication failure handling................................................................................. 83 Logging on a separate device................................................................................84 Using the logDevice=logDirectoryPath attribute..................................................84 Example of creating a log in a non-default location............................................84 Example of moving a log manually.....................................................................85 Issues for logging in a non-default location........................................................ 85 Obtaining locking information................................................................................85 Monitoring deadlocks...........................................................................................85 Reclaiming unused space.......................................................................................86 Trademarks.......................................................................................................................... 88 ii Derby Server and Administration Guide Apache Software FoundationDerby Server and Administration GuideApache Derby 3 Derby Server and Administration Guide Copyright Copyright 2004-2012 The Apache Software Foundation Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0. Related information License 4 Derby Server and Administration Guide License The Apache License, Version 2.0 Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS