Workshop-Specific Instructions

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

Create the LDM user-account

Do the following (Note: you can use "/bin/csh" instead of "/bin/bash" if you wish) :

useradd -d /data1/ldm -m -s /bin/bash ldm 
passwd ldm
New password: ************
Retype new password: ************
passwd: all authentication tokens updated successfully.

For reference, see LDM Basics: LDM user.

Create directories for data-files and LDM logfiles

Because user's home-directories aren't backed-up on the workshop computers, there is no need to perform this step. Skip it.

Edit file `/etc/services`

Do it.

Edit file `/etc/rpc`

Do it.

Edit file `/etc/syslog.conf`

Change the line

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

*.info;mail.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.*						/data1/ldm/logs/ldmd.log

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

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

Execute the commands

su - ldm
firefox &

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)

Create directories for data-files and log-files

Execute the command:

mkdir data logs

Build and Install the Distribution

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

$ cd $VDIR/src
$ make distclean
...
$ ./configure &>configure.log
$ less configure.log
$ make &>make.log
$ less make.log
$ make install &>install.log
$ less install.log
$ su
...
$ make install_setuids
...
$ exit
$ make clean
...

Vet the ldmadmin(1) configuration-file

Do the following:

If the command uname -n returns an unqualified hostname, then change the line

chop($hostname = `uname -n`);

chop($hostname = `uname -n`);
$hostname = $hostname . ".comet.ucar.edu";

Set the $pq_size variable. Because we are going to receive only the IDS|DDPLUS and NNEXRAD data-feeds, the size of the data-portion of the product-queue is
```
(1 h) * (16 MB/h + 170 MB/h)= 186 MB
	
```
Therefore, use the following statement
```
$pq_size = "186M";
	
```
Set the $pq_slots variable. Because we are going to receive only the IDS|DDPLUS and NNEXRAD data-feeds, the number of slots of the product-queue is
```
(1 h) * (16000/h + 18000/h) = 34000
	
```
Therefore, use the following statement
```
$pq_slots = "34000";
	
```

(For rates of the various feedtypes, see, for example, Thelma's data-volume summary webpage.)

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	\.comet\.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	.*	granola.comet.ucar.edu	PRIMARY
REQUEST	NNEXRAD		.*	granola.comet.ucar.edu	PRIMARY

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 pqact(1) configuration-file, etc/pqact.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.