maccslinux

These are the instruction for setting up the transport network to use with the innd news server. The guide I used can be found at http://transport.sri.com/TransportDevel/Docs/INSTALL.


1) Go to http://transport.sri.com/TransportDevel/Resources/Download and download transport-2.0.48.tar.gz. Or, if you already have this file, be sure to copy it onto the computer.


Then, in a terminal window, cd to the directory it downloaded to. Now type:

tar zxvf transport-2.0.48.tar.gz
cd transport-2.0.48
sudo /usr/sbin/adduser transport

when prompted for a password, type in the new user's password (I used "transport").


2) Type:

./configure \
--with-sitename=maccslinux \
--with-sitedesc="maccslinux, Augsburg College, MN"

Or, for remote sites, change the site name and description.


3) Type:

make
sudo make install


4) Type:

sudo update-rc.d transportd defaults


5) cd to the directory in which transport-2.0.48.tar.gz is located (~).

Then cd to this directory:

~/transport-2.0.48/support

Now type:

sudo cp S61transport /etc/init.d/transportd


6) Check the permissions on these files. Type:

cd
ls -al /opt/transport/bin/transportd

If the permissions string looks like -rwxr-xr-x then the permissions are already correct. Otherwise, type:

sudo chmod 755 /opt/transport/bin/transportd

Next, type:

ls -al /opt/transport/log/transportd.log

If the permissions string looks like -rw-rw-rw- then the permissions are already correct. Otherwise, type:

sudo chmod 666 /opt/transport/log/transportd.log

Finally, type:

ls -al /etc/init.d/transportd

If the permissions string looks like -rw-rw-rw- then the permissions are already correct. Otherwise, type:

sudo chmod 755 /etc/init.d/transportd

REBOOT


7) To check if transportd is running, type:

ps -elf | grep tranportd

or

cd /etc/init.d
./transportd status


8) If the process is running, you are ready to test everything else. Type:

cd /opt/transport/bin/
./viewlog Servermonitor

This will show that transportd has started and is running. Then type:

./transportctl status

This will show the status of transportd as "True."

Now type:

transportctl list

This should list the group called SeverMonitor

If not, wait a few minutes and try again.
Once ServerMonitor shows up as a group, type:

transportctl list ServerMonitor

It will display the processes running within ServerMonitor (namely Watchdog and ResourceMonitor).

Now you are finished and ready to use the transport network!

cd /lib/udev/devices

sudo ln -s /dev/ttyS1 gps0.

import serial

gps = serial.Serial(1) # Connects to /dev/ttyS1 at 9600, could use serial.Serial('/dev/gps0',19200)

gps.open()

gps.write("$PASHS,SPD,A,4\r\n")

In order to set the computer's timezone to UTC, invoke tzselect, and tell it to set the raw timezone with "GMT-0"

The clock should be set close to the correct time so that ntp will correct it. This can be done with the date command:

sudo date 072916482008.20

which is in the format mmddHHMMyyyy.SS.

In order to start and stop the ntp service, use "/etc/init.d/ntp stop" (or start, or nothing to get a list of options). One may want to do this in order to free up /dev/gps0 to talk to the gps directly.

These setup instructions are derived from http://transport.sri.com/TransportDevel/Docs/INSTALL. Some steps, however, are modified for Ubuntu.

1. Using the following packages: exim4, exim4-base, exim4-config, exim4-daemon-light, inn2, inn2-news, libdb4.4
With an internet connection, you can just type

sudo apt-get install inn2

The installation of inn2 will fail with a message like.

innconfval: hostname does not resolve or domain not set in inn.conf

So you'll need to edit /etc/news/inn.conf, and change the line

#domain:

to

domain: <computer's name>

where <computer's name> is the name you gave the computer during Ubuntu setup. For example:
domain: maccslinux1

After saving, reinstall inn2.



2. Change the following lines in /etc/news/inn.conf:

organization: "Maccs Transport Network"
maxartsize: 50000000
localmaxartsize: 50000000

Add these lines to /etc/news/readers.conf:

# Allow access to the transport groups

auth "transport" {
hosts: "meteor.sri.com, 192.101.148.*, *.sri.com"
default: "<transport>"
}

