<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:slash="http://purl.org/rss/1.0/modules/slash/">
    <channel>
        <title>Tutorial :: CUBRID Through QuantumDB Eclipse Plugin</title>
        <link>http://www.cubrid.org/?mid=quantumdb_eclipse_plugin</link>
        <description>Tutorial :: CUBRID Through QuantumDB Eclipse Plugin</description>
        <language>en</language>
        <pubDate>Sat, 10 Apr 2010 23:01:53 -0800</pubDate>
        <lastBuildDate>Wed, 28 Sep 2011 04:42:31 -0800</lastBuildDate>
        <generator>XpressEngine 1.4.4.1</generator>
                        										        <item>
            <title>Tutorial :: CUBRID Through QuantumDB Eclipse Plugin</title>
            <dc:creator>admin</dc:creator>
            <link>http://www.cubrid.org/quantumdb_eclipse_plugin</link>
            <guid isPermaLink="true">http://www.cubrid.org/quantumdb_eclipse_plugin</guid>
                                    <description><![CDATA[<h1>CUBRID Through QuantumDB Eclipse Plugin</h1>

<div class="contents-table">
<h3>Table of Contents</h3>
<ul>
	<li><a class="toTop">Back to Top</a></li>
	<li><a href="#preface">Preface</a></li>
	<li><a href="#prerequisites">Prerequisites</a></li>
	<li><a href="#installation">Installation</a></li>
	<ul>
		<li><a href="#cubrid-installation">CUBRID Installation</a></li>
		<li><a href="#eclipse-installation">Eclipse Installation</a></li>
		<li><a href="#gef-installation">GEF Installation</a></li>
		<li><a href="#quantumdb-installation">QuantumDB Installation</a></li>
	</ul>
	<li><a href="#quantumdb-configuration">QuantumDB Configuration</a></li>
	<li><a href="#see-also">See also</a></li>
</ul>
</div>

<p>If you are familiar with Eclipse and prefer using it as an
interface for various projects, there is an Eclipse Plugin
called <a href="http://quantum.sourceforge.net/" target="_blank">QuantumDB</a> that you can use to connect to and administer the CUBRID Database Server. Below you will find very detailed and step
by step tutorial, which will lead you trough the installation
process.</p>

<h2 id="preface">Preface</h2>
<p>Since QuantumDB connects to the database through CUBRID JDBC
Driver, you can have any version of CUBRID Database Server
installed on your machine. In this tutorial we will be using the
latest, at the point of writing, version of CUBRID 2.2 64-bit. If
there is a newer version available, you are highly recommended to
install it.</p>
<p>All applications including CUBRID, QuantumDB, and Eclipse are
available for both Linux and Windows, this tutorial will serve the
universal needs. In this case our system is Windows 7 64-bit.</p>

<h2 id="prerequisites">Prerequisites</h2>
<p>First, let's make sure we have the necessary installation
files. There are five items we have to install. Some items might
have already been installed.</p>
<ol>
  <li>Since <b>CUBRID</b> is the reason of this topic, make sure you have
  <a href="/downloads" target="_blank">downloaded</a> the latest
  version. There is an <a href="/tutorials#getting-started">Easy Installation Guide</a>
  for it.</li>
  <li>We will also need <b>Eclipse</b>. You can download the latest
  version from <a href="http://www.eclipse.org/downloads/" target="_blank">Eclipse Download</a> page. There are many
  different version of Eclipse optimized for different purposes.
  Choose the one you think applies to you best. If you are not sure
  which one suits you better, you may download Eclipse Classic. In
  this version we will be using Eclipse Classic 3.5.2.</li>
  <li><b>GEF&nbsp;</b>(Graphical Editor Framework) is another tool we have to
  <a href="http://www.eclipse.org/gef/downloads/" target="_blank">download</a>. GEF allows developers to take an
  existing application model and quickly create a rich graphical
  editor. QuantumDB Eclipse plugin needs it. Here we have GEF 3.5.2
  All-In-One SDK installed.</li>
  <li>Finally, we need <b>QuantumDB</b> plugin itself.
  <a href="https://sourceforge.net/projects/quantum/files/quantum-plugin/" target="_blank">Download</a> the latest version. Currently we
  used QuantumDB 3.3.9.</li>
</ol>

<h2 id="installation">Installation</h2>

<h3 id="cubrid-installation">CUBRID Installation</h3>

<ol>
<li>Make sure you correctly installed CUBRID Database
Server. If you need help with CUBRID installation, refer
to <a href="/tutorials#getting-started">CUBRID Installation Guide</a>.</li>
<li>In order to meet CUBRID requirements, we have to make sure the <b>JAVA bin directory</b>
is in our Environment <i>PATH</i> and <b>CUBRID JDBC directory</b> is in <i>CLASSPATH</i>. You may
do so by:</li>
  <ul>
	<li>Right click on <b>My Computer</b> and select
	<b>Properties</b>. You will see the following picture.
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/my%20computer%20properties.PNG" alt="my computer properties.PNG" width="543" height="451" editor_component="image_link"/></p>
	</li>
	<li>On the left panel choose
	<b>Advanced system settings</b>. You will see the picture below.
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/system%20properties.png" alt="system properties.png" width="426" height="474" editor_component="image_link"/></p></li>
	<li>In the
	<b>System Properties</b> press <b>Environment Variables</b> button. You will see:
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/environment%20variables.png" alt="environment variables.png" width="394" height="436" editor_component="image_link"/></p></li>
	<li>Double click on
	<b>Path</b> and add your 
	<b>JAVA bin directory</b> path (in my case it
	is <i>c:Program FilesJavajre6bin</i>), double click
	on <i>CLASSPATH</i> and add a path to CUBRID JDBC
	directory (in my case it is <i>c:CUBRIDjdbc</i>). You are done!
	All paths are set.</li>
  </ul>
<li>Start <b>CUBRID Service</b> and <b>demodb</b> sample database.</li>
<ul>
	<li>Open the <b>Command line</b> (<i>Windows+R</i> shortcut, enter <i>cmd</i> and press enter).</li>
	<li>Type <b>cubrid service start</b> to start the CUBRID Service. You should see the following output. If not, it
	means CUBRID is installed incorrectly. Try to reinstall it.
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/command%20line.PNG" alt="command line.PNG" width="353" height="199" editor_component="image_link"/></p>
	</li>
	<li>Start <b>demodb</b> sample database. Type <b>cubrid server start demodb</b>. If demodb database has
	been successfully started, you will see the following
	picture. If not, make sure you have installed demodb
	sample database when you were installing CUBRID DBMS.
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/command%20line%20demodb.PNG" alt="command line demodb.PNG" width="355" height="270" editor_component="image_link"/></p>
	</li>
</ul>
</ol>

<h3 id="eclipse-installation">Eclipse Installation</h3>

<p>There is nothing easier than installing Eclipse. Just
unpack the downloaded zip file somewhere like
<b>C:/Program Files/Eclipse</b> or <b>C:/Eclipse</b>. For your convenience you may also place a
shortcut to your desktop. If you need help with Eclipse installation, refer to
<a href="http://wiki.eclipse.org/FAQ_Where_do_I_get_and_install_Eclipse%3F" target="_blank">Eclipse Installation Guide</a>.</p>

<h3 id="gef-installation">GEF Installation</h3>

<p>After you download GEF (Graphical Editor Framework) zipped file, extract it some
  temporary place, you will delete it when you finish this
  tutorial. When you unzip, you will have one directory
  named as
  <b>eclipse</b>, which has two files and two folders. You
  have to copy these two folders (<b>features</b> and <b>plugins</b>) to your Eclipse directory where you
  unzipped Eclipse. In fact Eclipse folder will already be
  containing these two folders. Just you have to override
  them. <b>DO NOT REPLACE</b> these folder, just copy over them.
  If you have any problems, post them to
  <a href="http://www.eclipse.org/projects/project_summary.php?projectid=tools.gef" target="_blank">GEF Forum</a>.
</p>

<h3 id="quantumdb-installation">QuantumDB Installation</h3>
<p>This step is identical to that of GEF Installation
above. Just unpack it, copy its two same folders to
Eclipse folder. If you have some problems you can always
refer to
<a href="https://sourceforge.net/projects/quantum/forums/forum/24178" target="_blank">QuantumDB General Forum</a>. The
community will help you quickly. You might want to
read particularly this forum topic: 
<a href="https://sourceforge.net/projects/quantum/forums/forum/24178/topic/3706124/index/page/1" target="_blank">Does QuantumDB officially support
CUBRID?</a></p>

<h2 id="quantumdb-configuration">QuantumDB Configuration</h2>

<p>Now lunch Eclipse. When you lunch it, you will see a
window in <b>Java default perspective</b>. If you want to
know what <b>Perspective</b> is in Eclipse, read
<a href="http://www.eclipsepluginsite.com/perspectives.html" target="_blank">Eclipse Plugin Perspectives</a>. In our
case we have to set the <i>Perspective</i> to <b>QuantumDB Perspective</b>. Follow the steps below.</p>

<ol>
	<li>In Eclipse select <b>Window-&gt;Open Perspective-&gt;Other</b> as shown in the
	picture below.
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/eclipse%20perspective.PNG" alt="eclipse perspective.PNG" width="468" height="321" editor_component="image_link"/></p>
	</li>
	<li>Once you click <b>Other</b> you will see a small window shown
	below. You have to choose QuantumDB from the provided
	list of perspectives like in the picture below, and hit
	Enter.
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/quantumdb%20perspective.png" alt="quantumdb perspective.png" width="359" height="436" editor_component="image_link"/></p>
	</li>
	<li>Your Eclipse Interface should immediately change to
	different look like in the picture below.
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/eclipse%20quantumdb%20perspective.PNG" alt="eclipse quantumdb perspective.PNG" width="512" height="394" editor_component="image_link"/></p>
	</li>
	<li>On the left side you will see a side panel called
	<b>Database Bookmarks</b>. You have to click on
	<b>New Bookmark</b> button on the panel header as
	shown below.
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/quantumdb%20new%20bookmark.PNG" alt="quantumdb new bookmark.PNG" width="323" height="156" editor_component="image_link"/></p>
	</li>
	<li>A new small window will pop up. See the image below.
	You have to click on
	<b>Add driver</b> button.
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/QuantumDB%20add%20driver.png" alt="QuantumDB add driver.png" width="525" height="429" editor_component="image_link"/></p>
	</li>
	<li>In the new window, click on
	<b>Add External Jar</b> button.
	
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/QuantumDB%20add%20external%20jar.png" alt="QuantumDB add external jar.png" width="525" height="387" editor_component="image_link"/></p>
	</li>
	<li>In the new Explorer Window locate CUBRID JDBC Driver
	(in my case it is
	in c:CUBRIDjdbccubrid_jdbc.jar).
	
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/cubrid%20external%20jar.PNG" alt="cubrid external jar.PNG" width="376" height="227" editor_component="image_link"/></p>
	</li>
	<li>Now in the last opened window (
	<b>New JDBC Driver w</b>indow) you see CUBRID Driver jar.
	Select it and click
	<b>Browse</b> button. Select
	<b>cubrid.jdbc.driver.CUBRIDDriver</b> and press OK
	button. You will see the following.
	
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/QuantumDB%20add%20external%20jar%20finish.png" alt="QuantumDB add external jar finish.png" width="525" height="387" editor_component="image_link"/></p>
	</li>
	<li>Press
	<b>Finish</b> button. It will return to the first
	<b>New Bookmark</b> window. Among the listed driver
	choose
	<b>cubrid.jdbc.driver.CUBRIDDriver</b>. and press
	<b>Next</b> button. You will be prompted to enter
	<b>Userid</b>,
	<b>Password</b>, and
	<b>JDBC URL</b>. Leave first two fields empty and enter
	<b>jdbc:cubrid:localhost:33000:demodb:::</b> in the
	<b>JDBC URL</b> field. Look at the picture below.
	
	<p><img src="http://www.cubrid.org/files/attach/images/49/346/cubrid%20bookmark.png" alt="cubrid bookmark.png" width="525" height="429" editor_component="image_link"/></p>
	</li>
	<li>Click
	<b>Next</b>. Give this new bookmark a name like
	<b>CUBRID</b> or something related to CUBRID. Then
	press
	<b>Finish</b> button.
	<b>You are DONE!</b> Double click the
	<b>CUBRID Bookmark</b>. Select the necessary Table. Click
	around and you will see lots of features pertaining to
	database and table manipulation.</li>
</ol>

<h2 id="see-also">See also</h2>

<ul>
<li><a href="/tutorials">CUBRID Tutorials</a></li>
</ul>]]></description>
                        <pubDate>Sun, 11 Apr 2010 15:23:04 -0800</pubDate>
                                </item>
            </channel>
</rss>
