= VSO Software =

Many VSO packages are available as installers at http://vso1.nascom.nasa.gov/installers/ .

The complete set of VSO modules are available through anonymous CVS.

== Connecting via CVS ==

1. Install a CVS client

  In order to get the VSO Data Provider interface and code examples you should have a cvs client. If you don't you can get one at: 

  http://www.cvshome.org 

  If this is problematic for you [wiki:ContactUs let us know] and we will package up a current set for you.

2. Connect to the VSO CVS server

  a. Set the environmental variable CVSROOT to
{{{
:pserver:anonymous@solarch.tuc.noao.edu:2401/vtarc1/vso/cvsroot
}}}
older versions of CVS may require
{{{
:pserver:anonymous@solarch.tuc.noao.edu/vtarc1/vso/cvsroot
}}}
For example:
{{{
# in bash/ksh
 > export CVSROOT=:pserver:anonymous@solarch.tuc.noao.edu:2401/vtarc1/vso/cvsroot
# in csh:
 > setenv CVSROOT :pserver:anonymous@solarch.tuc.noao.edu:2401/vtarc1/vso/cvsroot
}}}

  b. login to CVS
{{{
> cvs login
}}}

  c. Hit the enter key when prompted for a password

  d. Download everything, or an individual module.
{{{
# download everything
 > cvs checkout vso
# download the 'DataProvider' inheritable
 > cvs checkout DataProvider
}}}
This will create the directory 'vso' in the current directory, and the directory structure of the modules requested.

3. Install the modules

  a. Change to the module directory
{{{
# for the DataProvider inheritable
 > cd vso/DataProviders/Inheritable/Perl
}}}

  b. Run the configuration program
{{{
 > perl Makefile.PL
}}}

  c. Build, test, and install the module.
{{{
 > make
 > make test
 > make install
}}}

  d. Read the documentation.  You may need to examine the module's README file for its full name.
{{{
# modules are installed in the 'Physics::Solar::VSO' heiarchy, but a VSO
# module may include more than one perl package

# continuing with the DataProvider example:
 > perldoc Physics::Solar::VSO::DataProvider
}}}

-----

=== Note: ===

In the case of Data Providers, it may also be worthwhile to look in the module's Examples directory, or to download some of the other VSO Data Provider code to use as a reference:

{{{
 > cvs checkout NSO
 > cvs checkout OVRO
 > cvs checkout SDAC
 > cvs checkout SHA
 > cvs checkout NGDC
}}}

Most modules also contain a README file, which contains basic information about usage, and may provide additional information that is specific to that module.

-----

If you have problems connecting via CVS, please [wiki:ContactUs contact us], and we can generate tarballs or zip files of the installers.