ctakes-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Finan, Sean" <Sean.Fi...@childrens.harvard.edu>
Subject RE: IntelliJ experience or instructions
Date Thu, 12 Feb 2015 19:24:53 GMT
Hi Taposh,

Try the process outlined below.  I have screenshots for each step if you want them.  If this
works (you are the first tester) then we can put it in the web documentation.

Sean

Fresh checkout from SVN
=======================
1. Start IntelliJ IDEa.
2. In the "Quick Start" menu, select "Check out from Version Control" (VCS icon).  
This will display a drop-down box.
3. In the drop-down box, select "Subversion".  
This will open a "Checkout from Subversion" dialog.

4. In the "Checkout from Subversion" dialog, click the "+" button in the top left to add a
new Repository.  
This will open a "New Repository Location" dialog.
5. In the "New Repository Location" dialog, enter the svn checkout location of cTakes.
6. Click "Ok".  
This will inspect the repository.
7. Click the "Expand" triangle.  
This should display the directory listing of trunk.
8. Click "Checkout".  
This will open a "Destination Directory" dialog.

9. Enter a local directory in which to keep trunk (your sandbox).
10. Click "Ok".  This will open a "Checkout Options" dialog.  
The default options ("Head", etc.) are fine for most users.
11. Click "Ok".  
This will open a "Working Copy Format" dialog.
12. Select a (version) format and click "Ok".  I use version 1.8, but any should be fine.
 
This will start the actual checkout and display a progress dialog.  The checkout may take
a little while.

13. After the checkout has completed, you a new dialog will ask you if you'd like to open
the project.  Click "No".


Import Project from Maven
=========================
A local repository is needed.  If you do not yet have one, follow any instructions on this
wiki for checking out cTakes.
1. Start IntelliJ IDEa.
2. In the "Quick Start" menu, select "Import Project".
This will open a "Select File or Directory to Import" dialog.
3. Browse to your local cTakes repository root directory and select the pom.xml file.
4. Click "Ok".
This will open an "Import Project from Maven" dialog.
5. Make sure the "Search for projects recursively" box is selected, just in case any cTakes
modules are not in the pom.
6. Make sure that "Create IntelliJ IDEa modules for aggregator projects" is not selected.
If you plan to add new module, 'disable' a present cTakes module or make other changes to
the main pom.xml, check the "Import Maven projects automatically" box.
See also: http://www.jetbrains.com/idea/webhelp/maven-importing.html
7. Make sure that "Create module rgoups for multi-module Maven projects" is not selected.
8. Make sure that "Keep source and test folders on reimport is selected.
9. Make sure that "Exclude build directory (%PROJECT_ROOT%/target)" is selected.
10. Make sure that "Use Maven output directories" is selected.
11. Make sure that the "Generated sources folders" option "Detect automatically" is selected.
12. For the "Phase to be used for folders update" the default option "process-resources" should
be fine.
13. For the "Automatically download" options, you may select what you like, but be wary that
if broken code has been checked in you may need to revert manually.
14. The default "Dependency types" are fine.
15. Click "Environment settings...".
This will open a dialog that can be used to set options about the Maven environment.
16. The default maven environment settings should be fine.  If $M2_HOME is not set in your
environment you may select a "Maven home directory", but it is better to set $M2_HOME in your
environment.
17. Click "Next".
This will inspect the cTakes Maven settings and search for profiles.  It should display a
dialog with the possible cTakes profiles.
If you plan to run the UIMA CVD or CPE then select the appropriate profile.  Neither is necessary
18. Click "Next".
This will open an "Import" dialog with the current version of cTakes displayed.
19. Click "Next".
This will open a dialog allowing you to select a Java SDK version.
20. Click the "+" button in the top left.
This will display a drop-down box with options for an SDK.
21. Select "JDK".
This will open a dialog to select a Java JDK directory.
22. Navigate to a directory with a JDK and click "Ok".  
This will display a listing of the file paths associated with the selected JDK.
23. Click "Next".

24. Click "Ok/Next???"  Didn't see dialog.
The project will load.  This may take a while.
25. Important: If you are asked about adding and .iml files to svn, click "No".  

26. You should now see the full cTakes project structure in IntelliJ.


Compile with Maven
===================
1. Open the "Maven Projects" Tool Window using the button on the left side of the window.
 
If you do not see it, Use the main Menu > View > Tool Windows > Maven Projects.
If you would like to permanently add the button to the UI, use Menu > View > Tool Buttons.
See also: http://www.jetbrains.com/idea/webhelp/maven-projects-tool-window.html
2. Select the "Expand" triangle next to "Apache cTAKES" and then its child node "Lifecycle".
This will display standard maven goals.
3. Right-click on "compile".
This will display a selection of available actions.
4. Select "Create 'ctakes [compile]'..."
This will open a dialog with options for the Maven "compile" goal.
5. Make sure "Profiles (...)" is empty.
6. Click "Ok".
7. You should now see a new child of "Apache cTakes" named "Run Configurations", with the
child node "ctakes [compile]"
8. Right-click on "ctakes [compile]" and select "Run" from the popup menu.
9. A panel should appear at the bottom of the screen and display the progress of the compilation.
 This may take a while.


Running UIMA CVD with Maven
==================
1. Open the "Maven Projects" Tool Window using the button on the left side of the window.
 
If you do not see it, Use the main Menu > View > Tool Windows > Maven Projects.
If you would like to permanently add the button to the UI, use Menu > View > Tool Buttons.
See also: http://www.jetbrains.com/idea/webhelp/maven-projects-tool-window.html
2. Select the "Expand" triangle next to "Apache cTAKES" and then its child node "Lifecycle".
This will display standard maven goals.
3. Right-click on "compile".
This will display a selection of available actions.
4. Select "Create 'ctakes [compile]'..."
This will open a dialog with options for the Maven "compile" goal.
5. In the "Name" box at the top of the dialog type "cTakes runCVD".
6. In "Profiles (...)", type "runCVD".
7. Click "Ok".
8. You should now see a new child of "Apache cTakes" named "Run Configurations", with the
child node "cTakes runCVD"
9. Right-click on "cTakes runCVD" and select "Run" from the popup menu.
10. A panel should appear at the bottom of the screen and display the progress of the compilation.
 This may take a while.
11. The UIMA CVD should launch when the compilation is complete.
12. All standard output and error from the CVD will be piped to the IntelliJ Window.




-----Original Message-----
From: taposh.d.roy@kp.org [mailto:taposh.d.roy@kp.org] 
Sent: Thursday, February 12, 2015 1:51 PM
To: dev@ctakes.apache.org
Subject: IntelliJ experience or instructions

All -

Did any one use IntelliJ? Are there any instructions using intelliJ?

Regards,

Taposh D. Roy
Health Data Lead
Decision Support Team

Kaiser Permanente
Program Office 
1950 Franklin Street, 17th Floor
Oakland, California 94588
510-987-4121 (Office)
510-206-1633 (cell)



NOTICE TO RECIPIENT:  If you are not the intended recipient of this 
e-mail, you are prohibited from sharing, copying, or otherwise using or 
disclosing its contents.  If you have received this e-mail in error, 
please notify the sender immediately by reply e-mail and permanently 
delete this e-mail and any attachments without reading, forwarding or 
saving them.  Thank you.


Mime
View raw message