TechKnights

Managing software development

Installation and Setup Guidelines

• Git Installation and setup:

1. Install Git Desktop from https://desktop.github.com/
2. Open Git desktop. Clone emma1089/techKnights and give the path you want to locate the code.

Possible Errors:

You can’t see the repository in Git desktop.

Solution:

Check if you are a collaborator of this repository.

  </p>

---

• Eclipse Installation and setup:

1. Install Eclipse IDE for Java EE Developers from https://eclipse.org/downloads/
2. Open the Eclipse IDE
3. Go to help ->marketplace ->
   • nstall Spring IDE
   • Maven Integration for Eclipse
4. Open Git desktop. Clone emma1089/techKnights and give the path you want to locate the code.

Possible Errors:

This installation is straight forward. If you get any installation error.

Solution:

Follow https://wiki.eclipse.org/Eclipse/Installation for any errors.

  </p>

---

<li><h4>Tomcat Server Installation and setup:</h4></li>
   <ol>
    <li>Install Tomcat from https://tomcat.apache.org/download-70.cgi</li>
   </ol>

  <p><h5>Possible Errors:</h5>
This installation is straight forward. If you get any installation error.
    <h5>Solution:</h5>
Make sure the main instant of tomcat is stopped.

Add instance of Tomcat to Eclipse Follow https://tomcat.apache.org/tomcat-9.0-doc/index.html for any errors.

---

• MySQL Installation and setup:

1. Install MySQL from https://www.mysql.com/downloads/
2. In MySQL Workbench add connections.

  <p><h5>Possible Errors:</h5>
This installation is straight forward. If you get any installation error.
    <h5>Solution:</h5>
Follow http://dev.mysql.com/doc/ for any errors.
  </p>

---

Running WHAM

Running WHAM on localhost:

1. Import the WHAM project in Eclipse IDE.
2. To test the project: Open project, either build using maven or run test by WHAM->src/test/java->Run TestSuite.java
3. To run the project: Right click on the project folder -> ‘Run as -> Run on server’ to run the project.
4. You can run the project on the browser of your choice.
5. Go to localhost http://localhost:8080/

Possible Errors:

You may get errors related to Tomcat server. You may get errors related to MySQL database. If you come across errors related to Spring/ Hibernate

    <h5>Solution:</h5>
Check if your Tomcat server is installed properly.

Follow https://tomcat.apache.org/tomcat-9.0-doc/index.html for any errors.

Check if your MySQL is installed and connected properly. Follow http://dev.mysql.com/doc/ for any errors.

Check the installation of Spring/Hibernate Check the pom.xml file for username, password and connection details. Check the hibernate.cfg.xml file

  </p>

---

Hosting Website

• Click on File -> Export -> WAR file. Give the location of WAR file.
• Clone the repository of the hosted project on to local machine in a folder, lets say “wham-proj” using: git clone ssh://565e1c047628e17f38000024@techknights-whamapp.rhcloud.com/~/git/techknights.git/
• Remove the src folder and only let readme and webapps folder remain
• (step 2 and 3 only needs to be done once)
• Add the WAR file from step one in webapps folder
• In terminal, navigate to folder where cloned repo is(eg wham-proj) after
git add
• Commit the changes using command
git commit –m “Add description of commit”
• Push the code into the server.
git push