Documentation

How To Compile

There are two approaches to compiling the application. You can either use Apache Netbeans or you can use ANT. Note: You can only adjust the form layouts with Apache Netbeans. If you are adjusting anything other than form layout, ANT or Netbeans is fine.

Using Apache Netbeans

To use Netbeans, you will first need to download the Netbeans IDE (version 12 or higher). Once you have Netbeans installed, the following steps can be used to compile BlueSeer and bring up a test instance of the application :

• 1. Download the blueseer source from github. You can either 'git clone https://github.com/BlueSeerERP/blueseer.git' or download the zipped version of Blueseer from github.com/BlueseerERP and extract the contents into a directory called 'blueseer').
• 2. Open a command prompt and cd to the install directory 'blueseer/test'. This will be your working/testing directory
• 3. Type './refresh.bat' or ('./refresh.sh' for linux) to establish a test instance of the blueseer application along with the bs.cfg file and database instance
• 4. Start Netbeans and choose 'Open Project' to open the blueseer project files.
• 5. Right click on the blueseer project and go to Project Properties
• 6. Click on the 'run' portion of the properties and set the working directory to the 'test' directory where the instance config files and data directories are located.
• 7. You should now be able to build and run the application. The default login credentials are 'admin' and 'admin' respectively.

Using Ant

To use Ant, you will first need to download the Ant build tool. Once you have Ant installed, the following steps can be used to compile BlueSeer and bring up a test instance of the application :

• 1. Download the blueseer source from github. You can either 'git clone https://github.com/BlueSeerERP/blueseer.git' or download the zipped version of Blueseer from github.com/BlueseerERP and extract the contents into a directory called 'blueseer').
• 2. Type 'ant -version' to confirm you have ant installed.
• 3. Open a command prompt and cd to the install directory 'blueseer/test'. This will be your working/testing directory
• 4. Type 'ant main' at the command prompt (there is a build.xml file in the blueseer/test directory). This will compile and create a blueseer.jar file in 'blueseer/test' directory
• 5. Type './refresh.bat' or ('./refresh.sh' for linux) to establish a test instance of the blueseer application along with the bs.cfg file and database instance
• 6. Type 'ant run' to execute the application. The default login credentials are 'admin' and 'admin' respectively.