<?xml version="1.0" encoding="UTF-8"?>
<hibernate-generic datetime="2026-02-03 15:58:00">
<object class="Page" package="com.atlassian.confluence.pages">
<id name="id">25395763</id>
<collection name="children"><element class="Page" package="com.atlassian.confluence.pages"><id name="id">25395767</id>
</element>
</collection>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="title"><![CDATA[Home]]></property>
<collection name="bodyContents"><element class="BodyContent" package="com.atlassian.confluence.core"><id name="id">25428524</id>
</element>
</collection>
<property name="version">1</property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
<property name="versionComment"><![CDATA[]]></property>
<property name="contentStatus"><![CDATA[current]]></property>
</object>
<object class="Space" package="com.atlassian.confluence.spaces">
<id name="id">25722881</id>
<property name="name"><![CDATA[901219 - swFOCE]]></property>
<property name="key"><![CDATA[swFOCE]]></property>
<property name="description" class="SpaceDescription" package="com.atlassian.confluence.spaces"><id name="id">25395762</id>
</property>
<property name="homePage" class="Page" package="com.atlassian.confluence.pages"><id name="id">25395763</id>
</property>
<collection name="permissions"><element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526311</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526312</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526313</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526314</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526315</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526316</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526317</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526318</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526319</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526320</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526321</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526322</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526323</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526324</id>
</element>
<element class="SpacePermission" package="com.atlassian.confluence.security"><id name="id">25526327</id>
</element>
</collection>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.013</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.013</property>
<property name="spaceType">global</property>
</object>
<object class="Page" package="com.atlassian.confluence.pages">
<id name="id">25395767</id>
<property name="parent" class="Page" package="com.atlassian.confluence.pages"><id name="id">25395763</id>
</property>
<collection name="ancestors"><element class="Page" package="com.atlassian.confluence.pages"><id name="id">25395763</id>
</element>
</collection>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="title"><![CDATA[Installing FOCE Software on a Linux Server]]></property>
<collection name="bodyContents"><element class="BodyContent" package="com.atlassian.confluence.core"><id name="id">25428528</id>
</element>
</collection>
<collection name="outgoingLinks"><element class="OutgoingLink" package="com.atlassian.confluence.links"><id name="id">25561211</id>
</element>
<element class="OutgoingLink" package="com.atlassian.confluence.links"><id name="id">25561212</id>
</element>
<element class="OutgoingLink" package="com.atlassian.confluence.links"><id name="id">25561213</id>
</element>
</collection>
<property name="version">1</property>
<property name="creatorName"><![CDATA[bobh]]></property>
<property name="creationDate">2014-04-28 16:27:40.197</property>
<property name="lastModifierName"><![CDATA[bobh]]></property>
<property name="lastModificationDate">2014-04-28 16:27:40.197</property>
<property name="versionComment"><![CDATA[]]></property>
<property name="contentStatus"><![CDATA[current]]></property>
</object>
<object class="ConfluenceBandanaRecord" package="com.atlassian.confluence.setup.bandana">
<id name="id">25755649</id>
<property name="context"><![CDATA[swFOCE]]></property>
<property name="key"><![CDATA[atlassian.confluence.theme.settings]]></property>
<property name="value"><![CDATA[<map>
  <entry>
    <string>theme.key</string>
    <string></string>
  </entry>
</map>]]></property>
</object>
<object class="ConfluenceBandanaRecord" package="com.atlassian.confluence.setup.bandana">
<id name="id">25755651</id>
<property name="context"><![CDATA[swFOCE]]></property>
<property name="key"><![CDATA[atlassian.confluence.space.settings]]></property>
<property name="value"><![CDATA[<com.atlassian.confluence.setup.settings.SpaceSettings>
  <spaceKey>swFOCE</spaceKey>
  <disableLogo>false</disableLogo>
  <colourSchemesSettings>
    <colourSchemeType>global</colourSchemeType>
  </colourSchemesSettings>
</com.atlassian.confluence.setup.settings.SpaceSettings>]]></property>
</object>
<object class="ConfluenceBandanaRecord" package="com.atlassian.confluence.setup.bandana">
<id name="id">25755650</id>
<property name="context"><![CDATA[swFOCE]]></property>
<property name="key"><![CDATA[atlassian.confluence.css.resource.counter]]></property>
<property name="value"><![CDATA[<int>2</int>]]></property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526314</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[SETSPACEPERMISSIONS]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="BodyContent" package="com.atlassian.confluence.core">
<id name="id">25428528</id>
<property name="body"><![CDATA[h3. Background

QuickFOCE&nbsp; consists of an electronics can containing power conversion hardware and a Digi Portserver TS4 MEI, a 4 port Ethernet to serial converter.&nbsp; The 4 serial ports service:
* A Seabird SBE-52 CTD mounted to measure the ambient (background) water
* Two Seabird SBE-18S digital pH sensors \-\- one for in the chamber, one for ambient conditions
* A motor controller

These instruments are sampled and controlled by a Linux workstation on shore.&nbsp; In the case of SW-FOCE at Hopkins, this server is kelpbed.swfoce.mbari.org.&nbsp; The workstation for the MBARI test tank setup is fangtooth.shore.mbari.org.

h3. Linux

The preferred, tested Linux setup is to install CentOS 6.5.&nbsp; Once CentOS is installed, you need to install the folllowing required packages as *root* (some of these are required for the Digi driver, some for the xFOCE software):
* yum update
* yum install gcc
* yum install gcc-c++.x86_64
* yum install libtool
* yum install kernel-devel
* yum install emacs (my preferred editor, YMMV)
* yum install ncurses-devel ncurses
* yum install tcl
* yum install tk
* yum install openssl-devel
* yum install libuuid-devel
* yum install mercurial

h3. Digi Driver

The correct version of the Digi driver for CentOS (as of this writing) is dgrp-1.9.&nbsp; The gzipped tar file is in the ProjectLibrary under "901219 SW-FOCE\Software\QuickFOCE\Digi\40002086_S.tgz"
* Extract this tarball to somewhere convenient
* ./configure
* make all
* su&nbsp; (the rest needs to be done as root)
* make install
* make postinstall
* Edit /etc/group to add ops to the root group

You can now run the Digi gui, *dgrp_gui.*&nbsp; Mapping the correct Portserver should be obvious.&nbsp; We recommend that you use static IP addressing for the Portserver.&nbsp; At SW-FOCE, the reserved address is *swfoce-serial.swfoce.mbari.org.*

h3. xFOCE Software

To build the xFOCE software, you'll need to find and download the following:
* The xFOCE source.&nbsp; This can be obtained via Mercurial via the command line:&nbsp; *hg clone https://bitbucket.org/klheadley/xfoce*
* *libmodbus \-\-* as of this writing, the appropriate version is libmodbus_3.0.6.tar.gz.&nbsp; You may obtain it from libmodbus.org.
* *zeromq* and *czmq,* both available from zeromq.org.&nbsp; Due to a build incompatibility (which hopefully will be resolved soon), as of this wrigint you'll need slightly old versions of the above.&nbsp; Use zeromq-4.0.1.tar.gz and czmq-2.0.2.tar.gz.

h4. Support Software

For each of the support packages, *libmodbus, zeromq,* and *czmq,* you need to do the following:
* untar the .gz file
* cd into the directory just created
* ./configure
* make
* (as root) make install

h4. xFOCE software

* edit configure.ac to change to AC-PREREQ(\[2.60\]), and to allow a $host other than those configured.&nbsp; The default $host clause should do a AC_MSG_WARN() rather than AC_MSG_ERR(), and use the macros from i686-pc-linux-gnu
* &nbsp;libtoolize \-f
* aclocal
* autoconf
* automake \--add-missing
* autoreconf
* ./configure
* make

You do not need to 'make install', though you may do so if you wish.&nbsp; But it's easiest just to run it from the build directory.&nbsp; To do so, you need to:
* Set the *XF_HOME* environment variable to the xFOCE install directory
* . $XF_HOME/src/scripts/xfhome $XF_HOME
* gwrun \[-f config_file\]

An example config file is included in $XF_HOME/conf/simple.conf.&nbsp; So you can simply run{*}gwrun \-f simple.conf*\\

h3. &nbsp;


h3.
&nbsp;




h3. &nbsp;


h3.]]></property>
<property name="content" class="Page" package="com.atlassian.confluence.pages"><id name="id">25395767</id>
</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526313</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[EDITSPACE]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="OutgoingLink" package="com.atlassian.confluence.links">
<id name="id">25561212</id>
<property name="destinationPageTitle"><![CDATA[-f config_file\]]></property>
<property name="destinationSpaceKey"><![CDATA[swFOCE]]></property>
<property name="sourceContent" class="Page" package="com.atlassian.confluence.pages"><id name="id">25395767</id>
</property>
<property name="creatorName"><![CDATA[bobh]]></property>
<property name="creationDate">2014-04-28 16:27:40.300</property>
<property name="lastModifierName"><![CDATA[bobh]]></property>
<property name="lastModificationDate">2014-04-28 16:27:40.300</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526316</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[REMOVECOMMENT]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="OutgoingLink" package="com.atlassian.confluence.links">
<id name="id">25561213</id>
<property name="destinationPageTitle"><![CDATA[//bitbucket.org/klheadley/xfoce*]]></property>
<property name="destinationSpaceKey"><![CDATA[https]]></property>
<property name="sourceContent" class="Page" package="com.atlassian.confluence.pages"><id name="id">25395767</id>
</property>
<property name="creatorName"><![CDATA[bobh]]></property>
<property name="creationDate">2014-04-28 16:27:40.300</property>
<property name="lastModifierName"><![CDATA[bobh]]></property>
<property name="lastModificationDate">2014-04-28 16:27:40.300</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526315</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[REMOVEPAGE]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="BodyContent" package="com.atlassian.confluence.core">
<id name="id">25428524</id>
<property name="body"><![CDATA[This is the home page for the 901219 - swFOCE space.]]></property>
<property name="content" class="Page" package="com.atlassian.confluence.pages"><id name="id">25395763</id>
</property>
</object>
<object class="SpaceDescription" package="com.atlassian.confluence.spaces">
<id name="id">25395762</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="title"/><collection name="bodyContents"><element class="BodyContent" package="com.atlassian.confluence.core"><id name="id">25428523</id>
</element>
</collection>
<property name="version">1</property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:17.987</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:17.987</property>
<property name="versionComment"><![CDATA[]]></property>
<property name="contentStatus"><![CDATA[current]]></property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526312</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[COMMENT]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526311</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[VIEWSPACE]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526322</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[EXPORTSPACE]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526321</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[EXPORTPAGE]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526324</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[SETPAGEPERMISSIONS]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526323</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[REMOVEMAIL]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526318</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[CREATEATTACHMENT]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526317</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[REMOVEBLOG]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="OutgoingLink" package="com.atlassian.confluence.links">
<id name="id">25561211</id>
<property name="destinationPageTitle"><![CDATA[2.60\]]></property>
<property name="destinationSpaceKey"><![CDATA[swFOCE]]></property>
<property name="sourceContent" class="Page" package="com.atlassian.confluence.pages"><id name="id">25395767</id>
</property>
<property name="creatorName"><![CDATA[bobh]]></property>
<property name="creationDate">2014-04-28 16:27:40.300</property>
<property name="lastModifierName"><![CDATA[bobh]]></property>
<property name="lastModificationDate">2014-04-28 16:27:40.300</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526320</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[EDITBLOG]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526319</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[REMOVEATTACHMENT]]></property>
<property name="group"/><property name="userName"><![CDATA[kgomes]]></property>
<property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:37:18.033</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:37:18.033</property>
</object>
<object class="SpacePermission" package="com.atlassian.confluence.security">
<id name="id">25526327</id>
<property name="space" class="Space" package="com.atlassian.confluence.spaces"><id name="id">25722881</id>
</property>
<property name="type"><![CDATA[VIEWSPACE]]></property>
<property name="group"><![CDATA[U_Employees]]></property>
<property name="userName"/><property name="creatorName"><![CDATA[kgomes]]></property>
<property name="creationDate">2014-04-25 09:38:18.737</property>
<property name="lastModifierName"><![CDATA[kgomes]]></property>
<property name="lastModificationDate">2014-04-25 09:38:18.737</property>
</object>
<object class="BodyContent" package="com.atlassian.confluence.core">
<id name="id">25428523</id>
<property name="body"><![CDATA[]]></property>
<property name="content" class="SpaceDescription" package="com.atlassian.confluence.spaces"><id name="id">25395762</id>
</property>
</object>
</hibernate-generic>