
*************************************************************************************

JUMPER INSTALL

OVERVIEW

This is a step-by-step tutorial for installing the Jumper 2.0 Enterprise Bookmarking 
engine.

It's a very easy to use and intuitive tool for tagging content and data with keywords, 
descriptions, comments, categories, annotations, reviews, ratings, and links to other 
relevant or related data. You can quickly begin capturing your organizations knowledge 
on your Jumper Intranet server right from your own web browser.


SYSTEM REQUIREMENTS 
 
Jumper 2.0 has very minimal requirements and should work on almost any server.

Client Side:

Operating System: Any Windows, Mac or Linux 
Web Browser: Internet Explorer 5.5+ and Gecko browser (Firefox / Mozilla / Netscape) 
JavaScript: Must be enabled

Server side:

Operating System: Linux, Unix, Windows, Mac 
Web Server: Apache Web Server / IIS5 or above 
Database: MySQL 4.1 or above 
Scripting Language: PHP 4.3.0 - 5.2... 


BEFORE YOU START

Check that:

PHP is installed on your server 
MySQL is installed on your server 
If any of these are not, install these first.


INSTALLATION

Installing Jumper is quite easy. Simply follow the steps below to install Jumper manually:

1.  Download the .zip file to your local drive, extract the contents. 
    
    By default, the distribution package is in a folder called Jumper2.0.1.2, and this link will 
    be included in the URL of the bookmarking engine. For example, the default URL of the 
    bookmarking engine will be www.your_domain/jmp/, where your_domain is your domain name.
    
    You can rename the 'jmp' folder as you wish. If, for example, you rename it to 'jmptags' 
    and place it in the document root directory, the URL for knowledge base will be 
    www.your_domain/jmptags/.
    
2.  Upload jmp folder to your web space.
    
    Place it in your web-server's document root, preferably the parent directory of your 
    root web directory. For many of you, this will be the public_html directory. 
    
3.  Create a directory to store attachment files called jmp_file one level above your 
    publicly accessible root directory. i.e., above /.
    
    It should not be accessible via http (web browser).
    
4.  Move jmp_upload inside jmp. Create a directory named jmp_extra inside jmp.
    
5.  The structure of directories should look like this:
    
    - jmp_file (for uploads via "Files" module)
    - public_html (document root)
       |- jmp
           |- jmp_upload (for uploads via FCK Editor)
           |- jmp_extra
    
6.  Create an empty MySQL database to be used by Jumper, or use existing one.
    
    Ensure that you have the MySQL DB host name, as well as username and password 
    access. You can usually get/set these values via a cPanel that your host provides.
    You can either use the database that your host provides or the one that you have 
    created in the cPanel (if you have such an option). The DB user should have all 
    privileges to the DB.
    
7.  Once you are at the MySQL console, you can run the following commands:
    mysql> CREATE DATABASE [database name]
    mysql> GRANT ALL ON [database name] TO [username]@[host] IDENTIFIED BY '[password]'
    
8.  If you are installing a new version of Jumper: 
    
    Create tables using db dump file at jmp/setup/db/install.sql 
    Create an admin user using file at jmp/setup/db/create_user.sql 
    If you are upgrading from a previous version of Jumper:
    
    Use DB dump file jmp/setup/db/upgrade_from_[version]_to_[version].sql 
    Do not forget to backup old DB. 
    
9.  Configure your "jmp/admin/config.inc.php" configuration file. Enter your DB host name, 
    DB name, DB username, DB password. Save and close.
    
    If you installed Jumper in document_root/jmp/ directory
    $conf['admin_home_dir'] = '/jmp/admin/';
    $conf['client_home_dir'] = '/jmp/';
    
    If you installed Jumper in document_root directory
    $conf['admin_home_dir'] = '/admin/';
    $conf['client_home_dir'] = '/'; 
    
10. In some cases you have to configure your jmp/index.php file to set the correct path to 
    admin directory and jmp/rss.php, jmp/captcha.php files to set the correct path to jmp installation 
    directory. Normally these will work without any modifications. 
    
11. Give your "jmp/admin/cache", "jmp_upload" and "jmp_file" directory full write permissions. 
    In unix you can type "chmod 777 cache". On Windows you must go through your webserver 
    to give it write permissions 
    
12. Log into your phpMyAdmin, go to the table for Jumper, Import SQL query by browsing 
    to jmp\instal\db_install_2.0.sql. 
    
13. The public area screen will be available at www.your_domain/jmp/
    The admin area will be available at www.your_domain/jmp/admin/
    
    Login: admin
    Password: demo
    DO NOT FORGET TO CHANGE PASSWORD! 
    
14. Go to "Settings" tab to configure settings. Make sure you set correct email address at Setting -> Email.
       
15. Make sure your PHP has installed GD. As far as I understand GD should have freetype and ttf support 
    
    GD function imagettfbbox() should be available.
    
    Related to issue when /jmp/captcha.php cant show image with confirmation code.
    
    apt-cache search php5 and install php5-gd - GD module for php5
    
    apt-get install php5-gd
    
16. Read the FAQ file
     
17. Start tagging and sharing knowledge

