CISN Display

From Stadm
Jump to navigationJump to search

Summary of What we want in the ICSN/WaveForm Display 2008-11-19

This project started in the 2007-2008 school year with Mekhin desgining the program itself. He graduated that year and so I have been wokring on it this year. My part hasn't been in the programming, but instead the documentation and physical set-up. The CISN/Waveform Display is a project by NEES which is a subset of ICS. The CISN portion will show near real-time earthquake activity, while the Wavefom display will show real time seismic waves at various location around California.The set up should explain about both the displays, ICS, and possibly NEES. NOTE: It maybe wise to look into using launchd or launchctl for keeping the display running and starting on boot


This is the Original documentation on all all CISN/ Waveform Disply Information
This is Mehkin's Original hand written notebook about his work on the project

Current Status of Production

Current Status Summary 08/11/17

Display Stand: done

  • Can hold one or two screens as neccesary, built by nick webster in the Geology Machine shop. (Document the building!) To see the Documentation of the Display Stand click this link.

CISN Kiosk Mode: done

  • Mekhin did this (mostly) but I had to do some refining

Documentation of how to create CISN in Kiosk Mode: done

  • Mekhin left documentation concerning all he did, but much of it is unclear, especially to those (like me) with little computer experience. I am reading it now, putting it in accesible language, while attempting to install it on the computer, "ruby" NEW: Am working on a shell script to automate quit finder, will also kill dock, works well.
  • The only thing left to do for this is create a launchd script which:
    • starts CISN Display running coninuously
    • Kills finder while! CISN is loading (otherwise it doesnt stay dead)
    • restarts the dispaly every night to make sure windows aren't screwed up

Waveform Display Program: undone

  • We need to meet with Jamie and see how antelope works
  • Some questions/concerns
    • How do we lock users out of messing with the controls
    • We need to document its install process
    • Ask Aaron where to put in the

CISN/WAVEFORM Display (Physically): undone BUT the Temps is up

  • I have designed a layout to go around the screen which contains information about the Kiosk. However, this must be approved by Jamie, and he must provide me with the information to insert. I have completed many of the info sections, I emailed Jamie and I need to get info on the UCSB Eq site, the Northridge EQ site and the program antelope so I can write thier blurbs.

Touchpad for the Kiosk: done

  • indent we have a nice touchpad mouse, but we have to...
  • joe built us a nice trackpad holder, I need to document it's desgin. it cost about 300 bucks

How to Create the CISN/Waveforms Display

