Development Configuration Guide Using NetBeans IDE

Name: Development Configuration Guide Using NetBeans IDE
Uploaded: 2017-08-17T10:36:19+00:00
Duration: PTM30S20
Channel: Colt Appley
Description: Development Configuration Guide Using NetBeans IDE

Development Configuration Guide Using NetBeans IDE
Hipergate CRM Development Configuration Guide Using NetBeans IDE

HIPERGATE CRM Development Configuration Guide using NetBeans IDE
Prerequisites To configure your Hipergate CRM project as a developer using NetBeans IDE, you must have the following tools installed and configured in your computer machine Java Development Kit 1.6x (relative environmental variables must be configured) NetBeans IDE 6.x Hipergate CRM Application (hipergate-4.0-xx-en.zip) Please consult VOSSCom’s Hipergate CRM - User Configuration Guide to get help in downloading Hipergate CRM Application

Downloading HIPERGATE CRM Source Code Package

Go to the link Expand the latest category i.e. Currently it is Click on the arrow on the left side To expand it

Double click the link hipergate-4.0-14-src.zip
HIPERGATE CRM Development Configuration Guide using NetBeans IDE Double click the link hipergate src.zip

When the download would begin, a File Download dialogue would appear, click on Save button to download…

Save As dialogue box would be displayed Here you have to specify the File name of the download and the path where you want to save your download … with reference to the VOSS Com’s “Hipergate CRM – User Configuration Guide”, It is recommended to Download Hipergate CRM’s Source-code package at D:\Hipergate-project, where you have already saved the Hipergate CRM application package (hipergate-4.0-xx-en.zip)

Hipergate CRM Source-code Package is now downloading The time to complete the download depends on the internet speed connected to your machine …

Once Hipergate CRM source-code package has been successfully downloaded, Extract the hipergaaet-4.0-xx-src.zip file please note that your zip package must be at D:\Hipergate-Project (or any location you have used for Hipergate application)

Within the same path, create a new folder and rename it as “development”

NetBeans Web Application Project Creating a Blank
HIPERGATE CRM Development Configuration Guide using NetBeans IDE Creating a Blank NetBeans Web Application Project

once you have done all necessary setups Now start the NetBeans IDE 6.x.x application Usually the default path for starting the NetBeans is used to be Start Programs  NetBeans  NetBeans IDE 6.x.x

NetBeans IDE splash screen would be appeared for a while NetBeans IDE is loading some software configurations Please wait while NetBeans IDE completely load all it’s configurations

If you are prompted with the Start Page, within NetBeans IDE, simple close this document by using “x” cross button on the relevant tab..

Now, within the NetBeans IDE,, click on File Menu, then click on “New Project” menu item

New Project dialogue box would be displayed … Since We are working on Hipergate CRM, which is a web application, so we would be selecting the Project type accordingly,, Within New Project Dialogue box, select the category “Java Web”, and select the Projects of type “Web Application” Click on Next button to continue

Feature Finding window might appear, specially when you are using the NetBeans for the first time ….

“Name and Location” dialogue box under “New Web Application” would be displayed. Click on Browse button to specify the project location …

“Select Project Location” dialogue box would be prompted Through this dialogue box, browse to the location you already have selected for hosting your Hipergate’s development For example, I have choose D:\Hipergate-Project\Development

Now back at “Name and Location” dialogue box under “New Web Application” window, The selected Project Location would be appearing Provide the Project Name to be “Hipergate-NetBeans-Project” Click on the Next button to continue …

“Server and Settings” dialogue box would be prompted … Select the Server “Apache Tomcat 6.0.xx” to be used for Hipergate Project Change the Context Path (whatever would be the default) to /hipergate Now, click on Finish button to complete …

This would create a blank project named as “Hipergate-NetBeans-Project” Which would be having default settings and configuration files … Note: you shall DELETE the default file “index.jsp” to avoid any ambiguity

Hipergate Project Files and Directories
HIPERGATE CRM Development Configuration Guide using NetBeans IDE Copying Hipergate Project Files and Directories to the newly created NetBeans Web Application Project

Now let’s take a look at the Directory structure of “Hipergate-NetBeans-Project” This directory is containing the default files and folders, created by a NetBeans web application project …

Now copy the “storage” folder from hipergate-4.0-xx-en location And paste that “storage” folder in the \Hipergate-Project\Development location, and outside the “Hipergate-NetBeans-Project” folder …

Now copy “bin” directory from hipergate-4.0-xx-src location, and paste that “bin” folder in the \Hipergate-Project\Development location, and outside the “Hipergate-NetBeans-Project” folder …

Copy “webapp.en” directory from hipergate-4.0-xx-en location, and paste it at \Hipergate-Project\Development\Hipergate-NetBeans-Project location, which is the directory of your NetBeans Project for Hipergate

Copy “conf” directory from hipergate-4.0-xx-en location, (which would having a couple of configuration files) and paste the “conf” directory to \Hipergate-NetBeans-Project\src location This location already have a default, “conf” directory, you shall overwrite the default directory with the one, copied from Hipergate location.