access "transport" {
users: "<transport>"
newsgroups: "*"
}

and change

access "localhost" {
users: "<localhost>"
news groups: "*"
access: RPA
}

to

access "localhost" {
users: "<localhost>"
news groups: "*"
access: RPAN
}

3. In /etc/news/storage.conf, change

method tradspool {
class: 0
newsgroups: *
}

to

method tradspool {
class: 1
newsgroups: *
}

4. In /etc/news/control.ctl, change the default newgroup/rmgroup action to log:

newgroup:*:*:log=newgroup
rmgroup:*:*:log=rmgroup

Then add these lines following the defaults:

## Added for Data Transport Network
newgroup:*:transport.*:doit=newgroup
rmgroup:*:transport.*:doit=rmgroup

5. In /etc/news/expire.ctl, change the line

*:A:1:10:never

to

*:A:1:2:never

6. In /etc/syslog.conf, change the line

news.notice -/var/log/news/news.notice

to

news.=notice /var/log/news/news.notice

REBOOT.

7. Type the following commands:

cd /usr/lib/news/bin
sudo -u news ./makehistory
sudo -u news ./makedbz -i -o
sudo chown news:news /var/lib/news/history.*
sudo chown news:news /var/spool/news/tradspool.map

8. Create a new file called /etc/event.d/inn2 and type the following in it:

start on runlevel 2
start on runlevel 3
start on runlevel 4
start on runlevel 5

stop on runlevel 0
stop on runlevel 1
stop on runlevel 6

respawn
exec /usr/lib/news/bin/innd

REBOOT. Then type the command

top -b

followed by

<CTRL-C>

If innd is in the list, everything up until now is working. Otherwise start over.

9. The last part of setup (part I) is connecting to the server. Type:

telnet localhost 119

it should respond with:

Trying 127.0.0.1...
Connected to localhost.localdomain.
Escape character is '^]'.
200 meteor.sri.com InterNetNews server INN 2.3.1 ready

Then type:

LIST

it should respond with:

215
control 0000000000 0000000001 n
control.cancel 0000000000 0000000001 n
control.checkgroups 0000000000 0000000001 n
control.newgroup 0000000000 0000000001 n
control.rmgroup 0000000000 0000000001 n
junk 0000000000 0000000001 n
.

Then type:

QUIT

it should respond with

205 .
Connection closed by foreign host.


10. Type the following commands:

cd /usr/lib/news/bin
sudo ./ctlinnd changegroup control y
sudo ./ctlinnd changegroup control.cancel y
sudo ./ctlinnd changegroup control.checkgroups y
sudo ./ctlinnd changegroup control.newgroup y
sudo ./ctlinnd changegroup control.rmgroup y
cd
sudo ctlinnd perl n

Then type:

cat /var/log/news/news.notice

You should get back the start of a log file showing that you are connecting to the server.

To communicate with the GPS cards, be sure to have the follwoing packages installed on Ubuntu:


- python ($ sudo apt-get install python)

- pyserial (from http://sourceforge.net/project/showfiles.php?group_id=46487)


Then install the scripts gpsShow.py and gpsSetup.py. From the terminal window, sudo either command, and run through the program to communicate with the GPS. Upon starting either program, be sure to know the device placement of the card (a.k.a. which serial port it is plugged in to) in the form '/dev/ttySx' where x is a number 0-4. If you write '/dev/tty0', the script will try to communicate with the first port possible. In most cases, the GPS will be '/dev/ttyS0'.

Before booting, be sure to configure the hardware in the computer as follows:

Plug modem into an open pci slot and insert the telephone wire into the slot on the modem labeled "line."

For an internal GPS card, plug the card into an empty pci (or isa) slot. Plug the serial output cable into serial port B on the back of the computer. If there is a usb cable, plug it into an empty usb slot.

For an external GPS, plug the serial output cable into serial port B on the back of the computer. Plug the usb cable into an open usb port.

Boot the computer. Enter BIOS, and set the boot order to boot from the cd drive before booting from the hard drive.
Also, in the power menu, change the setting for "After Power Loss:" to "[Power On]"
Insert the Ubuntu Install Disk into the cd drive. Save and Quit BIOS.

Follow the prompts from the install disk to successfully install Ubuntu.