You have the option of simply following the directions one at a time, or if you are in the middle of an install, jumping from section to section with the links below.

  1. Reformat the disk of the Mac and install Tiger OS, disk name: CISN-display
    1. Obtain the tiger instal cd's from Aaron
    2. Insert Disk 1 into the desired computer
    3. Remember, this will delete any information on this computer, so make sure there is nothing you need on it.
    4. It will bring up a window, click the "install Tiger" icon, then click restart
    5. Choose english as the main language, then click continue until the select destination page
    6. there, click options and select "Erase and Install" and make sure you have the "Format disk as:" section selected as "Mac OS Exteneded" click continue
    7. On the installation type page select options, select the customize button and click the "X11" icon
    8. Continue and let it install.
    9. After install, go to the apple icon in the top left corner and select check for updates, let all the updates install.
    10. Go to the finder, search and find system preferences
    11. Click "sharing"
    12. turn on "remote login" and turn on "remote Managment" under the "services" section
    13. go back to the system preferences main screen, click on energy saver
    14. Click schedule in the bottom right corner
    15. Check the start and wake up time and set it at every day at 7:00AM
    16. Set the option to sleep on bottom set and check it. Set at everyday at 10:00PM
  2. Install "X-code Developer Tools"
    1. Ask Aaron to bring in X Code-Developer tools from off the server, its not on the install disk, at least the one he gave me (4/3/2009)
  3. Here we must set up three different accounts
    1. create two admin accounts, "Administrator" which you will have Aaron come and make the password, and "cisnadmin" which you should put the password at "1" for now
    2. then create a user account named "cisndisplay"
    3. I think it is best to do all operations via the cisndisplay account, this may take longer due to repeated password typing but it will ensure that cisndisplay has access to all installed things.
  4. Go online to the CISN website and install the CISN display
    1. click on the Cisn display icon on the top left area
    2. Click "Mantain your Account"
    3. Username: *********** Password: ***********
    4. Click "Cisn display client software"
    5. under installation options click, "interactive cross-platform installer programs"
    6. the program requires java 1.4 or later, therefore click the apple icon in the top left corner of your desktop and click "software update." Insall all neccesary updates
    7. download the MAC version by clicking on it, dragging from the download menu to the desktop, then double click on it. (if it requests applet approval click "trust")
    8. Keep clicking next, let it install where it wants to, let it put all the files on its default settings.
    9. exit the program
    10. download this image for a NEES banner
    11. go to finder and search for the folder "banners", then put the nees banner in there. (this displays an image of the nees banner in the cisn program)
  5. Next go Install Antelope. It isn't essential to do this now, but the system will start to get configured with the Fruitmenu, etc., so its best to Install Antelope now
    1. Put in the Antelope Disc and click its image when it appears on the Desktop
    2. Click on the Install.
    3. It will request an information form which can be ignored
    4. Continue through, select "full distribution" when the option arises
    5. Install all unapplied patches
    6. Set up defualt values for the network
      • Seed Net: SB
      • Int: UCSB
      • Orig Net:Institute of Crustal Studies
      • Mail Dom: crustal.ucsb.edu
      • Mail host: mail.crustal.ucsb.edu
    7. Stick license in ..WHERE? ASK AARON
  6. Setting up launchd so it runs the CISN display (NOTE: This is now unneccesary as we restart it with a cron job. The code is commented out for this but still in the file accesible via jedit)
  7. Configure CISN Display to its appropriate settings
    1. Here is the config file. Save this to the desktop under the exact name (make sure it doesnt have ".xml.txt" or something)
    2. then use the finder to open the folder "conf" and delete the old conf file, then put in the new one from the desktop.
    3. Next click on the finder and selcet from the top options "new window"
    4. click on documents in the side panel and create a new folder called insdie it called "BackupConf"
    5. copy and paste a copy of the new conf file into this folder
    6. Go to where CISN is installed
    7. right click on the executable icon (the icon which when pressed makes CISN run) and select "show package contents"
    8. click on contents, then click on info.plist. (it should be opened with the property list editor)
    9. click once on the "root" art, then click on the arrow to its left and select new child in the top right corner
    10. here are its variables
      • name: LSUIPresentationMode
      • class: number
      • value: 3
    11. exit out of that and save the changes
    12. I am unclear how to do this via the conf file so for now it can be done manually, but you need to launch cisndisplay
    13. go to settings, then diplay, then at the reset view option enter 60 seconds
    14. simply exit out of the program without saving.
  8. Begin Install of the Firewall by copying this code for the Firewall and this code for the Firewall's startup parameters onto the Desktop by right clicking (or control+clicking) on the links, and selecting "Save Linked File as..." It will try to end".txt" to the end or something of that nature, delete that part and keep the orignal names
    1. You need to create a folder, "Firewall", inside the StartupItems folder. To do this...
    2. Open up the "Terminal" Icon on the bottom menu
    3. Type " sudo bash ", then enter the admin password
    4. Type " sudo mkdir /Library/StartupItems/Firewall "
    5. Go to /Library/StartupItems/Firewall and put the two files you downloaded ("Firewall" and "StartupParameters.plist") earlier into this
    6. Type " sudo chown -R root:wheel /Library/StartupItems/Firewall"
    7. Type " chown 0:0 $fwdir/* "
    8. Type " chmod ug+x $fwdir/Firewall "
    9. Type " $fwdir/Firewall " this should start the firewall and show a whole bunch on new info
  9. Here we will secure the GUI by installing the Fruitmenu and having it run forever.
    1. go to the fruitmenu website and download it.
    2. we already have a license so you dont need to buy, just download. it didnt even ask me for the info, but just in case.....
    3. go through and let it install where it wants, only install what they say is neccesary (not that crash thing).
    4. once installed go to "system preferences" (You can find this with finder) and click on the fruitmenu icon which should be in the lower left
    5. once in go to the applemenu section and drag everything, except for shutdown, from the left side over to the right. keep the program open!
    6. open finder and search for "airport admin utility", drag this from the finder menu to the left box in the applmenu table you were just at, hit apply.
    7. now you can exit out of both of those and click on the apple icon in the very top left to make sure what we did worked
    8. **we are killing the finder here** write," defaults write com.apple.Finder QuitMenuItem 1 "
    9. downlad this shellscript, cisnmaster which will be used to keep the kisok running, and this startdisplay shell script. use the finder to put them in the "bin" file.
    10. If you wish to know more about the contents of the file, click here to learn the Specifics of how it works
    11. Now we will need to make cron jobs to continuely run the scripts, first log out and log in as cisnadmin
    12. open a terminal (we are about to allow non super users to use the reboot command) type "sudo bash" it will prompt for password probably
    13. then type "chmod +s /sbin/shutdown" then type "/sbin/shutdown", and it should simply reboot so u can now sign in as cisndisplay
    14. once in as cisn display and use the finder and open up the terminal window, try the "sbuin/shutdown" command again ( to make sure it works)
    15. now , download the cisn config file to your desktop again so we can make a back which copies itself in the config file every night, create a folder under documents entitled called "BackupConf" and put it in here Back
    16. then go open the terminal again
    17. type "crontab -e" hit "a" to be able to write one the first line type "*/5 * * * * ~/bin/cisnmsater begin" then press enter on this second line type "58 23 * * * ~/bin/cisnnaster mvconf" then press enter on this third line type "59 23 * * * /sbin/shutdown -r now" then press enter
    18. then click esc, followed by "shift+z" twice
    19. in the terminal type "cd bin" enter, "./cisnmaster stop" enter. This will casue the temporary stoppage of cisn trying to consistently boot itself. Know the cisnmaster commands!
    20. exit out of the terminal and click on the CISN-Disply icon which contols the computer and is located on the desktop
    21. right click on the applications icon and selcet get info
    22. scroll down to the "owners and permission section" and change the owner to cisnadmin, you will need to use the password which is now "1"
    23. now open up the applications folder and try to delete the chess game or something unimportant, it should ask permission. Now we know it works!
    24. use the finder to open system preferences, click on the accounts icon
    25. select login items under cisn-display and select the plus button
    26. search for bin and select startdisplay.command, this will make the ./cisnmaster rmblock run on start up of the machine
    27. sign in as cisnadmin and change the password to....... you and Aaron decide, dont post it here! write it down in office somewhere
    28. I think you're all set now! lets learn how to run this computer from another computer via remote connection
  10. Here are some potentially useful links Mehkin suggested if you get stuck...

Ideas on Setting up the Trackpad

  • This is all done, all I need to do is document it. did I document it....?

Usable Controls from CISNMaster to Manipulate Program

  • remember you must have downloaded the commands first and they may not work unless all the directions above have been followed.
  1. Find out the name of your machine from aaron, the current one is "ruby" so I will use ruby here in the examples.
  2. open the terminal on your own computer and type "ssh cisndisplay@ruby.crustal.ucsb.edu" it will ask for the cisndispaly password, type 'er in!
  3. type "cd bin"
  4. type "./cisnmaster" follwed by a space and then any of these commands
    • begin = kills finder and starts cisn dispaly in kiosk mode
    • mvconf = deletes the current file in the conf folder and replaces it with our back up one in which is located in Documents/BackupConf, just in case its been compromised
    • sdwn = shuts down the computer and restarts it
    • stop = stops cronjob from restarting cisn every five minutes via file called "blockfile" which is placed on the desktop, will automatically undo itself in one hour. to manually restart the dispaly use "rmblock" disscussed below
    • rmblock = manually gets ride of the blockfile and allows the "begin" command to restart cisn every minute. Also starts up
Retrieved from "http://wiki-stadm.eri.ucsb.edu/index.php?title=CISN_Display&oldid=1889"