Copy “java” directory from hipergate-4.0-xx-src location, (which would having the source-code java files) and paste the “java” directory to \Hipergate-NetBeans-Project\src location This location already have a default, “java” directory, you shall overwrite the default directory with the one, copied from Hipergate location.

Now having a look at the directory structure of “Hipergate-NetBeans-Project”, we have a default folder “web” which is used to be the default directory for hosting the web contents for a NetBeans Web Application Project … Whereas, the web contents for Hipergate project are within “webapp.en” directory, which we had copied in “Hipergate-NetBeans-Project” location

Back in the “Server and Settings” slide, we mentioned the “Context Path” that settings used to be saved in “\web\META-INF\context.xml” file … and paste it in Hipergate’s “\webapp.en\META-INF” location. That directory would also be having a “context.xml” file, you shall replace that default file with “context.xml” copied from “\web\META-INF”

DELETE the default “web” folder from “\Hipergate-NetBeans-Project” location

Rename the “webapp.en” folder (which was copied from Hipergate application directory) to “web” … as it is already mentioned that “web” is the default folder to contain the web contents for a NetBean’s Web Application … So, now we have Hipergate web content in a default named folder “web”

Now open NetBeans IDE, and there, you can see that we have successfully deployed / copied the web contents of Hipergate project into the NetBeans web application project, “Hipergate-NetBeans-Project” …

Java source code packages are also within the default “Source Package” directory structure of NetBeans Project … Here, you can see that a few Packages are marked with Red dots. This is because these Packages would be having some Kind of problem (errors) in the Source code…

In this project, most of these errors are because of “import” statements within the Java code, which are trying to import the packages, which are not the part of default JDK … These are known to be external Java libraries, and are either the Custom made libraries or provided by any third party vendor …

Hipergate project contains the necessary third party Java libraries in “\web\WEB-INF\lib” and “\Development\bin\compile-libs” directory

Adding Hipergate Libraries into NetBeans Project In the NetBeans left-side Project structure view, right-click on “Libraries” and select “Add Library” option …

“Add Library” dialogue box would be prompted click on “Create” button
HIPERGATE CRM Development Configuration Guide using NetBeans IDE “Add Library” dialogue box would be prompted click on “Create” button

“Create New Library” dialogue box would be appeared, Provide the new Library Name as “HipergateCRM” and select Library Type as “Class Libraries”

“Customize Library” dialogue box would be appeared next Here you can define the library classpath for your new library … Click on “Add JAR/Folder” button

“Browse Jar/Folder” dialogue box would be displayed… as mentioned before, Hipergate Project libraries are present at “\web\WEB-INF\lib” directory,,, thus through this dialogue box, browse to this path, Select all files and folders by using “CTRL + A” And then click on “Add JAR/Folder” button to continue …

“Customize Library” dialogue box would be prompted again and it’s “Library Classpath” section contains the reference to the JAR files we had just selected in the previous step …

As mentioned above, some other library JAR files for Hipergate Project are present in “\Development\bin\compile-libs” directory … Thus we have to add those JAR files into “Library Classpath” as well … click on “Add JAR/Folder” button again

“Browse Jar/Folder” dialogue box would be displayed… as mentioned before, Hipergate Project libraries are present at “\bin\compile-libs” directory,,, thus through this dialogue box, browse to this path, Select all files and folders by using “CTRL + A” And then click on “Add JAR/Folder” button to continue …

Once, you are done with adding JAR file libraries, into your new “HipergateCRM” library,, click on OK button at “Customize Library” dialogue box

Now you can see your “HipergateCRM” library in the list of available libraries Select your “HipergateCRM” from the list and click on “Add Library” button to continue …

HipergateCRM library has been added into the NetBeans Project for Hipergate CRM…

Now as we have included the necessary java libraries into the NetBeans environment, thus resolving the “import statement” issues for Hipergate project … Please note that if the project’s Source Package section is still showing some error, it might be some syntax error in some Java Source code file … If you wouldn’t be able to solve the issue yourself, you can contact us for help regarding that issue …

Hipergate-NetBeans-Project is now ready to be used … Right click on the project, and select “Build” option

NetBeans IDE is now Building the Hipergate-NetBeans-Project In “Build” process, the NetBeans copies the web contents from Hipergate-NetBeans-Project\web into Hipergate-NetBeans-Project\build\web and compiles the Java files into the class files ….

If theirs is no problem in compiling the java files into the class files (like some kind of syntax errors in the java files) and the Build process successfully copies the web contents into the \build\web path,, it would show the “BUILD SUCCESSFUL” message

Once you have successfully Build the “Hipergate-NetBeans-Project” The project is not ready to be executed … Select the project from left-side project panel and click on RUN button from the tool bar

You can also Run the project by right-click on it and selecting “Run” option from the menu …

