Directions for Installing jMetrik on Linux (July 7, 2011)


These directions are based on Ubuntu 11.04

One of the best features of Linux is its high level of security and precisise management of user permissions. However, this feature also complicates the process of installing software on a Linux machine. The following directions were tested on Ubuntu 11.04 but they should also work for other Linux distributions. The first steps is to download the Linux installer file. As of this writing, the installer file is named jmetrik_unix_2_0.sh. The directions below assume that a user named "patrick" (without the quotes) already exists on the system. In the directions that follow, replace the word "patrick" with your username. Note that Linux commands and user names are case sensitive. Commands to by typed in a terminal are shown in bold font.

The easiest way to install jMetrik on a Linux machine is to intall the software to a user's home directory. Copy the installer file to the home directory for patrick (i.e. /home/patrick). Open a terminal and type the following: sh /home/patrick/jmetrik_unix_2_0.sh. The installer should begin the installation process. Follow the directions and be sure to install jmetrik to a folder in the user's home directory: "/home/patrick/jmetrik". If given the option, do not create a symlink.

It is usually not desirable to install an application to the home directory. A better location is /usr/local. However, installing an application to this location requires more work and more familiarity with Linux because of the permissions that must be set. The following step-by-step instructions work successfully on Ubuntu 11.04. Again, a user "patrick" is assumed to exist. Replace this user name with your own in the directions that follow. The installation file is assumed to be in your home folder (e.g. /home/patrick). First, open a terminal.

  1. Create a group called jmetrik by typing: sudo groupadd jmetrik. You will be prompted for a password. Provide it.
  2. Add the user "patrick" to the group you just created: sudo usermod -G jmetrik patrick. You can check to see if you were successful by typing: id patrick. You should see the group "jmetrik" listed for the user "patrick".
  3. Create a folder called "jmetrik" in /usr/local by typing: sudo mkdir /usr/local/jmetrik
  4. Add the jmetrik group to /usr/local/jmetrik: sudo chown root.jmetrik /usr/local/jmetrik
  5. Give jmetrik read and write permissions on this new folder: sudo chmod 774 /usr/local/jmetrik
  6. Run the jmetrik installer: sh /home/patrick/jmetrik_unix_2_0.sh. Choose to install jmetrik to "usr/local/jmetrik". Be sure that you DO NOT install to "/usr/local/jmetrik/jmetrik"! The installer program will add the extra "/jmetrik." You can easily delete the extra "/jmetrik".
  7. After clicking "Next", you will be prompted "Select Directory for Symlinks." Click the box that reads "Don't create symlinks" and click "next" to begin the installation.

You should be able to run jmetrik with no problems after follwing these steps. Please contact support if you have any problems, support@itemanalysis.com. There may be other way to configure the permissions but these steps seem to work fine.