OpenCoral Administration Guide
Add Machine
How to add machine here.
Add Interlocked Machine
- Connect interlock box to machine.
- 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.
- Add machine to OpenCoral's database.
- 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
- Add machine to OpenCoral
- 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:
- Network down.
- Web Server down.
- OpenCoral Server down.
- 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.