Changes between Version 97 and Version 98 of DeveloperInstructions

Timestamp:

07/16/14 12:13:46 (10 years ago)

Author:

Vangel Ajanovski

Comment:

—

DeveloperInstructions

@@ -172 +172 @@
 This will enable a test login to the system, whereas the username is anything you need, and the password is the same as the username.
 
-=== Running the application from Eclipse ===
+=== Create a Run Configuration in Eclipse ===
 
 Run -> Run Configurations  , then in the maven section right click then New, use any Name you like (for example '''start isis'''), Base Directory -> ${workspace_loc:/isis} , Goals -> '''clean jetty:run'''
@@ -185 +185 @@
 [[Image(10.jpg)]]
 
-Click on Run and the application will begin to build.
+=== Starting the application ===
+
+Open the Run Configuration and click on Run and the application will begin to build.
 
 Note that on the first run, Maven will try to download all required libraries for runtime from the Internet and setup the library paths for all dependencies. This can take a very long time if your connection is not fast. On subsequent runs, this will not happen, as Maven only checks for updates. If you want to speed up the process, after everything has been run without problems at least once, you should check the parameter '''Offline''' in the Maven parameters for that run configuration.
 
-If everything is OK you will see in the console log that the system listens on port 8081 (Jetty on 8081)
-
-So open 
-http://localhost:8081/upisi
-in your browser
-
-'''Note:'''
-- in log4j.properties in the application folder src/main/resources one should change the line 
+If everything is OK you will see this in the end:
+{{{
+[INFO] Started SelectChannelConnector@0.0.0.0:8081
+[INFO] Started Jetty Server
+}}}
+
+This means that the appliation was built successfully and that even the web server started successfully. For testing purposes an internal Jetty web server was downloaded and automatically setup to run on port 8081. This might change in the future.
+
+You should inspect the starting logs and find lines starting with ERROR: message. Such messages are important and should be dealt with until there are no such messages. Stop the application via the stop configuration that you have created and fix the problems. Do this until you fix all such errors before continuing. Usually errors at first run can be related to database permission issues.
+
+When there are no ERRORS: open http://localhost:8081/upisi in your browser, and log in with any user you wish. As mentioned just put the username in the password again and it will be OK.
+
+== Logging ''
+
+In log4j.properties in the application folder src/main/resources one should change the line 
+
 log4j.appender.R.File=/upisi.log or 
 log4j.appender.R.File=/home/username/upisi.log 
-or a location where the user running eclipse has write permission and where the logs should reside.
+
+or to a location where the user that is running eclipse has write permission and where the logs should reside.
 
 [[wiki:WikiStart Back]]