db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j..@apache.org
Subject 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/
Date Thu, 26 May 2005 02:59:29 GMT
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
&amp; 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>&nbsp;</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"/>



Mime
View raw message