TJ CSL
  • TJ CSL
  • Services
    • Ion
      • Development
        • Overview
        • Setup
          • Docker Setup
          • Vagrant Setup
        • Environment
        • Fixtures
        • PR Workflow
        • Style Guide
        • Maintainer Workflow
        • Repository Maintenance
        • Data Generation
      • Production
      • User Experience
        • User Interface
    • Director
      • Development
        • Vagrant Setup
        • PR Workflow
        • Style Guide
        • Maintainer Workflow
      • Production
    • Workstations
    • Signage
      • Setup
      • Administration
      • Monitoring
      • Troubleshooting
      • Experimental
        • IonTap
        • SignageAdmin
    • Remote Access
      • Setup
      • Administration
    • Cluster
      • FAQ
      • Setup
        • SSH Setup
      • Administration
      • Slurm
      • Slurm Administration
      • Borg
    • Printing
      • Setup
      • Troubleshooting
    • WWW
      • Administration
      • Sites
        • Web Proxy
      • Setup
      • Troubleshooting
    • Academic Services
      • Tin
      • Othello
        • Administration
        • Setup
  • Technologies
    • Web
      • Nginx
      • Django
      • PHP-FPM
      • Node.js
      • Supervisord
    • DBs
      • PostgreSQL
      • MySQL
    • Authentication
      • Passcard
        • GPG Usage
      • SSHD
        • SSH Passwordless Login
      • FreeIPA
    • Storage
      • NFS
      • Ceph
        • Setup
        • Backups
        • CephFS
    • Operating Systems
      • Ubuntu Server
      • AlmaLinux
      • Debian
    • Tools
      • Ansible
      • Slack
      • GitBook
      • GitLab
        • Setup
        • Updating
    • Virtualization
      • QEMU/KVM
      • Libvirt
    • Advanced Computing
      • MPI
      • Tensorflow
    • Networking
      • Netbox
      • Cisco
      • Netboot
      • DNS
      • DHCP
      • NTP
      • BGP
    • Mail
      • Postfix
      • Dovecot
    • Monitoring
      • Prometheus
      • Grafana
      • Sentry
      • Uptime Robot
  • Machines
    • VM Servers
      • Utonium
      • Blossom
      • Bubbles
      • Buttercup
      • Antipodes
      • Chatham
      • Cocos
      • Galapagos
      • Gandalf
      • Gorgona
      • Overlord
      • Waverider
      • Torch
    • Ceph
      • Karel
      • Stobar
      • Wumpus
      • Waitaha
      • Barrel
      • Valdes
    • HPC Cluster
      • Zoidberg
    • Borg Cluster
    • Compute Sticks
    • Other
      • ASM
      • Duke
      • Snowy
      • Sauron
      • Sun Servers
        • Altair
        • Centauri
        • Deneb
        • Sirius
        • Vega
        • Betelgeuse
        • Ohare
    • Switches
      • Core0
      • Xnor
      • Xor
      • Imply
    • UPS
    • History
      • 2008 Sun AEG
      • 2011 Sun Upgrades
      • 2017 VM Disaster
      • 2018 Purchases
      • 2018 Cephpocalypse
    • VLANs
    • Remote Management
      • iLO
      • LOMs
    • Understudy
      • Switch Configuration
      • Server Configuration
        • Setting Up the Operating System
        • Network Configuration
        • Saruman
        • Fiordland
  • General
    • Sysadmins List
    • Organization
    • Documentation
      • Security
      • Runbooks
    • Communication
      • Terminology
    • Understudies
    • Account Structure
    • Machine Room
    • Branding
    • History
      • Fridge
      • The Brick
  • Procedures
    • Data Recovery
    • Account Provisioning
    • tjSTAR
      • Tech Support
    • Onboarding
      • New Sysadmin Onboarding
  • Guides
    • VM Creation
    • sshuttle Usage
    • Linux Wifi Setup
    • VNC Usage
    • Password Changes
    • Sun Server RAID Configuration
  • Policies
    • Data Release Policy
    • Upgrade Policy
    • Account Policy
    • Election Policy
  • Obsolete
    • Arcturus
    • Chuku
    • Cray SV1 Supercomputer
    • Ekhi
    • Mihr
    • Moloch
    • Sol
    • Rockhopper
    • Kerberos
    • LDAP
    • Agni
    • Moon
    • Apocalypse
    • AFS
      • OpenAFS
      • Setup
      • Client Setup
      • Administration
      • Troubleshooting
      • Directory Structure
      • Backups
      • Cross-Cell Authentication
    • Observium
    • OpenVPN
Powered by GitBook
On this page
  • Overview
  • Mattermost
  • Mattermost
  • Best Practices
  • Channels
  • Roles
  • Slack
  • Roles
  • E-mail
  • E-mail Responses
  • Lists
  • IRC
  • Clients
  • Channels
  • Etiquette
  • Useful Commands
  • Ion Announcements
  1. General

Communication

PreviousRunbooksNextTerminology

Last updated 11 months ago

Overview

Communication is important to the effective functioning of the Lab. We use Mattermost as our primary form of communication within the Sysadmins. Communication through e-mail is used to communicate with various stakeholders in the TJ community. Slack is used as a fallback form of communication in the event Mattermost is down. Sending mass notifications to the whole school is done through Ion announcements.

Mattermost

Mattermost

Mattermost () is open source software for team collaboration. It bills itself as a "Slack alternative".

