|
Classic Model: Create the new application
|
Create New Dynamic Web Application.
ASSUMPTION: You have a web servlet container (Tomcat), you
understand web development and you have Eclipse etc. |
Have you download the GalenaAdmin.warYet?
You are going to need it, so get it now! (click the link).
NOTE: The tutorial listing is just a copy of the one on the left side navigation. Also, note that the right side navigation
contains links to the JavaDoc for the Galena.jar file. This can come in handy during your learning. Also, the entire content
of this site is included in the GalenaAdmin.war file (that is why it is so big) and it will be copied to every project you
create with GAdmin, feel free to delete it by removing the 'howto' folder under the 'html' folder of your project. The reason
this is included is that this 'site' is also your default online help - The galena.jar itself is only 1.3meg.
Why am I creating a project?
The Galena Admin application is a web based IDE of sorts. It needs to be running so that it can
generate JavaCode, JavaScript and XSL files. Since you will be developing using eclipse, we will want to install the GalenaAdmin war into
your running instance of the tomcat plugin. The easiest way to get that structure built, is to create a new Dynamic Web application. Once
you have done that, installing the WAR is much easier.
From within Eclipse. If you don't know how to do this, you may not
be ready for this tutorial. (Click File->New->Other, then in the Web
folder, select Dynamic Web Application)
Add a Tomcat server to your
Eclipse environment and add the new ClassModel project to the server. Once that is done, START, then STOP the
server to insure that all the required directories are created.
Now that we have our sample application
started we now need to install the GalenaAdmin war file into your projects "Server". This will allow us to use the
GAdmin to construct screens, create new resources, etc. The best way to do this
is to simply add the GAdmin WAR file to the same Tomcat instance. This is done by copying the WAR file into
the following location;
Once installed, RESTART THE SERVER. The GAdmin will now be available to all the
projects within this workspace. Also, while my workspace name is "c:\Galena\tutorial", yours will be different,
however, the rest of the path should match somewhat closely (depending on the plug-in and webserver being used).
then continue with this section,
otherwise, you can skip to the next section.
The GalenaAdmin will detect that there is no forms database associated with it on start up. The "workq" database
is required as all the screens running under GAdmin are in this database. When the database is not found, you will
be asked if you want to create it.
and complete the setup.
http://localhost:8080/GalenaAdmin
Step 1: It is very important that you do this step correctly. You must have a "Server" in your
Eclipse IDE and it must be properly configured. Click the label circled (or Double Click the Input field) above and navigate to your project's
"Server" folder. The next two images demonstrate this. Note: Your workspace may have a different name.
Note: Your Tomcat folder name may very - but it is the only working folder so select it.
During the build of the "workq" database, a number of things will happen;
- A new Empty database named "workq" will be constructed.
- The script named /html/app/GalenaAdminDB_workq.sql is executed to build tables and data
- The "Servers" web.xml is updated with a JNDI Resource named "jdbc/workq"
- The "Servers" context.xml file is updated with a database resource named "jdbc/workq"
If you see the dialog above, all is well - but not yet complete.
Since the web, and context.xml files have
been modified from outside Eclipse, it is unaware of the change. You need to now refresh the server and
I always recommend doing a clean on the server before restarting.
Once Tomcat is
running you are ready to run GAdmin and begin configuring and building the new application.
http://localhost:8080/GalenaAdmin
NOTE:The GAdmin system comes preconfigured with a super user named 's' with a password of 's'.
Use this to logon to GAdmin.
|
|
|
|
