Installation

 

SVA is a JAVA program, designed to run on a LINUX platform with a 64-bit JAVA environment installed. SVA was designed to be a LINUX desktop software tool.

Please follow these steps in installing SVA:

(1) If you receive SVA release in a compressed package, decompress it to a directory. This can be done by (for a bz2 package):

tar -xvjf SVA.bz2

 

(2) Copy the whole decompressed SVA package to your desired installation directory [YOUR SVA DIR].

(3) There is a SequenceVariantAnalyzer.sh script in the SVA package. This file has only two lines of scripts in it:

cd [SVR DIR] java -jar SequenceVariantAnalyzer.jar

 

Replace the " [SVR DIR]" with your installation directory [YOUR SVA DIR].

(4) Make this script executable:

chmod +x SequenceVariantAnalyzer.sh

 

(5) Now you should be able to run the graphial user interface (GUI) of SVA:

./SequenceVariantAnalyzer.sh

 

The following steps (6)-(8) are regarding the setup for a command-line tool released with SVA version 1.01 and onwards.

(6) There is a svacmd.sh script in the SVA package. This file starts like this:

#!/bin/sh #Please insert your SVA INSTALLTION DIRECTORY below cd [YOUR SVA INSTALLATION DIRECTORY] if [ "$#" -gt "0" ]; then echo $1 | grep [^0-9] > /dev/null 2>&1 ... ...

Replace the " [YOUR SVA INSTALLATION DIRECTORY]" with your installation directory [YOUR SVA DIR].

(7) Make this script executable:

chmod +x svacmd.sh

(8) Now you should be able to run the command line tool of SVA:

[YOUR SVA DIR]/svacmd.sh 30000 [The Absolute/Canonical path of your .gsap project file]

The command line tool takes two parameters: 1. The amount of memory (RAM) you would like to allocate to SVA in megabytes (MB), and 2. The absolute, or canonical path of your SVA .gsap project file. You can create your .gsap project by copying and modifying the example project file.

It is very important to use the absolute, or canonical path of your SVA .gsap project file as the second parameter. The absolute path must start from the root (/), for example, '/user/MyName/Work/MyFile.gsap'. This is true even you are currently at your working directory and a relative path './[your file]' works for other programs. The SVA command line tool only recognizes the absolute, or canonical path of your SVA .gsap project file.

There is a more detailed instruction on how to use this command line tool here.

(9) There is a tmp directory under the installation directory [YOUR SVA DIR]: [YOUR SVA DIR]/tmp

Please make sure that the SVA user has write permission to this directory for its normal functioning.

[Notes]:

1. As you can see from this process, SVA needs to start from its installation directory. - This merely was set for consistence with earlier behaviors of JAVA programs on a Mac.

2. You can easily set up a desktop shortcut for starting SVA. Here is an example. Again, you need to replace the " [SVR DIR]" with your installation directory [YOUR SVA DIR].

3. If you access using X server from a Windows PC, you need to follow the instructions of your X server to establish the X connection first.