Creating a New ACUITy Application

The batch files referenced below (createNewProject.bat and buildProjectWar.bat) are provided as an alternative means of running Ant builds.If you are working in an Integrated Development Environment (IDE) such as Eclipse, you may wish to run the Ant build files with selected targets in that environment, in which case you do not need the batch files.

1. If you are doing batch file builds and do not have an "ANT_HOME" environment variable set on your computer (right-click on My Computer, select Properties->Advanced->Environment Variables to view/edit environment variables), edit createNewProject.bat and change the setting for ANT_HOME to match your environment. For example, the edited line might look like:
   • SET ANT_HOME=c:\eclipse\plugins\org.apache.ant_1.6.5
2. Run createNewProject.bat (or run the createNewProject.xml Ant build file directly) giving input^* as requested for the following questions:
   • project name (e.g. myNewProject)
   • host name (e.g. localhost)
   • port name (e.g. 8080)
   • web deploy path (e.g. C:\Program Files\apache-tomcat-5.5.17\webapps)
   • path to directory under which the new project should be placed (e.g., C:\AcuityApps). A new subdirectory will be created (e.g. C:\AcuityApps\myNewProject).
   ^*Note: default values are provided for at least some of these questions. To accept the default, just press the Enter (Return) key. After you have created your first application, subsequent runs of this build will use the previous answers as default values for all but the new project name.
3. Go to the new project directory (e.g., C:\AcuityApps\myNewProject)
4. If you are doing batch file builds and do not have an ANT_HOME environment variable set on your computer, change the ANT_HOME settings in buildProjectWar.bat to match your environment.
5. Run tomcatDeploy.bat, jbossDeploy.bat, or buildProjectWar.bat (or run the Ant build file build.xml with the appropriate target directly using Ant).
   • tomcatDeploy.bat will create a war file and deploy it to a Tomcat server at the location you specified in step 2 above
   • jbossDeploy.bat will create a war file and deploy it to a JBoss server at the location youj specified in step 2 above
   • buildProjectWar.bat will create a war file in the "dist" directory (e.g. C:\AcuityApps\myNewProject\dist\myNewProject.war), which you must then copy manually to your web deploy directory (e.g., c:\Program Files\apache-tomcat-5.5.17\webapps).
   • Start the web server (for example, run C:\Program Files\apache-tomcat-5.5.17\bin\startup.bat).
   • Start a new web browser (ACUITy has been tested on Microsoft Internet Explorer).
   • Enter the URL for myNewProject (e.g., http://localhost:8080/myNewProject).
   • Click on the splash screen to enter the new application.
   • Enter any user name and click "Submit". The only vantage in a new application will be the Application Editor. You may use the editor vantage to build your new application.

Notes

1. The instance data for saved sessions (<project name>InstData.owl), from which learned defaults are derived, will also be stored in the ApplicationOntologies subdirectory under the new project directory.
2. The ACUITy Editor "What is..." help gets information directly from SourceForge. To work, the proxyHost (and possibly proxyPort) settings in your project's .../src/applicationSetting.properties must be changed to settings appropriate for your firewall. This should be done prior to running buildProjectWar.bat.

Copyright 2007 General Electric Company

Revised 02/02/2007