Getting started with your govCMS build, including forklift instructions

Follow the guidance below to start your govCMS Software as a Service (SaaS) site build.

Set up steps

1. govCMS distribution

Download the govCMS distribution from:

  1. your service provider’s development environment,
  2. Acquia Cloud Free, or
  3. Drupal.org.

2. GitHub account

Your agency needs to create a GitHub account. You’ll use it to store govCMS code files, such as your site theme. Creating a public repository is free. Once your site theme is uploaded, your account administrator needs to invite the 'govhosting' user as a collaborator (govhosting only requires read access).

3. Theme options

You can clone an existing govCMS public theme from https://github.com/govCMS, such as 'govCMS whitesites’, or your agency can choose to maintain a current site theme.

Development steps

1. Website in development

  1. Provide the govCMS Team with the following details:
    1. Technical contact(s) for the website (full name and email address)
    2. Site domain name (URL)
    3. Tentative forklift date
    4. Tentative launch (go-live) date
  2. Respond to the email you'll receive from our service provider about your SSL certificate. When the URL is confirmed, the govCMS Team will arrange for the URL to be added to the govCMS SSL certificate.
    Note: the provision of an SSL certificate can take up to 7 days.

2. Website completed

Allow a minimum of 2 weeks leading up to DNS switch (go-live) following completion of the site forklift.

  1. Provide govCMS with the following details:
    1. Your GitHub Theme Repository URL (or branch tag); and provide access to govhosting [at] finance.gov.au (Subject: Hello%20again) (if theme was not set up under the govCMS GitHub account)
    2. A copy of your site audit report - to obtain it, run the site audit script: URL - https://github.com/seanhamlin/site-audit. There is a govCMS profile to run (govcms_saas).
      See documentation on Github that shows how to run this: php bin/site-audit audit:site [alias] --profile=govcms_saas
    3. Site database access. Please provide in a drush archive. Ensure at least one person is assigned to a 'Site Builder' user role when moving users to the Admin role. (See guidance for Service providers at:https://docs.acquia.com/cloud/site/import/archive/create)
    4. Drush archive is uploaded to Google Docs account and access is provided to: govcms.au [at] gmail.com (Subject: Hello%20again) .

Forklift steps (govCMS Team to action)

The govCMS Team will arrange the forklifting (moving) of your site to the Acquia Cloud Site Factory - SaaS Platform).

Note: these details are not included in the govCMS Launch Plan and Checklist document.

  1. Forklift (allow 3-5 business days)
    Once completed, the govCMS Team will provide the URL and Shield (username and password) for your agency to commence user-acceptance testing (UAT).
  2. Site Audit (allow 3-5 business days)
    Any issues will be reported back to the agency. (Any Site Administrator permissions will be removed).

Launch plan and checklist

  1. When you have submitted the CNAME details to your DNS service provider for the DNS switch (see page 2 of govCMS launch plan and checklist), please raise an Acquia Insight support ticket to confirm the launch date and time.
  2. You may need to request your DNS service provider to complete a redirect service as govCMS can only list one URL on the SSL Certificate. You may also request your DNS servicer provider to complete a redirect to point www.agencyname.gov.au to agencyname.gov.au. For further information on DNS change for govCMS sites, please see the govCMS Community post Configuring an agency domain for SaaS hosting.
  3. Prior to the DNS switch, remove the Shield (username and password) by following these steps:
    1. Login to govCMS site
    2. Go to Configuration
    3. Select Shield
    4. Un-tick Enable shield module
    5. Select Save

Once the DNS switch is completed and the Shield has been disabled, the site will be live to the public.