Setting Up Your UI Server

From OpenIndivo Documentation Wiki

Contents 1 PHP 2 PEAR 3 PHP-Java Bridge 3.1 Installing the Bridge 3.1.1 Linux 3.1.2 Windows 3.2 Configuring PHP to run the Bridge 3.2.1 Linux 3.2.2 Windows 3.3 Confirming Your Installation

PHP

PEAR

PEAR is the PHP Extension and Application Repository, a framework and distribution system for reusable PHP components. Unless you compiled PHP with --without-pear flag, the PEAR base installation is included with PHP. For instructions on setting up the Package Manager, review the related PEAR documentation.

The Indivo UI requires three PEAR Packages in order to function.

• DB
• Log
• Config

To install these packages with all their dependencies, simply use the pear install command with the appropriate flag.

$ pear install -a DB
...
$ pear install -a Log
...
$ pear install -a Config

PHP-Java Bridge

Installing the Bridge

For a basic setup, it is easiest to deploy the PHP-Java Bridge with a standalone backend.

Linux

• The standalone Bridge can be installed with rpm.

$ rpm -i php-java-bridge-standalone-3.0.7-1.noarch.rpm

Windows

• Extract the JavaBridge archive, and then extract JavaBridge.war.
• Copy WEB-INF/lib to your PHP extensions directory (e.g. c:\php\ext) and then copy WEB-INF/cgi/java-x86-windows.dll to your PHP extensions directory. (Note that even though we're using PHP 5, we're NOT using the alternative php-5.0-java-x86-windows.dll!)
• Rename the dll to php_java.dll

Configuring PHP to run the Bridge

Linux

Find your php.ini file and open it in a text editor. Add the following lines, using appropriate directory names as apply to you.

extension_dir = "/usr/lib/php/modules"

extension=java.so

[java]
java.java_home = "/usr/java/jdk1.5.0_06"
java.java      = "/usr/java/jdk1.5.0_06/bin/java"
java.log_level = 2
java.log_file  = "/var/www/log/java-bridge.log"

Restart Apache to load the new PHP configuration.

Windows

Find your php.ini file and open it in a text editor. Add the following lines, using appropriate directory names as apply to you.

extension_dir = "C:\php\ext"

extension=php_java.dll

[java]
java.java        = "C:\Program Files\Java\jdk1.5.0_08\jre\bin\javaw"
java.java_home   = "C:\Program Files\Java\jdk1.5.0_08"
java.log_level = 2
java.log_file  = "C:\php\log\java-bridge.log"

Restart Apache to load the new PHP configuration.

Confirming Your Installation

Open phpinfo.php (included with the UI) in your browser. You should find a "java" section which notes that "java support" is "enabled" and that "java status" is "running".

If you don't see that, more advanced help may be necessary, so jump onto the PHP-Java Bridge mailing list -- the fellow in charge, Jost Boekemeier, is very prompt and very helpful.

If you see all that good stuff in phpinfo.php and the Indivo UI still doesn't work, contact the ping-users list.