Maintenance

After some experimentation and some help from DW on the eXist list, I've managed to figure out the following steps for making your single app (MoEML or whatever) available as the root thing on th Jetty server (i.e. localhost:8080 if you're running it locally), while maintaining access to the other bits and pieces if necessary (the Dashboard, eXide, Monex or whatever else you need. These are the steps:

• In tools/jetty/webapps/exist-webapp-context.xml, find the element <set name="contextPath"> and make sure it looks like this:

  <Set name="contextPath">/</Set>

  i.e. not /exist. It may be that way already, or it may be /exist.
• In tools/jetty/standalone-webapps/exist-webapp-context.xml (same filename, different place), make the same change if required.
• In tools/jetty/webapps/portal/WEB-INF/jetty-web.xml, find the same element and set it to the same thing (again, it may already be correct).
• In webapp/WEB-INF/controller-config.xml, find this:

  <root pattern=".*" path="/"/>

  Comment it out and replace it with two lines like this:

    <!--<root pattern=".*" path="/"/>-->
    <root pattern="/apps/moeml/apps" path="xmldb:exist:///db/apps/"/>
    <root pattern="/" path="xmldb:exist:///db/apps/moeml/"/>
  

  Where "moeml" is the name of your app. The second line makes the other apps (dashboard etc.) available using the "apps" subfolder of the root (which means you can't have anything in your app's controller that handles an "apps" subfolder).

Note that this was done with a fresh build of eXist 3.0 from the develop branch yesterday, with no use of the installer. We've learned to steer clear of the installer.

I've now built all this into a set of files, configure_exist.sh/xml/xsl. The first is a bash script which expects the path to the eXist instance, and (optionally) the name of the app to make the root. The second is an ant script which is run by bash using the ant which is inside the tools folder of the eXist instance; this parses out what it needs to know, and runs XSLT transforms using the Saxon version which is in the lib/endorsed folder. This means that you can run this deployment script even where neither ant nor Saxon are installed (such as Peach). It has a fragile dependency on the version numbers in filenames of ant and Saxon, but those are easy to update.

I've worked the CodeSharing feature into the MoEML XAR today, deciding on having the build process for the XAR just check it out from GitHub and put the bits in the right place, with the controller.xql handling the rest. So far so good; then I set up controller-config.xml so that the root path goes to the MoEML webapp, and the other apps we want are available from there. However, the "root" right now is /exist, not /, and I can't find a way to change that. After trying everything I could think of, I've written to the eXist list.

Created a script in svn/hcmc/exist which cleans the git tree completely, builds exist, signs the jars, creates a fairly minimal dist, and builds a test instance with one of our own xars, then starts it for testing. All that remains to be done is figure out how to change the jetty.xml file and any oother conf files to add the required placeholders.

Still on the quest of the best way to build a working eXist and update it cleanly, we've been testing the dist-zip build target. First, though, I determined how to build with DS's patch for the bug I reported the other day, which is still only a pull request (#1256); CLI for future reference:

git pull
git checkout 1256
git fetch origin pull/1256/head:1256
git checkout 1256

Then we do:

./build.sh clean
./build.sh 
./build.sh jnlp-all

the last of which signs the jars, enabling the Java client to work. This gives us a working build in the repo context, but of course it's cluttered up with lots of unwanted stuff, including source. That's why we wanted to use the dist-zip target, but the result is currently broken due to an obscure timestamping issue which I reported today on the gmane list. We could manually create a clean tree, of course, but it would be easier to have a script do it.

JA called to report that the config on the CCAP db had been hosed by the visit of a robot to a specific URL, which triggered something completely unexpected and unwanted. He was able to recover it, and add protection against a similar event both on CCAP and on LOI. The AtoM documentation is apparently not working properly so we can't find anything on their site about this particular "feature".

GL's desktop was rebuilt, and the huge TCCD git repo was copied over. However, it had been checked out using git://, and somehow it knew that the old desktop had SSH keys configured on GitHub, so we had to generate new keys (GL couldn't remember the pw for the old keys), add them to ssh-agent, and add the public key to GitHub (the key must be for the email address by which GitHub knows you). Then pulls and pushes would work. All this is quicker than checking out that repo again, of course.

Helped GN set up the new TV, and got the condenser mic working for video-conferencing. The TV's own speakers are sufficient, probably, but I've connected the others anyway.

URLs containing "editor" are all being redirected to the HCMC site, even though only the www/editor URLs were supposed to be; that borks our adaptiveDB projects, so I've written to pts to see if we can get it fixed. MS's two projects Bilibin and St Pete were also screwed up, being in a "projects" folder, but in that case, I've just moved the projects up one level to the hcmc/www, and we'll cope with the changed URLs.

Since it's not trivial to get this done, these are the steps:

• Ask NETS to add the domain to the UVic DNS servers, pointing at the root of hcmc.uvic.ca.
• Ask sysadmin to set up the apache virtual host on HCMC's web cluster.
• Test locally.
• Ask the person with the domain record to log into their registrar and set the DNS IPs to UVic's servers.

For the record, this one points at /home1t/thewali/www/

xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

sudo xcode-select --reset