Running PopChart Server in UNIX Compatible Environments

Inside of the bin folder on UNIX installs, you will find a script called pca.sh, which can be used to start and stop PopChart Server in place of the PopChartServer executable.

You can use the following commands from the bin folder of your PopChart installation to start, stop, restart, and check the status of PopChart Server:

Function Command

Start ./pca.sh start

Stop ./pca.sh stop

Restart ./pca.sh restart

Status ./pca.sh status

Function	Command

Start	./pca.sh start
Stop	./pca.sh stop
Restart	./pca.sh restart
Status	./pca.sh status

You can create a symbolic link to the pca.sh script in your /usr/bin directory with the command:

ln -s /usr/local/Corda/bin/pca.sh /usr/bin/pca

Replace /usr/local/Corda with the location of your PopChart installation. This will allow you to start and stop PopChart Server without having to be in the bin directory.

You can also create a symbolic link to the pca.sh script in your startup directory with the command:

ln -s /usr/local/Corda/bin/pca.sh /etc./rc3.d/S99.pca

Replace /usr/local/Corda with the location of your PopChart installation. Use rc2.d instead of rc3.d for Solaris systems. This will allow PopChart Server to start automatically with your server.

If you are having trouble with the scripts, you may need to change some values in the config/pcs.settings file. Open this file in a text editor and make sure the settings are appropriate for your system.

Notes

PopChart Server now ships with ETeks Pure Java AWT, which is enabled by default on UNIX platforms. The Pure Java AWT allows PopChart Server to generate GIF and PNG images without the use of an X Server. With some JVMs the Pure Java AWT Settings must be changed. For more information, refer to "Using the Pure Java AWT and Custom Fonts".

If you do not wish to use the Pure Java AWT on UNIX systems, PopChart Server's Java GIF and PNG renderer (AWT) requires access to an X Server or at least a Virtual Frame Buffer, which emulates an X Server.

Suggested Installation Procedure for Generic UNIX Installer

On Linux and Solaris Sparc systems we provide JRE 1.3.1 with the install. You should follow the normal installation procedure for these systems.

On all other UNIX or UNIX-like systems we provide a generic UNIX Installer. This subsection will help you install with the generic installer.

In order to run the generic UNIX installer you must already have a running JVM or JRE installed on the system, and the bin directory of your java home must (at least at installation time) be in your path.

You can tell if java is in your path by typing which java.

Many Linux distributions come with a JVM clone named Kaffe whose executable is named java. Installation on Linux systems will not work if Kaffe is your only JVM.

Installation seems to work best with a JVM from Sun®, version 1.2.2 to 1.3.1.

To install the generic UNIX installer

1. Install a JVM between versions 1.2.2 and 1.3.1 from Sun if it's available, otherwise install one provided by your vendor.

2. Download the Generic UNIX PopChart Server installation file (PCS.bin).

3. Give the file executable permissions by typing "chmod u+x PCS.bin" in your download directory.

4. Run the file from your download directory and complete the installation.

5. The installation program requires an X Display in order to run. If you do not have direct access to the computer you are installing PopChart Server on, you may be able to telnet/ssh into the server, export the display to an X Client, run the installer and complete the installation.

6. An alternative would be to install it on a local system with a similar configuration to the server (same java installation paths, operating system, and java vm installation locations) and transfer it to the server via tar and ftp.