ItcPro ™ Installation Notes and Getting Started Guide

Before Installing ItcPro ™

ItcPro ™ and its’ documentation is bundled in the file com.itc.pro_n.n.n.zip where n.n.n is the current product version number. You will need to download the ItcWorks™ open source project from www.i-techcorp.com to obtain the supplemental database documentation. The ItcWorks™.jar is required for an application's use of the artifacts produced by ItcPro™.

You can download ItcWorks™ by going to www.i-techcorp.com and selecting the ItcWorks™ Download option or go directly to www.sourceforge.net.

ItcPro™ is an Eclipse IDE plug-in and requires installation of the following:

• Eclipse IDE

• Windows NT, 2000 or XP

• JDK 1.5

• JDBC compliant database(s) (Oracle, IBM’s UDB, MySQL, MS SQL Server, etc.)

Pre-Installation Notes:

1. If you have Eclipse running, you must shutdown eclipse before continuing with the next step.

2. If you already have a prior version of the com.itc.pro_n.n.n jar in this directory, you must delete that older jar before restarting Eclipse.

Installing ItcPro ™

Unzip the contents of the downloaded zip file into a temp directory.

The following files should be present:

• com.itc.pro.n.n.n.jar (where n.n.n represents the current version) This is the eclipse plugin.

• ItcProInsNotes.html (this file) – Installation Notes

• ItcWorksPro.movies - Flash Movies on ITCPro™

Move the com.itc.pro._n.n.n.jar to your eclipse/plugins directory. For Windows users this is typically c:\eclipse\plugins.

Start Eclipse. That completes the installation process.

ITCPro ™ Setup and License Key Activation.

The first order of business is activating your license key. You do this from the ITC Preferences panel. From the Eclipse menu bar, select the Windows/Preferences menu item. Click on the ITC Preferences entry in the left tree pane. Paste the license key that was emailed to you in the License Key text box and click the Activate button.

NOTE: You must have an active Internet connection to activate your license key. If you move ITCPro to another computer you must see the ITC Preference Dialog to “Deactivate” the software and then “Activate” the license on the new computer.

DatasourceDriver setup

Before using ItcPro ™, you must setup the DatasourceDrivers.xml document and tell ItcPro ™ where this document resides. The DatasourceDrivers.xml document contains the connection details to the database(s) that you will be using. Please refer to the ItcWorks™ORM++.pdf document found in the ItcWorks™ project for a complete description of xml tags used to specify the JDBC connection parameters. You must then tell ItcPro ™ where this document resides, which is also found on the ITC Preferences panel. You can click the browse button to navigate to the directory where DataSourceDrivers.xml document resides.

NOTE: If you do not have a DataSourceDrivers document, ItcPro ™ will create a default template document when you attempt to make a database connection. You will need to edit the document for your specific database settings before a connection can be made.

Tutorials

Although not needed to use ItcPro ™, it is recommended that developers read the ItcWorks™ORM++.pdf document which describes the sql mapping xml documents (.xsm) produced by ItcPro ™ and how to incorporate them into your applications.

ItcPro ™ comes with a set of tutorials in the form of movies that you should view before using this product. They are listed below with a description of the topics each one covers:

• ITCPro Setup(vN) – Instructions on registering your product license and setting up your datasources

• ITCPro Demo(vN) – General overiew of ITCPro’s functionality

• ITCPro ORM(vN) – Review of the Object Relational Mapping and Java code generation features

• ITCPro SQL Editor(vN) – Review of SQL editing features

• ITCPro Custom SQL(vN) – Review of building custom SQL statement

*(vN=Version Number)