Workshop-Specific Instructions

The following comprises workshop-specific instructions and details for the Summer 2005 LDM Training Workshop.

Create the LDM user-account

An account for the LDM user should already exist on your workstation.

Edit file `/etc/syslog.conf`

Change the line

*.info;mail.none;news.none;authpriv.none;cron.none		/var/log/messages

*.info;mail.none;news.none;authpriv.none;cron.none;local0.none	/var/log/messages

The "local0.none" entry ensures that no LDM log-messages are written to the system logfile.

Add the line

local0.*						/usr/local/ldm/logs/ldmd.log

The "local0.*" entry ensures that LDM messages are written to the LDM logfile.

Become the LDM user in the user's home-directory

If you became root by executing the su command as the LDM user in a terminal window, then simply execute the command exit in the terminal window; otherwise, log off the computer and log in as the LDM user.

Edit the LDM user's profile-file

Depending on your user-shell, do one of the following:

bash(1): Add the following to the file .bash_profile:

export LDMHOME=$HOME
export MANPATH=$LDMHOME/man:/usr/share/man
export PATH=$LDMHOME/bin:$PATH

csh(1): Add the following to the file .cshrc:

setenv LDMHOME $HOME
setenv MANPATH $LDMHOME/man:/usr/share/man
set path=($LDMHOME/bin $path)

Build and Install the Distribution

Assuming standard-shell (e.g., bash(1)) syntax, then do the following:

cd $HOME/ldm-6.4.6/src
make distclean
./configure &>configure.log && make &>make.log && 
make install &>install.log && su root -c 'make install_setuids' &&
make clean

Vet the ldmadmin(1) configuration-file

From monitoring the product-queue, it is known that the following are good values for the queue parameters for receiving data-products of the feedtype IDS|DDPLUS|NNEXRAD:

Set the $pq_size variable to 200M:
```
$pq_size = "200M";
```
Set the $pq_slots variable to 50000:
```
$pq_slots = "50000";
```

(For average rates of the various feedtypes, see, for example, the data-volume summary webpage for a computer at the UPC.)

Create directories for data-files and LDM logfiles

Execute the commands

cd
mkdir data logs

Request authorization at the upstream LDM

Add the following entry to the file $HOME/etc/ldmd.conf to allow all workshop LDM-s to obtain data from any workshop LDM:

ALLOW	ANY	^workshop[0-9]{2}\.ucar\.edu$

For reference, see LDM Basics: ldmd.conf.

Edit the LDM configuration-file, `etc/ldmd.conf`

Un-comment-out the "EXEC pqact" entry to enable local processing of received data-products.

Add the following entries to the LDM configuration file, ldmd.conf, to request the IDS|DDPLUS and NNEXRAD data-feeds:

REQUEST	IDS|DDPLUS	.*	workshop19.ucar.edu
REQUEST	NNEXRAD		.*	workshop19.ucar.edu

For reference, see LDM Basics: ldmd.conf.

Edit the `pqact` configuration-file, `etc/pqact.conf`

Because we will only process data-products of the IDS|DDPLUS data-feed, have the following entry be the only active one in the configuration-file:

IDS|DDPLUS
	^(..)(..).. .... (..)(..)
	FILE
	data/IDS_DDPLUS/\1/\2/(\3:yyyy)(\3:mm)(\3:dd)T\4.txt

Remember to start the continuation-lines with a tab character.

For reference, see LDM Basics: pqact.conf.

Edit the `scour` configuration-file, `etc/scour.conf`

Add the following line to the scour(1) configuration-file, etc/scour.conf:

data/IDS_DDPLUS 1

This will remove all files in the data directory hierarchy that are older than one day.

For reference, see LDM Basics: scour.conf.

Edit the LDM-user's `crontab(1)` file

Add the following lines via the command "crontab -e":

0 * * * * bin/ldmadmin scour >/dev/null
0 0 * * * bin/ldmadmin newlog

Ensure that the LDM is started at boot-time

We're not concerned about restarting the LDM at boot-time for this workshop. So we'll skip this step.