If NetBeans would be able to successfully execute the ‘Hipergate-NetBeans-Project’, It would prompt the default Browser to open the hipergate project web link Also, please note that this execution of Hipergate project application is hosted by NetBeans built-in Apache Tomcat web application server …

Please concern to VOSSCom’s “Hipergate CRM - User Configuration Guide” for learning how to configure a database for Hipergate CRM project and also about the Hipergate CRM setup processes … As mentioned before, when you run the Hipergate-NetBeans-Project, it would prompt the default browser with the default Hipergate project link which is But before you continue with normal usage, you shall execute the project setup,, by replacing the link to (for details on setup process, please refer to “Hipergate CRM – User Configuration Guide”)

This is a quick review of the configuration step (with some alterations, which would be explained next)

If you have also deployed the Hipergate Web application to a standalone Apache Tomcat Web Application Server, and you had used “hipergate.cnf” configuration files to save those configurations, You shall use a different configuration file for “Hipergate-NetBeans-Project”, you can select any other file name from “Select another location” dropdown box, such as in this example, I have choose “support.cnf” instead of “hipergate.cnf”

Also, the directory path’s in the Directories section should be mentioned carefully, according to the paths of “Hipergate-NetBeans-Project” Which in our case are as following Storage path: \Hipergate-Project\Development\storage WorkAreas path: \Hipergate-Project\Development\Hipergate-NetBeans-Project\build\web\workareas

Please note that if you have chosen some other file name, other than “hipergate” from “select another location” dropdown option box in “Configuration of .cnf file” step, you shall modify the dbbind.jsp file accordingly, In NetBeans environment, you can find this file at “Hipergate-NetBeans-Project  Web Pages  methods  dbbind.jsp”

For example, if you have select “Support” from “select another location” dropdown option box in “Configuration of .cnf file” step, you shall modify the dbbind.jsp file and change the class parameter to “com.knowgate.dataobjs.DBSupport” Once you have done the changes, save the file (using CTRL+S), The NetBeans IDE would automatically deploy the changes in both \web\ and \build\web\ versions of dbbind.jsp

After modifying the dbbind.jsp file, you must restart the NetBeans built-in Apache Tomcat Web Application service, by clicking on double-arrow button under Output panel’s “Hipergate-NetBeans-Project (run)” sub-panel,

Please concern to VOSSCom’s “Hipergate CRM - User Configuration Guide” for the rest of setup process for setting up Hipergate project settings … Once you are done with all the necessary settings, The Hipergate home page would be displayed again

Now, when you would press “Enter” button to login to the system to use it, You might be prompted with an error screen, saying “Unable to access binding information for class com.knowgate.hipergate.Menu Make sure the binding has been compiled ”

To resolve this issue you must post-compile “com.knowgate.hipergate.Menu” class file by using the following method … Open your command prompt and execute this command java -cp D:\Hipergate-Project\Development\Hipergate-NetBeans-Project\build\web\WEB-INF\lib\bcel.jar;D:\Hipergate-Project\Development\Hipergate-NetBeans-Project\build\web\WEB-INF\lib\jibx-bind jar;D:\Hipergate-Project\Development\Hipergate-NetBeans-Project\build\web\WEB-INF\lib\jibx-extras.jar;D:\Hipergate-Project\Development\Hipergate-NetBeans-Project\build\web\WEB-INF\lib\xpp3.jar;D:\Hipergate-Project\Development\Hipergate-NetBeans-Project\build\web\WEB-INF\classes\ org.jibx.binding.Compile D:\Hipergate-Project\Development\storage\xslt\schemas\menu-def-jixb.xml

This command would do specified classpath compilation for bcel.jar, jibx-bind jar, jibx-extras.jar and xpp3.jar at “Hipergate-NetBeans-Project\build\web\WEB-INF\lib\” path and would compile org.jibx.binding.Compile class with “\storage\xslt\schemas\menu-def-jixb.xml” parameters JiBX reads the XML definition of the menu and inserts some extra methods directly into a precompiled .class file. Blank spaces in the command

HIPERGATE CRM Once you have done this step successfully as well, Your Hipergate CRM is fully configured as a NetBeans project, and you can now use it as a web application within the NetBeans environment, or you can explore it’s source-code to participate in the development of Hipergate CRM project … In case of any ambiguity or confusion, feel free to contact the VOSS Team at the given id. p.s: your suggestions and advices to improve this tutorial series would also be highly appreciated …. Thankyou

Hipergate CRM Development Configuration Guide
Prepared by: Virtual University Open Source Software Community (VOSS Com.) VIRTUAL UNIVERSITY OF PAKISTAN

Development Configuration Guide Using NetBeans IDE

Similar presentations

Presentation on theme: "Development Configuration Guide Using NetBeans IDE"— Presentation transcript:

Similar presentations

About project

Feedback

Log in

Auth with social network:

Development Configuration Guide Using NetBeans IDE

Similar presentations

Presentation on theme: "Development Configuration Guide Using NetBeans IDE"— Presentation transcript:

Similar presentations

About project

Feedback