KnowledgeBase

Differences between revisions 151 and 178 (spanning 27 versions)
Revision 151 as of 2016-10-25 17:21:36
Size: 12096
Editor: powersj
Comment:
Revision 178 as of 2019-12-10 22:29:10
Size: 16
Editor: powersj
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
<<Include(ServerTeam/Header)>>

||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents(1)>>||

= Overview =

The knowledge base contains development, test, and operational resources specific to the Ubuntu Server team. If you have any questions, don't hesitate to [[ServerTeam/Contact|contact]] other ServerTeam members.

<<Anchor(triage)>>
= Bug Triage =

'''Goal:''' To successfully review every bug filed against Ubuntu Server related packages

A review involves analyzing a bug to determine if the bug is valid and if sufficient information was provided. If the bug is both valid and provided with sufficient information, the bug is marked as triaged and will be worked to closure by a member of the server team. Otherwise, the bug will be responded to and marked as 'Incomplete' for more details, 'Invalid' for not a real bug, or 'Won't Fix'.

[[https://bugs.launchpad.net/ubuntu/?field.searchtext=&orderby=-date_last_updated&search=Search&field.status%3Alist=NEW&field.status%3Alist=CONFIRMED&field.status%3Alist=TRIAGED&field.status%3Alist=INPROGRESS&field.status%3Alist=FIXCOMMITTED&field.status%3Alist=INCOMPLETE_WITH_RESPONSE&field.status%3Alist=INCOMPLETE_WITHOUT_RESPONSE&assignee_option=any&field.assignee=&field.bug_reporter=&field.bug_commenter=&field.subscriber=&field.structural_subscriber=ubuntu-server&field.component-empty-marker=1&field.tag=&field.tags_combinator=ANY&field.status_upstream-empty-marker=1&field.has_cve.used=&field.omit_dupes.used=&field.omit_dupes=on&field.affects_me.used=&field.has_no_package.used=&field.has_patch.used=&field.has_branches.used=&field.has_branches=on&field.has_no_branches.used=&field.has_no_branches=on&field.has_blueprints.used=&field.has_blueprints=on&field.has_no_blueprints.used=&field.has_no_blueprints=on|Here is the list of recently modified bugs in packages used for triage by the server team]].

[[https://bugs.launchpad.net/~ubuntu-server/+subscribedbugs|Here is the backlog query for the server team]].

== Daily bug triaging ==

Bug triage is completed for all bugs last updated on a particular day. An assigned member of the server team will look at all bugs that were updated on the previous day. For example, the member with responsibility on Friday will review all the bugs updated on Thursday. For the weekend, the member with responsibility on Monday will review all the bugs updated on Friday, Saturday, and Sunday.

This process is expected to take less than 30 minutes per day. This is not meant to be a full root cause analysis (RCA) investigative time, instead only determining if further attention is warranted and sufficient information has been provided.

Current members of Ubuntu Server bug triage:

 * cpaelzer
 * nacc
 * powersj
 * robie

=== Assignment ===
Assignment of daily bug triage is completed as an agenda item of the server team's IRC meeting.

== Additional resources ==
Helpful Guides and Definitions:

 * [[https://wiki.ubuntu.com/ServerTeam/KnowledgeBase/BugTriage|Bug Triage Workflow]]
 * [[Bugs/Importance|Definitions for bug importance levels]]
 * [[Bugs/Status|Defintions for bug status settings]]
 * [[Bugs/Responses|Predefined response templates]]


= Developer/Packager resources =

For packaging information, head to the [[MOTU|MOTUs, the Master Of The Universe]].
 * There is the [[PackagingGuide]].
 * [[PackagingGuide/Lists/DocumentationResources]] and [[MOTU/School]] have information related to packaging.
 * [[UbuntuDevelopers]] explains how to become an official packager.
 * [[https://lists.ubuntu.com/mailman/listinfo/ubuntu-motu|ubuntu-motu mailing list]] and #ubuntu-motu on irc.freenode.org are good places to ask for help.

We're focusing on server related packages in main and universe.

  * Developers can use the [[http://tinyurl.com/triaged-ubuntu-server|Triaged Ubuntu Server bugs]] list to prioritize their work.

== Ubuntu Server Daily Builds ==

In order for our users latest testing software of various server software we have the Ubuntu Server Dailies PPA. To get software added one has to do the following:

 1. Add yourself to the Ubuntu Server Edgers Launchpad group [[https://launchpad.net/~ubuntu-server-edgers|here]].
 1. If the project that you wish to add is not apart of launchpad, register the project and import the code into a launchpad branch.
 1. Follow the instructions on how to build a daily package [[https://help.launchpad.net/Packaging/SourceBuilds/GettingStarted|here]].
 1. Create a PPA in the Ubuntu Server Edgers group, the format for the PPA is the following:
 * Display Name: <project> Edgers Archive
 * Description: Fill with relevant informaion
 * PPA Name: server-edgers-<project>
 1. Create your recipe
 1. Publish to a blog post that the ppa is available to users.

== Stack package names policy ==

Integration work on specific server stacks (Mail stack, cluster stack, etc...) sometimes result in specific integration binary packages. In order to provide a coherent user experience, those binary packages should follow the following naming rule:

''stackname''-stack-''function''

As an example, mail stack packages could be named "mail-stack-delivery", "mail-stack-relay"...

Decision from [[https://wiki.ubuntu.com/MeetingLogs/Server/20100525|20100525 team meeting]].

= Server support resources =
The server team offers support for server-related questions in #ubuntu-server.

 * The [[https://wiki.ubuntu.com/UbuntuBots|ubottu]] irc bot makes it easy to share an extensive set of [[http://ubottu.com/factoids.cgi|factoids]] to others in an irc channel. E.g. typing {{{!ask | noobie}}} will cause ubottu to tell noobie that folks should just go ahead and ask their questions. Ubottu can also conveniently show the channel information on bugs and packages. See [[https://wiki.ubuntu.com/UbuntuBots|ubottu]] for more details.

= Tester resources =

We coordinate our testing plans in the [[Testing/Server|Server testing section]] of the [[Testing|Testing project]].

New test plans should be defined as new pages below [[Testing/Server]]. Example: Testing/Server/My''''''Test''''''Plan.

=== ISO testing ===

Ubuntu Server iso testing follows the process described in [[Testing/ISO]]. We focus on testing the ubuntu-server isos following the [[Testing/Cases/ServerInstall|Server installation test cases]]. The [[http://iso.qa.ubuntu.com/|Iso testing tracker]] is used to track test results.

You can register with the iso testing tracker and subscribe to the ubuntu server testcases so that you'll be notified whenever a new ubuntu-server iso needs to be tested.

=== UTAH ===

The Ubuntu Test Automation Harness introduces new way of creating end-to-end automated test cases without having to worry about the provisioning side of things. This tool is an attempt to unify the current automated testing for Ubuntu Jenkins.
 * [[Testing/UTAH|UTAH Server Testing]]

= Documentation resources =

This area is involved with updating and creating new content for the [[http://doc.ubuntu.com/ubuntu/serverguide/C/index.html|Ubuntu Server Guide]] and the [[https://help.ubuntu.com/community/|community help website]]. We're working with the DocumentationTeam and focus on server related topics.

<<Anchor(serverguide)>>
== Ubuntu Server Guide ==

The current development version of the Ubuntu Server Guide is located in [[https://code.launchpad.net/~ubuntu-core-doc/ubuntu-doc/natty|a bazaar branch]] (lp:ubuntu-docs) hosted on Launchpad. There is also [[http://doc.ubuntu.com/ubuntu/serverguide/C/index.html|an html version]] available online.

Here are the steps to modify the Ubuntu Server Guide and ask the DocumentationTeam to review your changes:

 * Create a directory where you'll put your local working version of the Ubuntu Server Guide:

{{{
$ bzr init-repo ubuntu-docs
$ cd ubuntu-docs
}}}

 * Get the ubuntu-docs files that have the latest version of the Ubuntu Server Guide:
{{{
$ bzr branch lp:ubuntu-docs
$ cd ubuntu-docs
}}}
NB: that command can take some time as the whole history of the branch has to be downloaded from Launchpad.

 * Update the Ubuntu Server Guide files using your favorite editor. They can be found in the {{{serverguide/C/}}} directory.
 * Once your changes are complete, commit them:

{{{
$ bzr commit
}}}
And send them to the ubuntu-doc mailing lists with the bzr send command:
{{{
$ bzr send --mail-to=ubuntu-doc@lists.ubuntu.com
}}}

Alternatively you can attach a diff of your changes to the associated bug report (do this before you commit your changes).
{{{
$ bzr diff > doc-change.patch
}}}

There is alot of useful information about making changes to system documentation in the DocumentationTeam/SystemDocumentation wiki page.

== Community wiki ==
 * The [[https://help.ubuntu.com/community/WikiGuide|WikiGuide]] has guidelines for contributing to the help website.
 * If help is needed, the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-doc|ubuntu-doc mailing list]] and #ubuntu-doc on irc.freenode.net are good places to ask around.

The Ubuntu Team wiki, at [[https://wiki.ubuntu.com/]], is focused on documentation for Ubuntu community contributors rather than for end users


= Developer resources =

The [[https://wiki.ubuntu.com/|Ubuntu Team wiki]] is the central location where Ubuntu developers exchange ideas and track their progress.
  * UbuntuDevelopment gives an overview of the development processes.
  * The [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel|ubuntu-devel mailing list]] and #ubuntu-devel on irc.freenode.net are the places where ubuntu developers can be found.


= Team policy =

=== Membership ===

The Membership policy is described in [[ServerTeam/Membership|Membership]].

=== Reporting ===

The ServerTeam has a section in the [[TeamReports| monthly report]]. We try to get status reports on a weekly basis on the day preceding the IRC meeting. The [[ServerTeam/ReportingPage| ReportingPage]] is used to gather the outcome of the tasks done by the ServerTeam members during the week.

The montly report is a subpage under [[ServerTeam/ReportingPage]]. It's a summary from the Meeting minutes and the "a Month in the archive" post.

The subpage is automatically included in the [[TeamReports| monthly team report]] with a macro as defined in the ServerTeam wiki page.

=== IRC meeting ===

We hold IRC meeting regularly to report about current tasks and define new ones. The [[ServerTeam/Meeting| Meeting]] page presents the Agenda for the next meeting.

[[ScribesTeam/MootBot|MootBot]] can be used to record the meeting.

irclogs are available on http://irclogs.ubuntu.com/.

==== Publishing the minutes ====

Once the meeting is over, minutes are prepared to summarized the outcome of the meeting.
 1. Go to [[MeetingLogs/Server]] and use the form to create a new entry using the format YYYYMMDD. This will create a new page for you with the [[ServerTeamMeetingLogTemplate]].
   a. Move the agenda from [[ServerTeam/Meeting]] to agenda section.
   a. Copy in the IRC logs from the "Minutes" link at the end of the meeting. This can be found on [[http://ubottu.com/meetingology/logs/ubuntu-meeting/]]
   a. Updated the minutes section with a summary of each section. You can template to work from using the IRC minutes you found the IRC logs from. Then fill in each section with your summary.
 1. Update [[ServerTeam/Header]] to announce the next meeting date.
 1. Update the Agenda for the next meeting at [[ServerTeam/Meeting]]
   a. In particular, remove completed ACTIONS, add new ones
   a. Update the list of Chair/Scribes
      a. move yourself to the back
      a. send an email to the person who will chair next week
 1. Publish the minutes to the ubuntu-devel <ubuntu-devel@lists.ubuntu.com> and ubuntu-server <ubuntu-server@lists.ubuntu.com> mailing lists. Use the subject "Server team meeting minutes: YYYY-MM-DD"
 

----
CategoryServerTeam
See ServerTeam

ServerTeam/KnowledgeBase (last edited 2019-12-10 22:29:10 by powersj)