Microsystems Technology Laboratories > OpenCoral
 

OpenCoral Administration Guide

Add Machine

How to add machine here.

Add Interlocked Machine

  1. Connect interlock box to machine.
  2. Connect interlock box to equipment controller server. The equipment controller server have controller cards that goes to network patch boards. Check for available ports and connect these two using RJ-11 to RJ-45 cable. Then patch from the computer room to whatever location using regular RJ-45 network cable. Connect the interlock box to the wall ports using RJ-11 to RJ-45 cable. Finally, test the connection using the test scripts on the equipment controller server.
  3. Add machine to OpenCoral's database.
  4. Add machine to OpenCoral's Run Manager.

To test the connection, log into OpenCoral equipment controller server.

# su - eqcsys
$ cd /usr/local/eqc
$ bin/test_labeqc test-newbox.txt

The test-newbox.txt file should look something like this.

# OpenCoral Equipment Controller communication port
PORT: 300, 301
# AUTO: [cardnumber], [channelnumber], [action]
#       action of 1 is turn on
#       action of 2 is turn off
# DELAY: [milliseconds]
AUTO: 2, 10, 2
DELAY: 3000
AUTO: 2, 10, 1

Add Non-Interlocked Machine

  1. Add machine to OpenCoral
  2. Add machine to OpenCoral's Run Manager.

When OpenCoral is not working

OpenCoral relies on many different elements (network, coral server, equipment controller) to be fully functional. This section of the guide will present a step-by-step investigation and solution when OpenCoral stops working.

Unable to connect to Admin Manager

Error

When a user tries to start Local or Remote OpenCoral Client, the error message "Unable to connect to Admin Manager" is displayed for three times and then the client exits.

Diagnostic and Resolution

This means the OpenCoral client cannot contact the OpenCoral Admin Manager. This could be the result of the following events:

  1. Network down.
  2. Web Server down.
  3. OpenCoral Server down.
  4. Database Server down.

Check network avaliability and also name resolution ability for the client. If network is okay, make sure OpenCoral web server is running. If web server is having trouble, clients cannot retrieve the appropriate IOR to contact the OpenCoral Admin Manager. Lastly, if check the OpenCoral Server log. Check for any error messages in /usr/local/coral/logs/admmgr.log.

If the problem will take a while to resolve, first make sure that fab user's work will not be interrupted. Use the Equipment Controller script to turn on all interlock boxes. Create a file enable-all.txt that looks like the following: (Your file will look different depending how many interlock boxes you have)

PORT: 300, 301
AUTO: 0, 1, 1
DELAY: 100
AUTO: 0, 2, 1
DELAY: 100
AUTO: 0, 3, 1
DELAY: 100
AUTO: 0, 4, 1
DELAY: 100
AUTO: 0, 5, 1
DELAY: 100

Now goto your equipment controller server and do the following:

# su - eqcsys
$ cd /usr/local/eqc
$ bin/test_labeqc enable-all.txt

When the problems have been resolved, restart OpenCoral servers and notify fab staff to resync the interlock box status with OpenCoral.

Hardware Mgr Error.

Error

When a user tries to turn on or turn off an interlocked machine, the error message Hardware Mgr Error. Please contact lab staff is displayed.

Diagnostic and Resolution

If this occures to all current OpenCoral users, it is most likely to be the network or that the Hardware Manager is down. Check network avaliability from the OpenCoral server to the Equipment Controller server. Next check OpenCoral server log. Check for any error message in /usr/local/coral/logs/hwrmgr.log. When the network problems have been resolved, restart OpenCoral server.

If this occures only to a particular interlocked machine or a particular set of machines, it is most likely to be a bad hardware manager configuration, or a bad interlock box, or a bad equipment controller card. Check that the machine's card channel and port number are really what is connected to the interlock box. Next check if the interlock box is broken. If an interlock box is on card 2 and port 5, create the following text file:

PORT: 300, 301
AUTO: 2, 5, 1
DELAY: 10000
AUTO: 2, 5, 2

Now goto your equipment controller server and do the following:

# su - eqcsys
$ cd /usr/local/eqc
$ bin/test_labeqc enable-all.txt

The interlock box should be turned on for 10 seconds and then it should be turned off if working correctly. If not, replace the interlock box. If replacing the interlock box will take a while, you can disable interlock for this particular machine so fab users can continue working. This can be achieved by going to the database, edit the equipment table, and restarting OpenCoral server.