Skip to content
Snippets Groups Projects
new-person.md 3.87 KiB
Newer Older
  • Learn to ignore specific revisions
  • ---
    title: New person
    ---
    
    anarcat's avatar
    anarcat committed
    
    How to get a new Tor System Administrator on board
    ==================================================
    
    ## Glossary
    
     * TSA: Tor System Administrators
     * TPA: Tor Project Admins, synonymous with TSA?
     * TPO: TorProject.Org, machines officially managed by TSA
     * TPN? torproject.net, machines in DNS but not officially managed by TSA
    
    anarcat's avatar
    anarcat committed
     * a sysadmin can also be a service admin, and both can be paid work
    
    anarcat's avatar
    anarcat committed
    
    ## Accounts required for a sysadmin
    
    
    anarcat's avatar
    anarcat committed
     1. LDAP (see [/doc/accounts](/doc/accounts)), which includes SSH
        access (see [/doc/ssh-jump-host/](/doc/ssh-jump-host/)). person will receive an
    
    anarcat's avatar
    anarcat committed
        email that looks like:
        
            Subject: New ud-ldap account for <your name here>
        
        and includes information about how to configure email forwarding
        and SSH keys
    
     2. tor-internal@ and other mailing lists (also see below)
    
    
    anarcat's avatar
    anarcat committed
     3. [howto/puppet](howto/puppet) git repository in `ssh://pauli.torproject.org/srv/puppet.torproject.org/git/tor-puppet`
    
     4. GitLab: admin account, preferably separate from the normal account
        (with a `-admin` suffix, e.g. `anarcat-admin`)
    
    anarcat's avatar
    anarcat committed
    
     5. TPA password manager is in `ssh://git@git-rw.torproject.org/admin/tor-passwords.git`
    
     6. RT: find the password in `hosts-extra-info` in the password
        manager, login as root and create an account member of `rt-admin`
        
    
    anarcat's avatar
    anarcat committed
     7. [howto/nagios](howto/nagios) access, contact should be created in
    
    anarcat's avatar
    anarcat committed
        `ssh://git@git-rw.torproject.org/admin/tor-nagios`, password in
        `/etc/icinga/htpasswd.users` directly on the server
    
     8. this wiki: `git@git-rw.torproject.org:project/help/wiki.git`
    
     9. bio + avatar on: <https://torproject.org/about/people>
    
    
    anarcat's avatar
    anarcat committed
     10. ask linus to get access for the new sysadmin in the sunet cloud
    
    anarcat's avatar
    anarcat committed
         (e.g. `Message-ID: <87bm1gb5wk.fsf@nordberg.se>`)
    
    ## Orienteering
    
    
    anarcat's avatar
    anarcat committed
     * sysadmin (this) wiki: <https://gitlab.torproject.org/anarcat/wikitest/-/wikis/>
    
    anarcat's avatar
    anarcat committed
     * list of services:
    
       <https://gitlab.torproject.org/legacy/trac/-/wikis/org/operations/Infrastructure>
    
    anarcat's avatar
    anarcat committed
       (not the purview of TSA directly, but maye be interesting)
     * TPO machines list: <https://db.torproject.org/machines.cgi>, key machines:
       * puppet: `pauli`
    
    anarcat's avatar
    anarcat committed
       * [jump host](/doc/ssh-jump-host): `perdulce` or `peninsulare` on some hosts
    
    anarcat's avatar
    anarcat committed
       * nagios: `hetzner-hel1-01.torproject.org`
       * LDAP: `alberti`
     * key services:
       * git: <https://gitweb.torproject.org/>, or `git@git-rw.torproject.org` over SSH
    
       * GitLab: <https://gitlab.torproject.org/> - issue tracking and project management
    
    anarcat's avatar
    anarcat committed
       * RT: <https://rt.torproject.org/> - not really used by TSA yet
       * spec: <https://spec.torproject.org/> - for a series of permalinks
         to use everywhere, including especially `bugs.tpo/NNN`
     * key mailing lists:
       * <tor-project@lists.torproject.org> - Open list where anyone is welcome to watch but posting is moderated. Please favor using this when you can.
       * <tor-internal@lists.torproject.org> - If something truly can't include the wider community then this is the spot.
       * <tor-team@lists.torproject.org> - Exact same as tor-internal@ except that the list will accept email from non-members. If you need a cc when emailing a non-tor person then this is the place.
       * <tor-employees@lists.torproject.org> - TPI staff mailing list
       * <tor-meeting@lists.torproject.org> - for public meetings
       * <torproject-admin@torproject.org> - TPA-specific mailing list,
         not a mailing list but an alias
     * IRC channels:
       * `#tor-project` - general torproject channel
       * `#tpo-admin` - channel for TPA specific stuff
       * `#tor-internal` - channel for private discussions, need secret
         password and being added to the `@tor-tpomember` with GroupServ,
         part of the `tor-internal@lists.tpo` welcome email)
       * `#tor-bots` - where a lot of bots live
       * `#tor-nagios` ... except the nagios bot, which lives here
       * `#tor-meeting` - where some meetings are held
       * `#tor-meeting2` - fallback for the above
    
    anarcat's avatar
    anarcat committed
     * TPI stuff: see employee handbook from HR