A special version of awgtpman is used for the h1asc model running on h1asc0.  Because of this, the awgtpman process likely will not restart properly if the model is modified and restarted. 

If the h1asc model needs to be restarted, contact the CDS administrator staff or follow the instructions below:

1. Log on as controls to h1asc0:
me@opsws0:~$ ssh controls@h1asc0

2. Find the process ID of the currently running awgtpman for h1asc:

controls@h1asc0 ~ 0$ ps aux | grep awgtpman-2.9

3. The response should be similar to the following:

root     23365  0.1  3.1 280224 190864 ?     S  14:58   0:03 /opt/rtcds/lho/h1/target/gds/bin/awgtpman-2.9-asc-special -s h1asc -A -l /opt/rtcds/lho/h1/target/gds/awgtpman_logs/h1asc.log

4. The second field of the response is the process ID needed for the kill command, in this case 23365.  It changes each time the program runs.  Kill the process:

controls@h1asc0 ~ 0$ sudo kill -9 23365

Of course, you will use the real process ID, not the example ID shown here.

5. Restart the awgtpman for h1asc:

controls@h1asc0 ~ 0$ cd /opt/rtcds/lho/h1/target/gds/awgtpman_startup

controls@h1asc0 /opt/rtcds/lho/h1/target/gds/awgtpman_startup 0$ ./awgtpman_h1asc-new.cmd

6. There should be some text consisting of version strings that is output, and the AWG indicator on the overview screen for h1asc should turn green.

Why this is important

When the model is changed, a new mapping file is generated called tpchn_h1asc.par.  This file provides the association between testpoint channel names such as H1:ASC-AS_A_RF36_I1_ERR which dataviewer and other programs use, and channel numbers such as 32114 which the h1asc model uses.  If awgtpman is not restarted when the h1asc model is restarted, the mapping between names and channel numbers will likely be incorrect, and you may not be able to use a testpoint, or you may get the wrong data for a testpoint. 

The awgtpman for h1asc is different because a bug in the awgtpman software restricts the number of testpoints that can be opened for the model to an artificially low number.  A special version of awgtpman for h1asc was created to work around the bug until it can be fixed in a more permanent fashion.