Services

From Einstein Toolkit Documentation
Revision as of 00:36, 20 August 2020 by Rhaas (talk | contribs) (Build and test)
Jump to: navigation, search

The Einstein Toolkit depends on a number of services managed by the ET maintainers. Here we list each of these, and give any relevant information. Ideally, this page should be sufficient for a maintainer to deal with urgent issues relating to these services in case the primary administrator is unavailable.

On 2018-12-10 and 2018-12-17 Steve Brandt and Roland Haas gave a short introduction to the ET infrastructure services. Here are the slides used which may contain information not yet included in this wiki.

Getting Help

  • For LSU sites, you can email CCT IT Support <it-support@cct.lsu.edu>, please mention that you work with Steve Brandt. Ideally, you should have a CCT external user account when sending help mail. If you don't have one, please email the above it-support@cct.lsu.edu address to ask for one.
  • For NCSA, the generic email for help of any kind is help@ncsa.illinois.edu and CC'ing Roland Haas (rhaas@illinois.edu) will help. If you are involved in a service hosted at NCSA we can create an external collaborators NCSA account for you, please contact Roland to create such an account.

Website

  • https://einsteintoolkit.org
  • Location: A VM at CCT
  • Administrator: Steve Brandt
  • Source for website: https://stevenrbrandt@bitbucket.org/einsteintoolkit/www.git
  • Docker source for webserver: https://github.com/stevenrbrandt/et-websites.git
  • Members list: The members list is updated manually, in response to an email sent by the website's PHP script. The email sends the subscribers email address, whether they'd like to be added to the mailing list, a link to add the user to the mailing list, and a text entry for members.txt (from which the members page is generated). In addition, there is a python script, sortmembers.py, which sorts the members.txt file.
  • Release announcements: Each must be put in the about/releases directory, using the name ET_{year}_{month}_announcement.md. The script mk_release_announcements.py will generate a txt and html file from the md file.

Tutorial

  • Source: https://github.com/nds-org/jupyter-et setup notes are there as well.
  • secrets for github hookup (owned by Craig) are currently stored only on the VM
  • Location: https://etkhub.ndslabs.org
  • A VM in NCSA's Nebula VM system. ssh accessible at etkhub.ndslabs.org.
  • Requests to grant tutorial accounts are sent to maintainers@einsteintoolkit.org and manually acted on by Steve or Roland by adding to the file whitelist/users.txt
  • Administrator: Craig Willis, Steve Brandt, Roland Haas

Wiki

Subversion

git

The organizations should has administrator group and a developer group where administrators are the ET maintainers and developers are ET users who have been granted write access to the repos. We try to keep access control coarse grained, erring on the side of granting write access easily and to all repos rather than micromanaging access.

New code repositories on bitbucket should set up a "repo push" (the default) web-hook to contact https://einsteintoolkit.org/hooks/repo_changed.php?secret=XXX to send commit messages to commits@einsteintoolkit.org where XXX is to be found in https://bitbucket.org/einsteintoolkit/www/src/master/hooks/repo_changed.php#lines-18 (or thereabouts, look for the variable $secret).

New code repositories on github should set up commits@einsteintoolkit.org as the recipient of push event emails in https://github.com/GITHUB_USER_NAME/REPO_NAME/settings/notifications/edit .

github is used by gitter.im to authenticate users but access to https://gitter.im/einsteintoolkit is possible without being in the github einsteintoolkit organization.

Bitbucket ticket repository

Mailing lists

Chat channels

Zoom

  • we are using a zoom instance provided by LSU, details described on ET_call_Zoom_Info.
  • Administrator: Steve Brandt

ET call reminders

  • reminders to add to the agenda and for the calls themselves are sent to users@einsteintoolkit.org at Monday 15:18 Central time and Wednesday 17:15 Central time respectively, via cron jobs running on Roland Haas' workstation
  • Administrator: Roland Haas
#!/bin/bash

if [ $(date +%s) -lt  $(date +%s -d  2019-06-21) ] ; then
exit
fi

mail -r users@einsteintoolkit.org -s "Agenda for Thursday's Meeting" users@einsteintoolkit.org <<EOF
Please update the Wiki with agenda items for Thursday's meeting. Thanks!

https://docs.einsteintoolkit.org/et-docs/meeting_agenda

--The Maintainers
EOF
#!/bin/bash

if [ $(date +%s) -lt  $(date +%s -d  2019-06-21) ] ; then
exit
fi

mail -r users@einsteintoolkit.org -s "Einstein Toolkit Meeting Reminder" users@einsteintoolkit.org <<EOF
Hello,

Please consider joining the weekly Einstein Toolkit phone call at
9:00 am US central time on Thursdays. For details on how to connect
and what agenda items are to be discussed, use the link below.

https://docs.einsteintoolkit.org/et-docs/Main_Page#Weekly_Users_Call

--The Maintainers
EOF

CactusCode.org

Website monitoring

Websites are monitored by https://uptimerobot.com/ using an account owned by Ian Hinder. Currently monitored pages are:

Email updates are sent to <maintainers@einsteintoolkit.org> which has had alert@uptimerobot.com add to its list of allowed posters. This current status of these monitors is visible at https://etstats.barrywardell.net/ while an older hand-written monitor of Frank Loeffler's is at https://www.cct.lsu.edu/~knarf/cgi-bin/monitor.cgi .

Access to the monitors has to be through Ian Hinder whose account runs them.

Cactus services?

Domain

  • einsteintoolkit.org
  • Owned by LSU
  • Notes: Cannot point subdomains to any machines not controlled directly by LSU

Build and test

  • https://build-test.barrywardell.net or https://jenkins.einsteintoolkit.ncsa.illinois.edu (same node)
  • interactive login to VM similar to build slave: login.barrrywardell.net . Access: Roland Haas, Ian Hinder
  • Location: A VM in NCSA Nebula
  • Administrator: Roland Haas, Ian Hinder
  • Nebula access: Roland Haas (and Gabrielle Allen)
  • Detailed documentation at BuildAndTest
  • Notes:
    • Jenkins runs on the build master, and can connect to a variety of build nodes. One such node is also hosted on Nebula, and is currently (19-August-2020) the only working build node.
    • Depends on the git super-repository https://bitbucket.org/einsteintoolkit/einsteintoolkit
    • et.barraywardell.net should update super-repo, currently (as of 2019-03-15) this is not working (due to transitioning ExternalLibraries from LSU's svn servers to github) and Roland Haas's workstation is taking over that duty for now
    • A login node for people to test failures on a system very similar to the build node is available at login.barrywardell.net. Contact Ian Hinder for access.
    • Roland Haas is running 3 OSX VMs on a laptop in his office. Detailed description on how they were set up is in the CactusJenkins repo in build-slave-osx.md. Contact Roland Haas to gain access.

Git updater

  • et.barrywardell.net
  • Location: A VM in NCSA Nebula
  • Administrator: Ian Hinder
  • Notes:
    • This server periodically updates its local copies of the ET repositories and updates the git super-repository at https://bitbucket.org/einsteintoolkit/einsteintoolkit/. It also hosts and updates git-svn mirrors of the subversion repositories needed for the ET, so that the super-repository can use them.