User Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
techadmin:changerequest [2014/03/13 18:36]
rjohnson created
techadmin:changerequest [2024/05/09 05:04] (current)
Line 1: Line 1:
-====== SysOp: Change Request Process ====== +====== SysOp: Change Request & Problem Reporting Process ====== 
-As of March 2014, the system administrators are trying to track all changes needed, so that we don't lose things. This page attempts to capture the processes and available options, but is by no means anywhere even near complete.+As of March 2014, the system administrators are trying to track all changes needed, so that we don't lose things. This page attempts to capture the processes and available options, but is by no means anywhere even near complete. Templates are here to help include all the parts of a request needed.
  
 +<note warning>This page is deliberately publicly visible at [[public:tech-change-request|public:tech-change-request]], so we can link external partners to it. Please ensure no private/secret items are ever included!</note>
 ==== General ==== ==== General ====
 For all entries here, unless otherwise noted, please either email [[sysop@bc.libraries.coop]], or create a ticket in the SysOp RT queue. For all entries here, unless otherwise noted, please either email [[sysop@bc.libraries.coop]], or create a ticket in the SysOp RT queue.
 +
 +==== Email (New accounts/aliases) ====
 +  * Subject: ''Email: New account: $ADDRESS''
 +=== Example #1 ===
 +> To: sysop@bc.libraries.coop
 +> Subject: Email: New account: bart.simpson@springfield.or.us.libraries.coop
 +>
 +> Bart is working for the library this summer to redesign our webpage.
 +> Please create an email account for him under our domain.
 +>
 +> Name: Bart Simpson
 +> Email: bart.simpson@springfield.or.us.libraries.coop
 +=== Example #2 ===
 +> To: sysop@bc.libraries.coop
 +> Subject: Email: New alias: webmaster@springfield.or.us.libraries.coop
 +>
 +> We'd like a generic address to forward to the librarian instead of putting Bart's name on the website.
 +>
 +> Email: webmaster@springfield.or.us.libraries.coop
 +> Forward to: martha@springfield.or.us.libraries.coop
 +
 +==== Email (Problems) ====
 +  * Subject: ''Email: $summary''
 +    * ''$summary'' should be a very short explanation of the change, ideally not more than 30 characters
 +    * eg: ''From address is broken'', ''Webmail display broken''
 +  * Body should contain:
 +    * Email address/username on system
 +    * description of the problem
 +    * attached bounced emails or full error messages
 +      * Including full headers on the emails and messages is really helpful in solving problems
 +=== Example ===
 +> To: sysop@bc.libraries.coop
 +> Subject: Email: From address broken on outgoing email
 +
 +> Please help, the from address is broken on outgoing email.
 +> It's going out with: blp.jpublic@bclibrary.ca
 +> It should be: jpublic@lillooet.bclibrary.ca
 +
 +> Sincerely,
 +> $person
  
 ==== DNS ==== ==== DNS ====
   * Subject: ''DNS Change Request: $summary''   * Subject: ''DNS Change Request: $summary''
     * ''$summary'' should be a very short explanation of the change, ideally not more than 30 characters     * ''$summary'' should be a very short explanation of the change, ideally not more than 30 characters
-  * Body needs to contain+  * Body must contain
     * Old hostname (if modify or delete)     * Old hostname (if modify or delete)
     * New hostname (if modify or add)     * New hostname (if modify or add)
Line 28: Line 69:
  
  
- 
-==== Email accounts ==== 
-TODO 
 ==== New staff onboarding accounts ==== ==== New staff onboarding accounts ====
-TODO+  * Please note that all usernames going forward will be created as ASCII ''firstname.lastname'' 
 +    * Hyphens are valid 
 +    * Accents should be dropped 
 +    * Other characters should be transliterated: eg ö => oe 
 +=== Example === 
 +> To: sysop@bc.libraries.coop 
 +> Subject: Accounts for new staff member JOHN.PUBLIC 
 +
 +> Please create accounts for new staff member. 
 +> Name: John Public 
 +> Role: System Administrator 
 +> Username: john.public 
 +> Start Date: 2014/04/01 
 +> Contact information: ... 
 +> External email: john@public.domain 
 +> External phone: 555-123-4567 
 +
 +> Services: Email, Wiki, RT, (etc) 
 +
 +> Thanks 
 +> Boss Person 
 ==== S3 storage ==== ==== S3 storage ====
 TODO TODO
 +
 ==== SSH access ==== ==== SSH access ====
 TODO TODO
 +
 ==== Firewall changes ==== ==== Firewall changes ====
 TODO TODO
 +
 ==== VM requests ==== ==== VM requests ====
 TODO TODO
 +
 +==== SSL certificates ====
 +If an SSL certificate needs renewing, or you need a new CSR to renew the certificate yourself, this is the request for you.
 +  * Subject: ''SSL Certificate: $summary''
 +    * ''$summary'' should be a very short explanation of the change, ideally not more than 30 characters
 +  * Body needs to contain
 +    * Domain/Hostname
 +    * System(s) to be deployed on
 +    * Location of existing RSA keys
 +
 +<note tip> If prompted for a technical contact in buying your SSL certificate, please use ''hostmaster@domain'', and ensure that you have working inbound email for that address beforehand.</note>
 +
 +=== SSL certificate example ===
 +> To: sysop@bc.libraries.coop
 +> Subject: SSL Certificate: bclaconnect.ca
 +>
 +> Hostname: bclaconnect.ca
 +> Host: bclaconnect.ca/bcla.libraries.coop
 +>
 +> Please provide a new CSR for host bclaconnect.ca, based on the existing RSA key.
 +>
 +> We will use hostmaster@bclaconnect.ca as the technical contact for domain confirmation.
 +>                                                                                                                                                                                                                                                                                                                     
 +> Sincerely,                                                                                                                                                                                                                                                                                                              
 +> Jon
 +
 ==== GitHub Access ==== ==== GitHub Access ====
 This is for access to the [[http://github.com/organizations/BCLibCoop|BCLibCoop organization account at GitHub]], or repositories contained therein. This is for access to the [[http://github.com/organizations/BCLibCoop|BCLibCoop organization account at GitHub]], or repositories contained therein.
Line 47: Line 135:
 ===== Notes ===== ===== Notes =====
   * The request for short subject lines is to make them easier to scan in the RT interface and email clients, based on the Git commit subject line convention of 50 characters per subject.   * The request for short subject lines is to make them easier to scan in the RT interface and email clients, based on the Git commit subject line convention of 50 characters per subject.
- 
techadmin/changerequest.1394735794.txt.gz · Last modified: 2014/03/13 18:36 by rjohnson