Web Data Technologies LLP
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 7 commits ahead, 2 commits behind sourceopen7:master.
Permalink
Failed to load latest commit information.
SpockTest/in/webdata Minor UI Changes Aug 1, 2017
WebContent/META-INF Minor UI Changes Aug 1, 2017
build Minor UI Changes Aug 1, 2017
descriptors Minor UI Changes Aug 1, 2017
docs Minor UI Changes Aug 1, 2017
grails-app Minor UI Changes Aug 1, 2017
lib Minor UI Changes Aug 1, 2017
liquibase-3.2.3 Minor UI Changes Aug 1, 2017
scripts Minor UI Changes Aug 1, 2017
sql Minor UI Changes Aug 1, 2017
src Minor UI Changes Aug 1, 2017
test Minor UI Changes Aug 1, 2017
testlibs Minor UI Changes Aug 1, 2017
web-app Minor UI Changes Aug 1, 2017
.gitignore Minor UI Changes Aug 1, 2017
CNAME Minor UI Changes Aug 1, 2017
COPYING Minor UI Changes Aug 1, 2017
README.md Minor UI Changes Aug 1, 2017
application.properties Minor UI Changes Aug 1, 2017
build.xml Minor UI Changes Aug 1, 2017
cc-build.xml Minor UI Changes Aug 1, 2017
common-releases.sh Minor UI Changes Aug 1, 2017
compile-script.sh Minor UI Changes Aug 1, 2017
enterprise.eml Minor UI Changes Aug 1, 2017
generate-hsql-scripts.sh Minor UI Changes Aug 1, 2017
jBillingSalesforce.wsdl Minor UI Changes Aug 1, 2017
jbilling-build.properties Minor UI Changes Aug 1, 2017
jbilling-db-dump Minor UI Changes Aug 1, 2017
jbilling-db-dump.sh Minor UI Changes Aug 1, 2017
lb.sh Minor UI Changes Aug 1, 2017
pom-geb-tests.xml Minor UI Changes Aug 1, 2017
pom.xml Minor UI Changes Aug 1, 2017
run-app.bat Minor UI Changes Aug 1, 2017
run-app.sh Minor UI Changes Aug 1, 2017
set-env.sh Executiona Feb 15, 2017
shutdown.sh Minor UI Changes Aug 1, 2017
startup.sh Minor UI Changes Aug 1, 2017
suretax-test.xml Minor UI Changes Aug 1, 2017
upload.xml Minor UI Changes Aug 1, 2017

README.md

jBilling

Requirements:

  • Java 8+
  • Grails 2.4.3
  • PostgreSQL 8+ (required for testing, other runtime databases are supported)

To run jBilling from source you will need to have Java 8+ and Grails 2.4.3 installed. To install grails, download version 2.4.3 from the Grails Archive and follow the installation instructions for your operating system.

Java and PostgreSQL can be downloaded an installed by visiting the vendor's websites, or in linux environments by using the package manager (apt-get or yum).

Cloning the Source Code from GitHub

Install Git.

Clone the repository from git@github.com:WebDataConsulting/billing.git

git clone git@github.com:WebDataConsulting/billing.git jB-CE-4.1.1

Configuring PostgreSQL

To run jBilling with the out-of-box reference database, you must have PostgreSQL installed and configured with a 'jbilling' user and an empty 'jbilling_test' database. The setup scripts also expect that the user will allow local connections without a password.

Edit the PostgreSQL pg_hba.conf file and change the "local" and "IPv4" localhost connection types:

# "local" is for Unix domain socket connections only
local   all         all                               trust
# IPv4 local connections:
host    all         all         127.0.0.1/32          trust

Explanation: Set up PostgreSQL to allow all local connections to the database without using a password

Restart the PostgreSQL server

sudo service postgresql restart

Connect to PostgreSQL and create the test user and database.

sudo -u postgres psql

Connect to PostgreSQL and create the test user and database.

CREATE ROLE jbilling WITH LOGIN SUPERUSER CREATEDB CREATEROLE PASSWORD 'jbilling';
CREATE DATABASE jbilling_test WITH OWNER jbilling;

Setup

JAVA_HOME -> /opt/lib/jdk1.8.0_60 or an equivalent.

GRAILS_HOME -> /opt/lib/grails-2.4.3 or equivalent.

Java and grails executables should be in your classpath.

Copy the jbilling properties file from the src directory to the root of the project

cp ./src/java/jbilling.properties .

Run the grails compile target to compile the jBilling source code, then run the prepare-test target to load the reference database and prepare all the required resources.


grails compile
grails prepare-test

The grails compile target may halt with a compiler error on some environments, running compile a second time usually resolves the issue.

Running from Source

**Windows**: ``run-app.bat``
**Linux/Mac**: ``./run-app.sh``

Logging in

Browse to


http://localhost:8080

Select "Prancing Pony" from "Child company" Credentials:

user: admin password: 123qwe

Setup with an empty database

grails compile
grails prepare-test --init

If you want to use a database that is not the standard one:

grails prepare-test -init -user= -db= -pass= -url= -driver=