You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by jt...@apache.org on 2005/05/26 04:59:29 UTC
svn commit: r178570 [6/6] - in /incubator/derby/site/trunk: build/site/
build/site/binaries/ build/site/images/ build/site/integrate/
build/site/integrate/plugin_help/ build/site/integrate/plugin_help/images/
build/site/releases/ src/documentation/content/binaries/
src/documentation/content/xdocs/ src/documentation/content/xdocs/images/
src/documentation/content/xdocs/integrate/
src/documentation/content/xdocs/integrate/plugin_help/
src/documentation/content/xdocs/integrate/plugin_help/images/
Added: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_server.html
URL: http://svn.apache.org/viewcvs/incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_server.html?rev=178570&view=auto
==============================================================================
--- incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_server.html (added)
+++ incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_server.html Wed May 25 19:59:25 2005
@@ -0,0 +1,80 @@
+<html>
+<head>
+<title>Starting the Derby Network Server</title>
+</head>
+<body>
+<h1>Starting the Derby Network Server</h1>
+<p>
+The Derby Network Server allows multiple applications running in different
+Java Virtual Machines to access a single Derby database.
+Once the Network Server is started client applications from within Eclipse,
+such as <b>ij</b> or other Java applications, can access a Derby database.
+Additionally, the Network Server allows for client applications outside
+of Eclipse on the localhost, or even on remote hosts to access the same
+database.
+</p>
+<p>
+<h2>To start the Derby Network Server</h2>
+</p>
+<p>
+<ul>
+<li>
+The Derby nature needs to be added to the project prior to starting the Network Server.<br/><br/>
+</li>
+<li>
+With the Java project selected, bring up the context menu and select
+the menu item, <b>Apache Derby, Start Derby Network Server</b>.
+</li>
+</ul>
+<img src="images/start_server.GIF" alt="Start Derby Network Server" width="716" height="686"></img>
+<ul>
+<li>
+The pop-up box will appear which states the Apache Derby Network Server is
+attempting to be started.
+</li>
+<li>
+If the network server startup is successful the <b>Console</b> view will
+display <b>Server is ready to accept connections on port xxxx.</b>
+ For each project that has a running Network Server associated with it
+a green arrow appears next to the project name.
+</li>
+</ul>
+<img src="images/start_server_console.gif" alt="Network Server started" width="746" height="577"></img>
+<ul>
+<li>
+If other items that use the console as a display hide the Network Server
+console use the <b>Display Selected Console</b> drop down icon to the right
+of the console menu bar to make the Network Server console visible.
+</li>
+</ul>
+</p>
+
+<h2>Derby Network Server Host value</h2>
+<p>
+By starting the Derby Network Server using the default values the
+server runs on the localhost, which is the host running Eclipse,
+on port 1527. To change the host name or the port number where the Derby
+Network Server is running see <a href="properties.html"> Setting Derby properties for a project</a>.
+</p>
+<p>
+The value used for the Network Server host name impacts the ability of
+remote hosts to connect to the Network Server. If the Network Server Host value
+in the Project Properties is set to <b>localhost</b>, only clients running
+on the host where Eclipse is running can connect to the network server.
+If an ip address or hostname (other than the name 'localhost') is used,
+client applications running on other hosts can connect to the Derby Network
+Server. For additional information about starting the Derby Network Server
+see the Derby Server and Administration Guide. The section
+called <b>Starting the Network Server</b> explains the effect of setting
+the value for the hostname differently.
+</p>
+<p>
+If connections from other hosts will be allowed, it is recommended to run
+under the Java security manager and enable user authentication prior to
+starting the Derby Network Server.
+</p>
+<p>
+</p>
+
+</body>
+</html>
Propchange: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_server.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_toc.html
URL: http://svn.apache.org/viewcvs/incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_toc.html?rev=178570&view=auto
==============================================================================
--- incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_toc.html (added)
+++ incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_toc.html Wed May 25 19:59:25 2005
@@ -0,0 +1,72 @@
+<html>
+<head>
+<title>Getting Started with the Derby plug-ins for Eclipse</title>
+</head>
+<body>
+<h1>Getting Started with the Derby plug-ins for Eclipse</h1>
+<p>
+The Apache Derby plug-ins for Eclipse provide a seamless integration between
+Eclipse and Apache Derby. It enables the use of the Derby database JAR files
+as an installable component to Eclipse. Additionally the ij SQL scripting tool
+and the Apache Derby Network Server can be run from the Eclipse console.
+</p>
+<p>
+If you are new to Eclipse or Derby, the steps below will get you started
+using both! At the very least, follow the first four steps to become familiar
+with Eclipse and Derby.
+<ul>
+<li>
+Create an <a href="java_project.html">Eclipse Java project.</a>
+<br/>
+<br/>
+</li>
+<li>
+Add the <a href="nature.html">Apache Derby nature</a> to your Java project.
+<br/>
+<br/>
+</li>
+<li>
+Start the <a href="start_server.html">Derby Network Server.</a>
+<br/>
+<br/>
+</li>
+<li>
+Launch <a href="ij.html"><b>ij</b></a> to create and connect to a
+Derby database. <b>ij</b> is the Derby tool you can use to issue SQL commands
+against the database.
+<br/>
+<br/>
+</li>
+<li>
+Run entire <a href="ij2.html">SQL scripts</a> against the database using ij.
+<br/>
+<br/>
+</li>
+<li>
+Create a <a href="derby_app.html">Java application</a> which accesses a Derby database.
+<br/>
+<br/>
+</li>
+<li>
+Shutdown the <a href="stop_server.html">Derby Network Server.</a>
+<br/>
+<br/>
+</li>
+<li>
+Obtain Java and Derby information to help in troubleshooting problems using
+<a href="sysinfo.html">sysinfo.</a>
+<br/>
+<br/>
+</li>
+<li>
+Learn more about Apache Derby from the online <a href="resources.html">documentation.</a>
+<br/>
+<br/>
+</li>
+</ul>
+</p>
+
+<p>
+</p>
+</body>
+</html>
Propchange: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/start_toc.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/stop_server.html
URL: http://svn.apache.org/viewcvs/incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/stop_server.html?rev=178570&view=auto
==============================================================================
--- incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/stop_server.html (added)
+++ incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/stop_server.html Wed May 25 19:59:25 2005
@@ -0,0 +1,45 @@
+<html>
+<head>
+<title>Stopping the Derby Network Server</title>
+</head>
+<body>
+<h1>Stopping the Derby Network Server</h1>
+<p>
+The Derby Network Server allows multiple applications running in different
+Java Virtual Machines to access a single Derby database.
+</p>
+<p>
+<h2>To stop the Derby Network Server</h2>
+</p>
+<ul>
+<li>
+Select the Java project, bring up the context menu and select
+the menu item, <b>Apache Derby, Stop Derby Network Server</b>.
+</li>
+</ul>
+<img src="images/stop_server.GIF" alt="Stop Derby Network Server" width="784" height="676"></img>
+<ul>
+<li>
+The pop-up box will appear stating the Apache Derby Network Server is
+attempting to be stopped.
+</li>
+</ul>
+<ul>
+<li>
+If the network server shutdown is successful the <b>Console</b> view will
+say <b>Shutdown successful.</b>
+</li>
+</ul>
+<img src="images/shutdown_success.gif" alt="Apache Derby Network Server stopped" width="773" height="645"></img>
+<ul>
+<li>
+When the Network Server associated with a particular project is shutdown
+the green arrow designating a running server which appeared next to the project
+name, is no longer visible.
+</li>
+</ul>
+
+<p>
+</p>
+</body>
+</html>
Propchange: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/stop_server.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/sysinfo.html
URL: http://svn.apache.org/viewcvs/incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/sysinfo.html?rev=178570&view=auto
==============================================================================
--- incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/sysinfo.html (added)
+++ incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/sysinfo.html Wed May 25 19:59:25 2005
@@ -0,0 +1,46 @@
+<html>
+<head>
+<title>Running sysinfo for environment information</title>
+</head>
+<body>
+<h1>Running sysinfo for environment information</h1>
+<p>
+<b>sysinfo</b> provides information about the Derby system. This tool is
+useful in determing the current Java and Derby environments.
+</p>
+<h2>To launch <b>sysinfo</b></h2>
+<ul>
+<li>
+Select the project and bring up the context menu. Select the menu item, <b>sysinfo (Derby System Information)</b>.
+</li>
+</ul>
+<img src="images/sysinfo_start.GIF" alt="sysinfo (Derby System Information)" width="918" height="688"></img>
+<ul>
+<li>
+The <b>Console</b> view will show the output from running the <b>sysinfo</b>
+command. The output from <b>sysinfo</b> is divided into three sections:
+<ul>
+<li>
+Java Information
+</li>
+<li>
+Derby Information
+</li>
+<li>
+Locale Information (if present) <br/><br/>
+</li>
+</ul>
+<li>
+Additional info about using <b>sysinfo</b> can be found in the Derby <i>Tools & Utility Guide</i>.
+</li>
+</ul>
+</p>
+<p>
+Sample output from running <b>sysinfo</b> is shown below.
+</p>
+
+<img src="images/sysinfo_output.GIF" alt="sysinfo output" width="924" height="695"></img>
+<p>
+</p>
+</body>
+</html>
Propchange: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_help/sysinfo.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_howto.xml
URL: http://svn.apache.org/viewcvs/incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_howto.xml?rev=178570&view=auto
==============================================================================
--- incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_howto.xml (added)
+++ incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_howto.xml Wed May 25 19:59:25 2005
@@ -0,0 +1,414 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+ <header>
+ <title>Using the 10.1 Core and 1.0 UI Derby plug-ins</title>
+ </header>
+ <body>
+
+<p>
+This paper lists the components and functionality of the Derby plug-ins
+for Eclipse. Also, installation and how to use the plug-ins is discussed.
+It's helpful to have some knowledge of Eclipse prior to reading this paper,
+however, the accompanying help for the plugin is sufficient to allow new
+Eclipse users to succeed in creating a simple application in Eclipse
+using the Derby plug-ins.
+</p>
+
+<section>
+<title>Architecture of the plug-ins</title>
+
+<p>
+Presently the Derby Core plug-in is the only plug-in available for download
+in binary form. The other two plug-ins are currently available in
+source form only. Once the UI plug-in and the Help plug-in are placed in the
+<a href="http://incubator.apache.org/derby/derby_downloads.html#Snapshot+Jars">
+Snapshot Jars</a> section of the development trunk, these two plugins will
+be available as zip files as well.
+</p>
+<p>
+Listed below are the contents of the three plug-ins:
+</p>
+
+<table>
+<tr>
+<th>Zip file name</th>
+<th>Plugin name</th>
+<th>Contents</th>
+</tr>
+<tr>
+<td>derby_core_plugin_10.1.0.zip</td>
+<td>Derby Core Plug-in, org.apache.derby.core_10.1.0</td>
+<td>derby.jar, derbytools.jar, derbynet.jar, derbyclient.jar, plugin.xml</td>
+</tr>
+<tr>
+<td>Currently available as source only in the 10.1 development trunk: <br/><br/>
+trunk/eclipse/plugins/org.apache.derby.ui</td>
+<td>Derby UI Plug-in, org.apache.derby.ui_1.0.0</td>
+<td>ui.jar, plugin.xml</td>
+</tr>
+<tr>
+<td>Currently available as source only in the 10.1 development trunk: <br/><br/>
+trunk/eclipse/plugins/org.apache.derby.plugin.doc</td>
+<td>Derby Plug-in Documentation, org.apache.derby.plugin.doc_1.0.0</td>
+<td>html and image files contained in the topics directory,
+plugin.xml, toc.xml</td>
+</tr>
+</table>
+</section>
+
+<section>
+<title>Functionality</title>
+<p>
+After installing the Derby core plug-in the following jar files are present
+in the Eclipse plug-ins subdirectory of org.apache.derby.core_10.1.x:
+</p>
+
+<ul>
+<li>
+derby.jar, derbytools.jar, derbynet.jar, derbyclient.jar
+</li>
+</ul>
+
+<p>
+The functionality of the core plug-in makes available these jar files,
+and thus the Derby database to Eclipse users, however no menu items
+or UI additions to the Eclipse environment are available.
+</p>
+
+<p>
+After installing the Derby UI plug-in, UI components such as
+menu items and pop-up windows are available from any Eclipse
+project which has the Apache Derby nature added to it. After installing
+the Help plug-in, the Derby plug-in Users Guide is installed in the
+Eclipse help system.
+The UI plug-in has the core plug-in as one of its dependencies. In
+other words, this plug-in will not work, and no menu items will appear
+if the core plug-in is not already installed.
+The specific functionality added to the Eclipse environment after the
+UI plug-in is installed is:
+</p>
+
+<ul>
+<li>
+Add or remove the Derby nature from any Eclipse project
+</li>
+<li>
+Ability to configure the Derby network server for each project,
+including the port number and derby.system.home
+</li>
+<li>
+All Derby jar files are added to the Java Build Path of an Eclipse project
+</li>
+<li>
+Run ij and entire SQL scripts from within Eclipse
+</li>
+<li>
+Start and stop the network server from within Eclipse and track them for
+each project
+</li>
+<li>
+Run sysinfo from within Eclipse
+</li>
+</ul>
+</section>
+
+<section>
+<title>Installing the plug-ins</title>
+
+<p>
+Prior to installing the plug-ins Eclipse 3.x must be installed. The current
+version of the plug-ins has been tested with Eclipse 3.01 and Eclipse 3.1M5.
+The <a href="http://www.eclipse.org/downloads/index.php">downloads page</a> at
+eclipse.org has the Eclipse 3.x SDK downloads.
+</p>
+
+<p>
+The binary version of the core plug-in (the source is not included) is
+available for download at <a href="../derby_downloads.html">downloads.html</a>.
+Download the derby_core_plugin_10.1.0.zip. To obtain the source for the UI and
+documentation plug-ins in the form of an Eclipse PDE (Plug-in Development Environment) project first check out the source at trunk/plugins/eclipse/org.apache.derby.ui for the UI plugin, and trunk/plugins/eclipse/org.apache.derby.plugin.doc for the documentation plugin. See the document <a href="Readme.html">Readme.txt</a> for complete instructions on how to build these two plugins from the source.
+</p>
+
+<p>
+Note that both the Core and the UI plug-in need to be installed
+if any UI functionality is required, such as adding the Apache Derby
+nature, running the Derby network server, etc. is desired.
+</p>
+
+<p>
+Unzip the core plugin files into the Eclipse home directory.
+
+The location where you installed Eclipse is referred to as ECLIPSE_HOME.
+For instance, this might be /eclipse in a Linux or Unix envrironment
+or C:/eclipse on Windows. Unzip the files to the ECLIPSE_HOME directory.
+Copy the entire directory from the ui and help file plugin projects into
+the plugins directory. For instance you should have a a folder called
+org.apache.derby.ui_1.0.0 and org.apache.derby.plugin.doc_1.0.0 after
+downloading and creating the plug-in project in Eclipse.
+Three new subdirectories should now exist under the ECLIPSE_HOME/plugins
+directory:
+</p>
+
+<ul>
+<li>org.apache.derby.core_10.1.0</li>
+<li>org.apache.derby.ui_1.0.0</li>
+<li>org.apache.derby.plugin.doc_1.0.0</li>
+</ul>
+
+</section>
+
+<section>
+<title>Incompatibilities with earlier version of the plug-ins</title>
+
+<p>
+To understand the compatibility with previous versions of the plug-in
+a definition of the meaning of the words 'Core' and 'UI',
+as well as 'Old' and 'New' are required. The chart below explains this.
+</p>
+<table>
+<tr>
+<th>Short Name</th>
+<th>Formal Name</th>
+<th>Contents</th>
+</tr>
+<tr>
+<td><strong>10.0 Core</strong></td>
+<td>Derby Core plug-in, V10.0.x</td>
+<td>derby.jar, derbynet.jar, derbytools.jar</td>
+</tr>
+<tr>
+<td><strong>10.1 Core</strong></td>
+<td>Derby Core plug-in, V10.1.x</td>
+<td>derby.jar, derbynet.jar, derbytools.jar, <strong>derbyclient.jar</strong></td>
+</tr>
+<tr>
+<td><strong>Old UI</strong></td>
+<td>IBM Integration plug-in for Derby, V1.0</td>
+<td>ui.jar, <strong>db2jcc.jar, db2jcc_license_c.jar</strong>, html help files</td>
+</tr>
+<tr>
+<td><strong>New UI</strong></td>
+<td>Derby UI plug-in, V1.0</td>
+<td>ui.jar, html help files</td>
+</tr>
+</table>
+
+<p>
+The '10.0 Core' plugin, versions prior to 10.1.x, do not have support for
+the new derbyclient. This means that the '10.0 Core' plug-in will not work
+with the 'New UI' plug-in. Below is a matrix which explains the
+compatibility of the plug-ins in detail.
+</p>
+
+<p>
+The table illustrates acceptable combinations of the '10.0' and '10.1' Core and
+UI plug-ins as defined above. The use of the word 'only' in the column headings
+means only one of the '10.0' or '10.1' plug-ins is installed, and not
+<strong>both</strong> the Old and the New, for either the Core or UI
+components.
+</p>
+<p>
+The first row of the shows the 10.0 Core plug-in works when only the Old UI
+plug-in is installed. The 10.0 Core plug-in does not work when only the
+New UI plugin is installed, nor when the Old and New UI plugin are installed
+at the same time.
+</p>
+
+<table>
+<tr>
+<th> </th>
+<th>Old UI, only </th>
+<th>New UI, only </th>
+<th>Old and New UI together</th>
+</tr>
+<tr>
+<td><strong>10.0 Core</strong></td>
+<td>Works</td>
+<td>Does Not Work *1</td>
+<td>Does Not Work *2</td>
+</tr>
+<tr>
+<td><strong>10.1 Core</strong></td>
+<td>Works</td>
+<td>Works</td>
+<td>Does Not Work *2</td>
+</tr>
+<tr>
+<td><strong>10.0 and 10.1 together</strong></td>
+<td>Works *3</td>
+<td>Works *3</td>
+<td>Does Not Work *2</td>
+</tr>
+</table>
+<p>
+Footnotes:
+</p>
+<ul>
+<li>
+*1 - does not provide any of the client jar files (neither derbyclient.jar or db2jcc.jar).
+</li>
+<li>
+*2 - duplicate menu entries for the Apache Derby nature.
+</li>
+<li>
+*3 - provided the version numbers of these two plug-ins are different, which they will be.
+</li>
+</ul>
+
+
+</section>
+
+<section>
+<title>Uninstalling Previous Versions of the Plug-ins</title>
+
+<p>
+If you are already using the 10.0 Core Plug-in and the old UI plug-in
+you may uninstall them. However, if you have existing projects which
+are using these plug-ins and which rely on the IBM DB2 JDBC Driver to
+connect to the Network Server, you'll need to decide if you want to
+continue using the old plug-ins in the current Eclipse install.
+</p>
+
+<p>
+If you do have projects that rely on the DB2 JDBC Driver you have two options:
+</p>
+
+<ul>
+<li>
+Install the new plug-ins in a new Eclipse install so old projects will
+remain unaffected.
+</li>
+
+<li>
+Modify the existing projects to use the new Derby Network Client.
+
+<ul>
+<li>
+Remove the Apache Derby nature from existing projects.
+</li>
+<li>
+If application code connects to the Network Server using the DB2 JDBC driver,
+recode the application to work with the new Derby Network Client.
+This would probably only involve changing two lines of code.
+For instance, Class.forName("org.apache.derby.jdbc.ClientDriver");
+and the database connection URL.
+</li>
+<li>
+Shutdown Eclipse.
+</li>
+<li>
+Delete these directories under ECLIPSE_HOME/plugins: org.apache.derby.core_10.0.2.x, com.ibm.cloudscape.ui_1.0.0 and com.ibm.cloudscape.plugin.doc_1.0.0.
+</li>
+</ul>
+
+</li>
+</ul>
+
+<p>
+If you want to uninstall the 10.0 Core Plug-in and the 1.0 IBM Integration
+Plug-in for Derby (the old UI) and you do not have existing projects which
+are using them follow these steps:
+</p>
+
+<ul>
+<li>
+Shutdown Eclipse.
+</li>
+<li>
+Delete these directories under ECLIPSE_HOME/plugins: org.apache.derby.core_10.0.2.x, com.ibm.cloudscape.ui_1.0.0 and com.ibm.cloudscape.plugin.doc_1.0.0.
+</li>
+</ul>
+
+
+</section>
+
+<section>
+
+<title>Launching Eclipse and Bringing up the Help</title>
+<p>
+If you are new to Eclipse, this section will help you get started
+in using Eclipse by following the information contained in the Derby Plug-ins
+User's Guide which is part of the Eclipse Help system. This guide is useful
+for both novice Eclipse users and experienced users. If you are already
+familiar with Eclipse, skip this section, but refer to the Help for
+the plug-ins under
+<strong>Help >> Help Contents >> Derby Plug-ins User Guide</strong>.
+Each task described in this paper is described in detail in this help
+document.
+</p>
+<p>
+Launch either eclipse.exe on Windows under the ECLIPSE_HOME directory, or
+eclipse in Linux or Unix environments under the ECLIPSE_HOME
+directory. Accept the suggested default workspace called <em>workspace</em>.
+If this is the first time you have started Eclipse a Welcome window will
+appear. Close this window.
+</p>
+<p>
+Now bring up the Help for the Derby plug-ins which contains a tutorial and
+examples of how to create an Eclipse project, add the Apache Derby nature,
+and use the other menu items associated with the plug-ins.
+From the main Eclipse menu at the top select
+<strong>Help >> Help Contents >> Derby Plug-ins User Guide</strong>.
+Expand the <strong>Getting Started</strong> section in the Derby Plug-ins
+User Guide and refer to each step to learn how to create an Eclipse
+project, add the Apache Derby nature and ultimately build a stand-alone
+application which accesses a Derby database.
+</p>
+
+</section>
+
+<section>
+
+<title>Adding the Apache Derby Nature to an Eclipse Project</title>
+<p>
+If you skipped the section above, <strong>Launching Eclipse and Bringing up
+the Help</strong>, launch Eclipse now after installing the plugins if you
+have not already done so.
+Either create a new project, or open an existing project. The Apache
+Derby menu item will appear when the project folder is right-clicked.
+</p>
+<p>
+To add the Apache Derby Nature to a project, right-click it and select
+<strong>Apache Derby >> Add Apache Derby nature</strong>.
+</p>
+
+<p>
+<img src="../images/add_nature.GIF" alt="Adding the Derby Nature"></img>
+</p>
+
+<p>
+Adding the Derby nature to your Eclipse project does the following:
+</p>
+<ul>
+<li>
+Adds the <strong>derby.jar, derbynet.jar, derbytools.jar,
+derbyclient.jar</strong> jar files to the Java Build Path of the project.<br/><br/>
+</li>
+<li>
+Enables the Derby features for the project. Several other menu items now
+appear under the <strong>Apache Derby</strong> menu item.
+The <strong>ij</strong> and <strong>sysinfo</strong>
+tools are now accessible from this menu, and the Apache Derby Network
+Server can now be started and stopped using this menu. <br/><br/>
+</li>
+<li>
+Allows Apache Derby properties such as the port number the Network Server
+listens on, and the value for derby.system.home to be set for the project.
+</li>
+</ul>
+
+<p>
+Follow the <a href="plugin_help/start_toc.html">Getting Started</a>
+section in the Plug-in documentation or use the Derby Plug-in Users Guide in
+the Help to learn how to start the Network Server, use ij and sysinfo
+and build a Java application which uses Derby.
+</p>
+
+</section>
+
+<p><em>Last Updated: May 23, 2005</em></p>
+
+</body>
+</document>
Propchange: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_howto.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_slides.xml
URL: http://svn.apache.org/viewcvs/incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_slides.xml?rev=178570&view=auto
==============================================================================
--- incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_slides.xml (added)
+++ incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_slides.xml Wed May 25 19:59:25 2005
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+ <header>
+ <title>10.1 Derby plug-ins Presentation and Lab</title>
+ </header>
+ <body>
+
+<p>
+This paper includes a presentation on how to use the Derby Core and UI plug-ins.
+The presentation includes a pdf slide show and a hands-on lab. The lab
+demonstrates using the Derby plug-ins to create Java stored procedures used
+in a stand-alone Java application in the Eclipse environment.
+</p>
+<p>
+The presentation and lab are suitable for new or experienced Eclipse users.
+</p>
+
+<section>
+<title>Downloading the Presentation and Lab</title>
+
+<p>
+The slide show is available in pdf format, <a href="../binaries/derby_plugins_slides.pdf">derby_plugins_slides.pdf.</a>
+</p>
+<p>
+The lab is packaged as a zip file, <a href="../binaries/derby_plugins_lab.zip">derby_plugins_lab.zip</a> and includes the following:
+</p>
+<ul>
+<li>
+Lab Instructions in both OpenOffice (.sxw) and PDF format.
+</li>
+<li>
+SQL files to create the database, create the tables, and create and execute
+the stored procedures.
+</li>
+<li>
+Java source files used to create the Java stored procedures and a sample
+stand-alone application which uses the stored procedures and access the
+tables in the sample database.
+</li>
+</ul>
+
+<p>
+Please feel free to modify and/or extend the lab to fit your requirements!
+</p>
+</section>
+
+
+<p><em>Last Updated: May 24, 2005</em></p>
+
+</body>
+</document>
Propchange: incubator/derby/site/trunk/src/documentation/content/xdocs/integrate/plugin_slides.xml
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/site/trunk/src/documentation/content/xdocs/site.xml
URL: http://svn.apache.org/viewcvs/incubator/derby/site/trunk/src/documentation/content/xdocs/site.xml?rev=178570&r1=178569&r2=178570&view=diff
==============================================================================
--- incubator/derby/site/trunk/src/documentation/content/xdocs/site.xml (original)
+++ incubator/derby/site/trunk/src/documentation/content/xdocs/site.xml Wed May 25 19:59:25 2005
@@ -61,12 +61,43 @@
<cjdbc-oo label="C-JDBC (SXW)" href="../binaries/HOWTO_CJDBC_Derby_v0.2.sxw"/>
<dots label="DOTS Derby" href="../DOTS_Derby.html"/>
<dots label="DOTS System" href="../binaries/UsingDotsDerbySystemTest.pdf"/>
- <eclipse label="Eclipse" href="derby_plugin.html"/>
<emma label="EMMA" href="../binaries/DerbyCodeCoverageUsingEmma.pdf"/>
<jpetstore label="iBATIS JPetStore" href="JPetStoreDerby.html" />
<jonas label="JOnAS (PDF)" href="../binaries/DerbyAndRedHatAppServer.pdf" />
</integrate>
+ <eclipse label="Eclipse Plug-ins" href="integrate/" tab="integrate">
+ <eclipse_old label="10.0 Core" href="derby_plugin.html"/>
+ <eclipse_spec label="1.0 UI Functional Spec" href="func_spec_plugins.html"/>
+ <eclipse_new label="10.1 Core and 1.0 UI" href="plugin_howto.html"/>
+ <eclipse_present label="10.1 Core and 1.0 UI Slides and Lab" href="plugin_slides.html"/>
+ <eclipse_help label="10.1 Core and 1.0 UI Documentation" href="plugin_help/">
+ <start label="Getting Started" href="start_toc.html" />
+ <proj label="Creating an Eclipse Project" href="java_project.html" />
+ <nature label="Derby Nature" href="">
+ <nature_toc label="Adding or Removing" href="nature_toc.html"/>
+ <add_nature label="Adding the Derby Nature" href="nature.html" />
+ <remove_nature label="Removing the Derby Nature" href="remove_nature.html" />
+
+ </nature>
+ <server label="Network Server" href="">
+ <start_stop label="Starting and Stopping" href="server_toc.html"/>
+ <start_server label="Starting the Server" href="start_server.html"/>
+ <stop_server label="Stopping the Server" href="stop_server.html"/>
+
+ </server>
+
+ <props label="Derby Properties" href="properties.html"/>
+ <ij label="ij" href="">
+ <ij_toc label="Using ij" href="ij_toc.html"/>
+ <ij_command label="SQL commands" href="ij.html"/>
+ <ij_script label="SQL scripts" href="ij2.html"/>
+ </ij>
+ <java_app label="Building a Java App" href="derby_app.html"/>
+ <sysinfo label="Running sysinfo" href="sysinfo.html"/>
+ <derby_doc label="Derby Manuals" href="resources.html"/>
+ </eclipse_help>
+ </eclipse>
<manuals label="Manuals" href="manuals/" tab="manuals">
<index label="About" href="index.html"/>