Environmental VariablesAfter installation, you should set a few environment variables:
- LRGSHOME should be set to the complete path where LRGS was installed. Example: C:\LRGS or /usr/opt/LRGS
- DECODES_INSTALL_DIR should be set to the path where DECODES is installed (if it is installed on this machine). Since the LRGS and DECODES installations share some of the same client-side programs, this allows them coordinate.
- PATH needs to include the directory containing the ‘java’ command, and the ‘bin’ directory under the LRGS installation.
- If you have extended LRGS, you should include in CLASSPATH any Java archives that you need.
On Windows machines, you can set environment variables through the System control panel.
The path to this dialogue is: Start->Control Panel->System->Advanced Tab->Environmental Variables. The screen looks like this in Windows XP:
LRGS Application Account
You must create the first account manually.
All users require a ‘sandbox’ directory where temporary files are stored. These are sub-directories under the directory $LRGSHOME/users. So, for example, to create a user with name ‘groucho’, issue the following commands:
cd $LRGSHOME/users mkdir groucho
LRGS stores passwords in a secure file called ‘.lrgs.passwd’ in the $LRGSHOME directory. This file stores user names, roles, and a hash of the password. You should keep this file hidden so that only you can modify it.
On a Linux or Unix system, create the file as follows:
cd $LRGSHOME touch .lrgs.passwd chmod 600 .lrgs.passwd
On a Windows system, create the file as follows:
cd $LRGSHOME edit .lrgs.passwd Alt-F-S (saves file) Alt-F-X (exits edit)
Now run the utility for adding, removing, and modifying LRGS administrative users. A simple commandline utility called ‘editPasswd’ (for Edit LRGS Passwords) has been supplied for this. Start the utility by typing:
$LRGSHOME/bin/editPasswd - for Linux or Unix $LRGSHOME/bin/editPasswd.bat - for Windows
Type ‘help’ and hit ENTER for a list of supported commands. For example, to add a user named ‘groucho’ with both DDS and Administrative privileges, type:
adduser groucho ...(type the password as you are prompted) addrole groucho dds addrole groucho admin write quit
Currently the following roles are recognized:
- dds - allows the user to access read-only functions like pulling messages and status.
- admin - allows the user to access all administrative functions.
We have provided three sample configuration files in the installation for you to use. They are located in the $LRGSHOME directory.
To use these files unmodified, on a Windows system, execute these commands:
ren lrgs.conf.sample lrgs.conf ren drgsconf.xml.sample drgsconf.xml ren ddsrecv.conf.sample ddsrecv.conf
On Linux or Unix:
mv lrgs.conf.sample lrgs.conf mv drgsconf.xml.sample drgsconf.xml mv ddsrecv.conf.sample ddsrecv.conf
Chapter 5 of the Users Manual explains each of these files in detail. The samples are appropriate for a simple DOMSAT system that gets backup from Wallops. Modify the files for the settings appropriate to you.