NetBSD Developer Documentation: Information about the mirrors mailing list

Responding to mirrors@NetBSD.org mail

• Who can reply to mirrors@NetBSD.org mail?
• Are there any other tasks for the on call person?
• What information do we request of those running mirrors?
• Things to check before adding a new www mirror
• How do I add a mirror to our database / documentation?
• How do I add a CNAME alias for a mirror?

Responding to mirrors@NetBSD.org mail

Who can reply to mirrors@NetBSD.org mail? (top)

Mail to mirrors@NetBSD.org is handled by the same team appointed to handle mail to www@NetBSD.org. The instructions for that list will generally apply here with some additional considerations listed below. Naturally you can substitute "mirrors" for "www" in that document where appropriate.

Are there any other tasks for the on call person? (top)

The on call person should be taking primary responsibility for updating the mirrors page and communicating with admins at our mirror sites about any problems, questions or concerns. The on call person should also be responsible for updating the mirroring FAQ.

What information do we request of those running mirrors? (top)

If someone wants to mirror us, have them start by filling out the form at http://www.NetBSD.org/Documentation/mirror.html if they have not already done so.

Things to check before adding a new www mirror (top)

We prefer that our mirror sites run a separate virtual web server for a NetBSD.org mirror on a separate IP address, so that clients using http/1.0 still get to the correct web site.

To check to see if a new www mirror is a http/1.1 `host:' based virtual web server, try the following:

telnet netbsd.mirror.site 80
GET / HTTP/1.0 <cr>
<cr>

If you get what looks like NetBSD's index.html, things are ok. If not, try:

telnet netbsd.mirror.site 80
GET / HTTP/1.1 <cr>
Host: netbsd.mirror.site <cr>
<cr>

If only the latter works, they're using HTTP 1.1 virtual hosting.

How do I add a mirror to our database / documentation? (top)

Here's the details on updating mirrors.db and the relevant documentation.

• Add the new contact information into localsrc/admin/mirrors/mirrors.db. The different entries in mirrors.db are sorted alphabetically by country.
• Commit mirrors.db.
• If htdocs/mirrors/index.html is out-of-date, 'make update'.
• 'make' to regen htdocs/mirrors/index.html
• 'make commit' to commit htdocs/mirrors/index.html
• If it's a new www mirror, add it to the form at htdocs/index.html.

How do I add a CNAME alias for a mirror? (top)

To add a CNAME alias, you'll want to update localsrc/netbsd1_etc/namedb/prim/NetBSD.org. Also, please remember to update the SOA serial when making changes to this file. Afterwards, you should send a message to admins@NetBSD.org noting you've done so, and requesting an update.

If you are not comfortable editing the zone file yourself, send a message to admins@NetBSD.org noting what CNAME alias you want set up, and requesting they update after they've handled that.

Home Page

Developer Documentation