Custom Domains in PWP

Custom Domains in PWP esembrat3 Fri, 02/20/2015 - 14:08

By default, your Professional Web Presence (PWP) website will be accessible through a URL like so:

    http://pwp.gatech.edu/sitename

However, any PWP website on can be set up with a custom domain name.  Please read our guide to custom domain names for a full explanation of the options available to you.

Requirements

Custom domain names are not required for PWP websites, and you can add a custom domain later on after you have built out your website.

For an outside (non-Georgia Tech) domain name, some extra steps must be followed when setting up your domain name with an outside service.

Obtaining a Custom Domain Name

Please see the Domain Name Guide for terminology definitions.

Custom Georgia Tech Sub-Domain Name

We highly recommend that you use a custom sub-domain name within the department that is most closely associated with your website and/or your employment at Georgia Tech.  It is usually quicker and easier to obtain this kind of domain name, which looks like subunit.something.gatech.edu, where "subunit" is most any name except "www" (which is reserved as an alias for the unit's top-level domain).

To obtain a custom sub-domain, submit the following message to your local IT support through their standard support channel, replacing "subunit.something" with the actual name that you want:


Hi,

I would like to request the subdomain subunit.something.gatech.edu be created as a CNAME for pwp.gatech.edu.  Please let me know when this subdomain has been added to campus DNS.

Thank you,

Your Name Here


Custom Georgia Tech Top-Level Domain Name

If your website is for a major unit of Georgia Tech or a very high level project or activity/event, then you can request a custom top-level domain name.  However, be aware that it will take longer to obtain the necessary approvals, so you should consider using a sub-domain name (see the previous section) if one could work well enough for your website.

To obtain a custom top-level domain, you must submit the following message directly to support@oit.gatech.edu, replacing "something" with the actual name that you want:


Subject:  Request for New DNS CNAME something.gatech.edu

Hi,

I would like to request the custom domain name something.gatech.edu be created as a CNAME for pwp.gatech.edu.  The purpose of this domain name is for a new website to represent [insert here a description of your major unit or high level project, activity, or event].

Thank you,

Your Name Here


After receiving notice from OIT that your domain name has been added to the campus DNS system, follow the steps in the next section (Setting up the Custom Domain Name in WordPress).

Setting up the Custom Domain Name in WordPress (PWP)

Warning! Do not complete these steps until you have received confirmation that your new domain name (or sub-domain name) has been added to the campus DNS system.  If you complete these steps before your domain name is added to the campus DNS, you will lock yourself and everyone else out of your website.  If this should happen, contact the PWP administrators ( webpresence@gatech.edu ) for assistance.

  1. Log into the administrative interface for your PWP website (http://pwp.gatech.edu/wp-admin)
  2. From the My Sites drop-down menu item on the top menubar/toolbar, select your website.
  3. From the left-hand administration menu, select Tools -> Domain Mapping
  4. Enter the new domain name in the text box, select the Primary domain for this blog checkbox, and select Save.

Alternatively, you can email the PWP administrators ( webpresence@gatech.edu ) and ask them to add your new custom domain name to your site.  Be sure to specify both the custom domain name you had created, and the current URL for your PWP website.

Technical Details

A few considerations for using a custom domain:

  • The DNS record should (preferably) be a CNAME for pwp.gatech.edu.

Domain Configuration Resources

Courtesy of the Domain Mapping plugin that is utilized by PWP for supporting custom domain names:


Your users should go to Tools->Domain Mapping where they can add or delete domains. One domain must be set as the primary domain for the blog. When mapping a domain, (like 'example.com') your users must create an A record in their DNS pointing at that IP address. They should use multiple A records if your server uses more than one IP address. If your user is mapping a hostname of a domain (sometimes called a "subdomain") like http://www.example.com or blog.example.com it's sufficient to create a CNAME record pointing at the blog server hostname (NOT IP address).


Off-Campus Domains

Off-Campus Domains esembrat3 Tue, 11/15/2016 - 09:11

For any off-campus domain (e.g. a domain that does not end in .gatech.edu), a few more steps are required for configuring the domain beyond setting the custom domain for a site in PWP.

Process

Proper setup of the off-campus domain (and its www.{customdomain} alternative) require the following:

  • Use a host record with the "same as domain" setting and without a reverse (PTR) record. For the record data, use the actual IP address for PWP (143.215.248.18).
  • Create a CNAME for 'www' that maps to the host record you just created.