There is a large amount of different Linux distributions with many different versions that have differences in functionality. It has to be observed that directories, etc. shown in this guide are presented as examples only. Depending on the Linux distribution in use, its version, software installations, system settings etc., each situation may differ significantly from the one presented here.
Procountor Financial management software has been implemented using Java. To be able to use Procountor, the computer must have a Java environment installed and the browser settings must enable the use of Java. We recommend the use of the latest Sun’s Java JRE version. There are also open-source Java versions, but their 100% compatibility with Sun’s Java is not guaranteed.
There are different alternatives to how you install Java. In some Linux distributions, Java comes as part of the installation. In some cases Linux/browser searches and installs Java, when the browser notices that it is required but does not exist. In some cases you can use Linux tools or an installation package for certain Linux version. The text below contains an instruction how to perform the installation manually.
Download the Java installation package in address http://java.com. In the same address you can also check if you computer already has Java.
- Click Free Java download.
- Select Linux (self-extracting file).
- Save the file e.g. on the desktop.
- Open the Terminal.
Move to use root rights using the command su and then enter the password when prompted (In Ubuntu, commands are used in format sudo <enter_command>).
- Go to the directory where you want to install Java (e.g. cd/usr/java). If needed, create a directory as desired (e.g. mkdir/usr/java).
Grant execution rights to the Java installation package that you downloaded (e.g. chmod a+x /home/<user_id>/Downloads/jre-6u24-linux-i586.bin).
Run the Java installation package (e.g. /home/<user_id>/Downloads/jre-6u24-linux-i586.bin). Accept licence terms.
- Java is being installed. When the installation completes, the directory, from which you ran the installation, contains a new subdirectory, where Java resides (e.g. /usr/java/jre1.6.0_24).
- As the next step, you have to tell the browser where to find Java:
- Go to the browser’s plugins directory (e.g. cd /usr/lib/firefox-3.0.11/plugins).
- Create a symbolic link to file libnpjp2.so (e.g. ln -s /usr/java/jre22.214.171.124/lib/i386/libnpjp2.so).
Go to the browser’s plugins directory (e.g. cd /opt/google/chrome/plugins).
If the plugins directory does not exist, you have to create it first (e.g. mkdir /opt/google/chrome/plugins).
- Create a symbolic link to file libnpjp2.so (e.g. ln -s /usr/java/jre1.6.0_24/lib/i386/libnpjp2.so).
- In older Java versions (before 1.6.0_10) to file ns7/libjavaplugin_oji.so (e.g. ln s /usr/java/jre1.6.0_10/plugin/i386/ns7/libjavaplugin_oji.so).
Start the browser and check Java functionality (e.g. in address http://java.com or in Firefox by entering about:plugins in the browser’s address field).
Java Control Panel
In the Java Control Panel, adjust Java settings. e.g visibility of Java console, clearing Java cache and the amount of memory allocated by Java.
Depending on the Linux distribution and Java installation method, Java Control Panel can be found in the user interface menu (e.g. System/Preferences/Sun Java 6 Plugin Control Panel), but if this is not the case, you have to search the Control Panel. The Control Panel can be found in the bin directory under Java installation directory (e.g. /usr/java/jre1.6.0_24/bin) by the name ControlPanel or jcontrol. If you do not know in which directory Java has been installed or Java Control Panel cannot be found in the directory mentioned above, you can search it using the file search function either by name ControlPanel or by name jcontrol.
Java Control Panel can be opened by running ControlPanel or jcontrol. If several Java installations are found in the computer, you have to check which of them is used by the browser, and if necessary make the changes described below in the Java Control Panel used by the browser or in all Java Control Panels found in the computer. Java Control Panel opens in a window with 4 tabs General, Java, Security and Advanced.
Visibility of the Java console
Java console is the place where all information is sent regarding possible errors in the functionality of Procountor financial management software in the user’s computer. The information in the Console can be copied and emailed to Procountor for analysis. There is no better way to get information on errors in the user’s computer.
You can open Java console always when Java starts by opening Java Control Panel and changing the Java console settings. The setting can be found in Java Control Panel’s Advanced tab, in section Java Console. When you select Show Console, Java Console is opened every time, when Procountor is started.
Clearing Java cache
It is possible that “stuff” from previous Procountor sessions may remain in the Java cache. This may cause problems in using Procountor, especially when Procountor has been updated to a newer version.
To clear the Java cache, go to Java Control Panel’s General tab and open the Temporary Internet Files section. Use the Settings button to open the Temporary Files Settings window and clear the cache by the Delete files button. Accept the opened Delete Temporary Files window by clicking the OK button to clear the cache.
If you do not want Java to keep temporary files, remove the tick from the option “Keep temporary files on my computer” in the “Temporary Files Settings” window. However, this may make use of Procountor slower, because all program code always has to be downloaded from the server.
After clearing the Java cache, you should also close all browsers to clear the cache of the browsers.
Adjusting the amount of memory allocated by Java
If Procountor notifies you that the Java environment memory is full, you can increase the maximum amount of memory allocated to Java. Memory being full can also be signified byjamming in certain functions in a prolonged Procountor session.
To increase the maximum amount of memory used by Java, open the Java Control Panel, go to tab Java, go to section Java Applet Runtime Settings, click the View button. In the opened window, in Java Runtime Parameters column enter e.g. -Xmx128M (you can provide an even higher value). To activate the setting, you must close and restart the browser.