1 - Download and install Java 1.6   More...

2 - Download jbilling and unzip jbilling

3 - Configure jbilling: edit the file conf/jbilling.properties More...

4 - Startup Tomcat by executing: startup.sh from the 'bin' directory (use startup.bat for windows)

5 - You can now login to the example company 'Trend'. Point your browser to http://localhost:8080/billing and login with the user 'admin', password '123qwe', company id 1.

6 - Create the first company: Point your browser to http://localhost:8080/billing/signupEntity.do?action=setup

To shutdown: Do not do CTRL-C or turn off your computer. Run 'bin/shutdown.sh' (use shutdown.bat in Windows).

7 - Follow the Getting Started guide to get your billing system fully configured and operational

Additional information:

1 - Install Java

You do not need NetBeans, J2EE or the JDK, just the JRE. From jbilling 1.0.7 you need Java 1.6. If you can not use Java 1.6, download jbilling 1.0.6.

3 –Configure JBilling

The file jbilling.properties has many properties that will affect how the system runs. Most default values will be acceptable for the average user. Make sure to change internal_key to some long random string, base_dir to reflect the directory where you unzipped JBilling and the email server properties so JBilling can send emails.

You can change these properties at any time in the future. You will need to restart JBilling for the changes to take place. All the properties are described in this document

JBilling can generate your invoices in PDF format. The default design includes a logo on the top-left corner of the invoice. If you want your logo to be displayed, copy a JPG version of it to the directory resources/logos.

---

jBilling Installation FAQ

(Contributed by cocoy)

Here you can find answer to some of the most frequently ask questions about installing and running jbilling. If you have a question not answered by this page, you can use the jBilling Forums.

Contents

1. Installing jBilling

1.0 Something is not working ... what should I do?

Start by taking a loog to the server logs. These are in the file jbilling\server\default\log\server.log. Another important log file is the jbilling log file: jbilling\server\default\log\jbilling.log. If after reading these you still don't know what to do, copy the last part of these files and post a question in the forums.


1.1 Which version of Java to use?

JRE 1.4.1 and above.



1.2. Do I really need a JDK(Java Developers Kit)?

No. You can just use JRE to run jBilling. Unless you want to build from source.



1.3. Where to extract jBilling?

On windows, avoid problems with spaces in your path.
Try making the installation in c:\jbilling



2. Running and Stopping jBilling

2.1 How to start jBilling in Windows?

Change directory to your jbilling and execute bin/run.bat



2.2 How to start jBilling in Unix/Linux?

Change directory to your jbilling and exectue bin/run.sh
Make sure your file bin/run.sh has execute permission. By default it is not executable, so run 'chmod +x run.sh' from the bin directory.



2.3 I have jBilling running, now what's next?

Point your browser to http://localhost/billing/signupEntity.do?action=setup
Follow the Getting Started guide: Getting Started



2.4. How to stop jBilling in Linux/Unix?

From another terminal, cd to your jbilling directory and execute bin/shutdown.sh -S.
Note that '-S' has an upper case 'S'. Make sure file /bin/shutdown.sh has execute permission. By default it is not executable, so run 'chmod +x shutdown.sh' from the bin directory.



3. Common problems in Running jBilling

3.1 I have an Error initializing endpoint error, what does it mean?

jbilling are using several tcp ports during startup.
If any of these ports were used by another program, this error is displayed.

Use netstat command to check port status on your machines. On windows, use 'netstat -a -v -b'. You have to find out what is the application that you are running that is using a TCP port number that jbilling needs and shutdown that application.



3.2 I got an error Port already in use?

One of jbilling tcp ports is already used by another program. You can use netstat command to check port status on your machines (see previous question).



4. Common problems in running jBilling on Linux/Unix

4.1 Why do I get permission denied or either command not found when running bin/run.sh ?

Your bin/run.sh is not an executable file. Change the permission of your bin/run.sh to executable using chmod command.



4.2 I have run.sh: Missing file: /lib/tools.jar?

You can ignore this warning if you only have JRE installed. If you have JDK installed, set JAVA_HOME to point to your jdk installation directory using 'export' command.