johnrwolfe/hrs

The UI of this project uses:

Apache Tomcat

Maven

MySQL

Apache Tomcat:

• Download Apache Tomcat 9.
  
• Apache Tomcat provides a good instructions on how to run tomcat.
  
  

- Go to ‘apache-tomcat-9.0.35/conf’ open ‘tomcat-users.xml’ and in <tomcat-users> </tomcat-users> add “
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<user username="admin" password="password" roles="manager-gui,manager-script"/>
“
(and make sure it’s not in a comment (<!-- -->))

---------------------------------------------------------------
Here's a good documentation about Tomcat 9.
---------------------------------------------------------------

Maven:

- To install maven here is a link to guide you through the installation proccess.
After installing maven:
- To go to '.m2' folder open the terminal and run 'open .m2'.
- There should be a 'settings.xml' file, if not you can create a 'settings.xml' and here's a link on how to setup the settings file.
- Open ‘setting.xml’ file and in <servers> </servers> add “
<server>
<id>TomcatServer</id>
<username>admin</username>
<password>password</password>
</server>
“

MySQL:

We used MySQL to store our data so that our operations won't be deleted when we restart the project.
- To Download MySQL (link)
After Downloading MySQL:
- To run MySQL here is a link that provide all the information needed on how to start MySQL.
- After starting MySQL, create a database named (HR).

--------------------------------------------------------------
A good application to show your database is MySQL Workbench (download).
MySQL documentation
MySQL Workbench documentation
---------------------------------------------------------------

Running The Project:

You’ll have to use three terminal windows.
- On the first terminal window move to ‘hrm’ folder and do a ‘mvn install’.
- On the second terminal window go to ‘apache-tomcat-9.0.35/bin’ folder and run ‘./catalina.sh start’.
- On the first terminal window move to ‘HRsystem’ folder and run ‘mvn install tomcat7:deploy’.

• open ‘hrm/HRsystem/WebContent/WEB-INF’ folder and copy all .html and .css files and paste it in ‘apache-tomcat-9.0.35/webapps/HRsystem/WEB-INF/classes’.
  
• open the third terminal window and move to ‘hrm’ directory.
  
• open your browser, the link to the project is ‘http://localhost:8080/HRsystem/home/page/web’, go to the third terminal window and run ‘bash run.sh’ (you'll have to run it within 5 seconds so that the project can connect to the socket port).