The tjCSL Mattermost instance is located at . This space is only for use by the Sysadmins and Faculty Sponsor.

Best Practices

  • Keep conversations in relevant channels.

    • Don't talk about account recovery in the Signage channel, etc.

  • Don't spam.

    • Don't make people annoyed with notifications from a channel to the point where they mute the channel.

  • Use proper etiquette and be respectful.

    • There is no need to be disrespectful in the Mattermost channels.

  • Keep private conversations in DM.

    • Don't pollute channels with unnecessary messages that could just be communicated directly.

  • Use emotes to react to messages.

    • This reduces overall clutter and makes it easier to find stuff.

Channels

Conversations in Mattermost are organized into public and private channels. You can join a public channel by clicking on the + icon. Private (invite-only) channels require an invite from someone within the channel. Use invite-only channels for sensitive or non-public discussions.

Some channels include:

  • #general: For general discussions

  • #random: For random discussions

  • #ion: For discussion of Ion

  • #director: For discussion of Director

  • #sysadmins (private): For internal Sysadmin-only discussions

  • #notifications (private): For activity notifications (like GitLab pushes)

Roles

System admins have full administrative access to the Mattermost server. The Lead Sysadmins and Faculty Sponsor should be system admins and should designate other system admins they find necessary.

Server members can join, write, and read in public channels. They can also join, write, and read in invite-only channels. They can also create new public or invite-only channels.

The workspace membership should be restricted to people with an @tjhsst.edu e-mail.

Slack

Roles

The Faculty Sponsor should be "Primary Owner".

E-mail

Communicating with TJ community members is primarily done through email. The Eighth Period Office, administration, TJ Tech Team, teachers, and students rely on these channels for communicating with the Sysadmin team. Hence, e-mail services in the CSL (mail.tjhsst.edu and lists.tjhsst.edu) are mission-critical services.

E-mail Responses

To keep everyone happy, responding to e-mails quickly is preferred.

The person who is responsible for responding to an e-mail usually varies on a case-by-case basis and based on various factors. Some of these factors include:

  • Is it a support inquiry, complaint, question or request?

  • Who sent it and what position do they have?

  • How important is it?

  • Which Sysadmin(s) has access to the systems necessary to complete the request?

  • How much knowledge does the Sysadmin have of the functional area?

In general, the lead or contact person for a specific functional area should respond to e-mails.

Lists

Sysadmin Mailing List

If you did not get added to the mailing list, refer the mail admins to the new sysadmins onboarding issue on sysadmins/infrastructure/access-requests.

Intranet Mailing List

Director Mailing List

IRC

Clients

Multiple clients support IRC. We recommend one of the clients listed below:

Channels

  • #tjcsl

    • Channel for Sysadmins

  • #tjhsst

    • Channel for TJHSST students, past and present. and it is composed of alums and current students.

Etiquette

Using common sense, following server rules, and being respectful to others is good practice.

Useful Commands

Most of these are well documented by IRC.

Command

Description

/msg NickServ identify <username> <password>

Authenticate to NickServ

/msg NickServ register <password> <email>

Begin registration of current nick

/join <channel>

Join a channel

Sending messages is as easy as writing the message in the appropriate channel. You can reference others in the channel by mentioning their nick.

Ion Announcements

Posting general announcements to the TJ community (such as extended downtime or school-wide announcements) should generally be done through an Ion announcement. To approve an announcement, you must be an Ion admin. You can add an announcement by clicking the big Add button at the top of the dashboard.

The announcement should be simple, concise, informative, and attributed to the right person or team.

Slack () is a proprietary set of tools for team collaboration. It offers various integration with different services. We have a workspace at . The CSL's first widespread use of the Slack workspace began in August of 2018. Slack became the official form of communication under the direction of Omkar Kulkarni.

Most communication directed to the Sysadmins gets sent to . The official list address is sysadmins@lists.tjhsst.edu. This mailing list is restricted to Sysadmins and the Faculty Sponsor. Ask a mail admin for access if you did not get added to the list.

Most communication related to Ion gets sent to . The official list address is intranet@lists.tjhsst.edu. This mailing list is restricted to Intranet administrators.

Most communication related to Director gets sent to . This mailing list is restricted to Director administrators..

Internet Relay Chat (IRC) is an application layer protocol that facilitates communication in the form of text. You can read more about the protocol . We use Freenode to facilitate communications. IRC had been the primary tool for communication among Sysadmins until the switch over to Slack.

TheLounge: A modern self-hosted IRC web client. We host an instance at on Director. Their repository can be found at . Login is done through LDAP.

Matrix through matrix-appservice-irc: Matrix is an open network for secure, decentralized communication. , it's reference homeserver, hosts a Freenode IRC bridge. One way to connect to Matrix is through their reference client, Riot (). Instructions on how to connect can be found at . The bridge's repository is located at .

Hexchat: A local IRC client. It is installed on most Linux distros. Their website is .

https://mattermost.com
https://mattermost.tjhsst.edu
https://slack.com
https://tjcsl.slack.com
sysadmins@tjhsst.edu
intranet@tjhsst.edu
director@lists.tjhsst.edu
on Wikipedia
lounge.tjhsst.edu
https://github.com/thelounge/thelounge
https://matrix.org
https://about.riot.im/
https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ
https://github.com/matrix-org/matrix-appservice-irc/
http://xchat.org/