Installing CSS

From GlueXWiki
Revision as of 17:18, 9 June 2011 by Hovanes (Talk | contribs) (CSS Basic EPICS)

Jump to: navigation, search


Intro

  • These are some notes on installing CSS on my personal notebook running 32-bit Ubuntu 10.04 LTS. Installing on other distros of Linux should not be very different, but the directory name may vary.
  • There are more than version of CSS suite which can be downloaded. Some of them configured in pretty sophisticated ways requiring different packages.
  • The simplest way to run CSS is to download either CSS Basic EPICS, CSS Office from SNS, or CSS Island from DESY. These three versions easily connect to the EPICS PVs served through channel access. I also tried CSS NSLS2, and it connects to CA as well.
  • SNS Control room only provides source, and I did not want to get into building it. CSS DESY version did not work, it would start a small second screen and never went forward.
  • Since CSS is eclipse-based, you need to install eclipse-sdk package. You may also have to install java-1.6.0-sun package.


CSS Basic EPICS

  • Download the zip-file from http://ics-web.sns.ornl.gov/css/products.html, copy it to the desired directory ( I copied to /usr/local/epics/extensions/) and unzip it.
  • Go into the new directory and run the css executable.
  • In CSS->Preferences->CSS Core->EPICS configure CA address list, and restart CSS. After this CSS will connect to PVs served over CAs.
  • In order to change the default workspace one needs to edit configuration/config.ini file and change the line containing osgi.instance.area.default=@user.home/CSS-Workspaces/Default to desired location. Note that Workspace will either have a .metadata file in the directory, or such a file will be created.


CSS Island

  • Download the zip-file from http://css.desy.de/content/e413/e2597/index_eng.html, copy it to the desired directory and unzip it.
  • Go into the new directory and run the cssIskand executable.
  • In CSS->Preferences->CSS Core->EPICS configure CA address list, and restart CSS. After this CSS will connect to PVs served over CAs.



Some other packages that are not needed for a simple configuration

These are items that we may need to install for a more complete and sophisticate setup with ChannelFinder etc. These were not needed in order to simply start CSS and to connect to ChannelAccess.

Installing MySQL

  • Install mysql-server package from the distribution repository.
  • If there is a need to reset the MySQL root password, do as follows:
sudo /etc/init.d/mysql stop
sudo mysqld --skip-grant-tables &
mysql -u root mysql
UPDATE user SET Password=PASSWORD('YOURNEWPASSWORD') WHERE User='root'; FLUSH PRIVILEGES; exit;
  • After changing the MySQL password restart MySQL server

Installing LDAP

I followed the instruction from the various web sites, mainly from http://ubuntuforums.org/showthread.php?p=8161118, https://lists.ubuntu.com/archives/ubuntu-server/2009-August/003182.html and http://ubuntuforums.org/showthread.php?t=1054966. I set the LDAP password directly modifying /etc/ldap/slapd.d/cn=config/olcDatabase={0}config.ldif file setting olcRootPW: key. I had a hard time figuring out how to change the LDAP password or access config database without password.

  • Install LDAP server
    sudo apt-get install slapd ldap-utils
  • Run the following command to add all the LDAP schemas in the slapd package to your cn=config (by default only core is added):
    ls /etc/ldap/schema/*.ldif | xargs -I {} sudo ldapadd -Y EXTERNAL -H ldapi:/// -f {}
  • As an example create a database the LDAP server. Note that Karmic uses the EXTERNAL SASL binding to communicate with the LDAP server. There is no admin user or password here:
    sudo ldapadd -Y EXTERNAL -H ldapi:/// -f db.ldif
  • Add people to database we just created. Since we have created our own access control lists for the dc=home,dc=local database, we must change the binding method (i.e. auth with the admin user and password). Add the data for the directory via the following command:
    sudo ldapadd -x -D cn=admin,dc=home,dc=local -w admin -f people.ldif
  • Check to see if you can read the database:
    ldapsearch -x -b dc=home,dc=local

Installing GlassFish

  • Follow the instructions from http://www.nabisoft.com/tutorials/glassfish/installing-glassfish-301-on-ubuntu to download install GlassFish on Ubuntu.
  • I skipped the part on security part dealing with iptables, probably it can be configured later. You will be able to start (and stop) GlassFish using
    /home/glassfish/bin/asadmin start-domain domain1
  • I also did not uninstall openjdk, although I did have sun-java6 as well.

Installing ChannelFinder