Chapter 3. The Long Version: Installing the Library
Prev | Part I. Installing and verifying the configuring | Next

## Chapter 3. The Long Version: Installing the Library

What you will learn in this chapter. You will learn in detail how to configure and setup an environment to be able to run the JpGraph library. The chapter will explain all configuration necessary in great details and will also list some more extensive trouble shooting steps if you encounter problems trying to get the library running. The only assumption is that you have a working PHP installation together with your HTTP server.

## 3.1. Downloading the library

Downloading the free version

  Point the browser to `"http://www.aditus.nu/jpgraph/jpdownload.php"` and select the 3.x series if your are running PHP5 and the 1.x series if you are still running a PHP4 installation.

  ### Note

  The 1.x series of the library is no longer maintained so in case you have not yet upgraded top PHP5 you should strongly consider this.

Downloading the pro version

  1. Locate your license file that was sent to you when you purchased the library. You will need both the license number as well as the registered license mail as stated in the license. Your license information should look similar to:

         ----------------------------------------------------------
         : Your license key : JPGP-0920-1234657
         :  Name on license : A. JpGraph User
         :           E-mail : jpgraph-user@example.com
         ----------------------------------------------------------

  2. Point the browser to `http://www.aditus.nu/jpgraph/pro_login.php` and enter your licence email and key on the website.

     Figure 3.1. Pro-login dialogue on JpGraph Website

  3. Depending on your system you should now download either the 1.x or the (preferred) 3.x series. There is a choice to either download the library as a "*.zip" file or as a compressed "*.tar.gz" file (which is the preferred format in a Unix environment). Save the downloaded file to a temporary directory of your choice.

  4. [Optional] Verify your downloaded file against the given MD5 sum on the website. On a Unix system this can be done by running the md5 program and give the downloaded library as the argument.

     For example: `$>` md5 `jprgaph-3.0.0p.tar.gz`

  5. Unpack the library to a suitable directory that is in your PHP include path as is described in Section 3.3

Prev | Up | Next
2.3. Basic trouble shooting | Home | 3.2. Necessary system requirements for the library