Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Last revision Both sides next revision
devel:documentation:quickstart:dev:ide:idea [2023/11/09 09:36]
kolombom [Configure test runner] 		devel:documentation:quickstart:dev:ide:idea [2023/12/05 08:51]
kolombom
Line 7: Line 7:
 ====== Import project ====== ====== Import project ======
  
-  - Open Idea and choose to //Import project (File -> New -> Project from Existing Sources)// +  - Open Idea and choose to //Import project (File → New → Project from Existing Sources)// 
-  - Import the ''/--path--/CzechIdM/Realization/backend/aggregator''  project, where ''--path--''  is wherever you pulled your sources, click //Next//+  - Import the ''/–path–/CzechIdM/Realization/backend/aggregator''  project, where ''–path–''  is wherever you pulled your sources, click //Next//
   - {{  .:importmaven.png?nolink&460x581  }}The aggregator project should import all dependencies automatically, give it some time.   - {{  .:importmaven.png?nolink&460x581  }}The aggregator project should import all dependencies automatically, give it some time.
   - Next. Next… Project should be imported.   - Next. Next… Project should be imported.
Line 62: Line 62:
  
 Save the configuration and test it by running. Tests from all modules should be executed. Save the configuration and test it by running. Tests from all modules should be executed.
- 
  
 ====== Launch on Tomcat ====== ====== Launch on Tomcat ======
Line 68: Line 67:
 First of all make sure that you have Tomcat 9.0 installed. Then chose Tomcat server in Run/Debug Configurations in IDEA. Set URL to "http://localhost:8080/idm-backend/". On a "Deployment" tab set Application context to ''idm-backend/''. Apply and try to launch the project on server. At this point I had an error that said something like "name or service not known", there is the link that helped me solving this error: "https://stackoverflow.com/questions/19068977/intellij-cant-start-simple-web-application-unable-to-ping-server-at-localhost". First of all make sure that you have Tomcat 9.0 installed. Then chose Tomcat server in Run/Debug Configurations in IDEA. Set URL to "http://localhost:8080/idm-backend/". On a "Deployment" tab set Application context to ''idm-backend/''. Apply and try to launch the project on server. At this point I had an error that said something like "name or service not known", there is the link that helped me solving this error: "https://stackoverflow.com/questions/19068977/intellij-cant-start-simple-web-application-unable-to-ping-server-at-localhost".
  
-{{  .:backend-path.png?nolink&780x182  }}​​​​​​​+{{  .:backend-path.png?nolink&780x182  }}
  
 TIP 01: Deploy exploded artefact instead of compressed one. TIP 01: Deploy exploded artefact instead of compressed one.
  
 TIP 02: If there is nothing deployed to the server check File → Project Structure → Artefacts tab. Add all modules you want to deploy to the artefact you deploy. This should happen automatically by Maven but sometimes it doesn't. TIP 02: If there is nothing deployed to the server check File → Project Structure → Artefacts tab. Add all modules you want to deploy to the artefact you deploy. This should happen automatically by Maven but sometimes it doesn't.
 +
 +====== Importing a Module ======
 +
 +To develop a module alongside main CzechIdm, import the module from Project Structure > Project Settings > Modules > Right click in the list of modules > Add > Import Module
 +
 +{{.:screenshot2023-12-04153509.png?nolink&1035x921}}
 +
 +When the module is imported, go to Artifacts tab and drag the module artifact over idm-backend.war.
 +
 +{{.:idm-war.png?nolink&855x579}}
 +
 +Then rebuild the project.
 +
 +<note important>When you reload Maven configuration, this change will disappear and you have to re-add the module to war again<note>
 +
 +===== Troubleshooting =====
 +
 +If you see errors with missing dependencies, try to reload Maven profiles (double-shift > reload Maven).
 +
 +If that doesn't help, try to rebuild project from command line ''mvn clean install -DskipTests''
  
  
  • by kolombom