Setting up HyperImage Development Envoirnment

The following steps are required to setup HI development envoirnment:

1. Download eclipse IDE
2. Setup Maven on eclipse
3. Checkout Hyperimage project from this GIT repsitory. This will create following maven projects:
   1. hi3-authorenv
   2. hi3-editor
   3. hi3-manager
   4. hi3-parent
   5. hi3-reader
   6. HIImage
4. Create new glassfish server (only tested with Glass Fish version 4.1.2) in eclipse IDE. By default eclipse IDE does not have glassfish server, please follow the link https://stackoverflow.com/questions/25200410/how-to-configure-glassfish-server-in-eclipse-manually to create and start new glassfish server.
5. Run maven "clean package" on hi3-parent. This will compile the code and will create necessary components including manager applet, editor applet, and reader-base.zip. Finally it will add everything in war HI3-Author.war, created in hi3-authorenv/target folder.
6. We can now deploy the project by accessing admin console of local server using credetenials username "admin" and password "test". And deploying the war created in previous step.
7. Following steps need to be done in order to configure Postgresql database with HyperImage:

   1. Go to Glassfish adminconsole by hitting url http://localhost:4848

   2. Create new connection pool by going to Resources > JDBC > JDBC Connection Pools, and click "New" button.

   3. Set pool name "HIEditor_ORM_PostgreSQLPool"

   4. Select Resource Type "javax.sql.DataSource"

   5. Select Database Driver Vendor "Postgresql"

   6. Set the following additional properties:

      Name	Value
      ServerName	NAME OF SERVER WHERE YOUR DATABASE IS INSTALLED
      PortNumber	PORT NUMBER WHERE DATABASE IS RUNNING
      DatabaseName	YOUR DATABASE NAME
      User	DATABASE USER
      Password	YOUR DATABASE PASSWORD

   7. Create a new JNDI Resource by going to Resources > JDBC > JDBC Resources, and click "New button"

   8. Enter JNDI name "jdbc/HIEditorORM"

   9. Select newly created pool, i-e "HIEditor_ORM_PostgreSQLPool"

   10. Click "OK" button

8. Run the server from eclipse IDE or from admin console.
9. HIImage should be accessbile at http://localhost:8080/HI3Author/

Before accessing the instance of HyperImage, make sure database server is up and running.

Enjoy using HyperImage :)

---

All rights reserved. Use is subject to terms of the Apache License, Version 2.0. See the included LICENSE file or http://www.apache.org/licenses/LICENSE-2.0.html for license details.

HyperImage 3 is currently under development (Beta state). The functionality and the function volume of the system can change until it is finalised.