Set up

Command line installation

For instructions about Drupal command line installation please visit the quick installation page on the Drupal website.

This tutorial provides ANU Drupal users with instructions on how to perform a manual installation of Drupal, with hints and tips for users on the IT Services shared webserver (doiweb-share).

Before you proceed with the installation you should be aware that Drupal is released in two major versions: Drupal 6 and Drupal 7. If you haven't decided which one to install, you may find the Drupal 6 vs Drupal 7 article useful.

Hosting requirements

To install Drupal you need to have a web host environment that meets specific requirements, which are different for Drupal 6 and Drupal 7.

information
Better results are achieved when the web host meets the recommended requirements.

Drupal users are also encouraged to assess the pros and cons of different hosting solutions available at ANU (ie virtual private server and shared server).

Manual installation

Step 1. Download Drupal core

Both Drupal 6 and Drupal 7 can be downloaded from the Drupal Core project page on the Drupal website.

The file is either a compressed tar archive folder (.tar.gz) or a standard compressed folder (.zip), depending on the format you choose.

Step 2. Upload Drupal core

Upload the Drupal core folder to the root directory of your webserver and extract its content in your site's root folder (ie your-site.anu.edu.au/).

information
Some web hosts don’t allow archives to be extracted on the webserver and users may have to extract the files locally before uploading them.

Step 3. Create the database

Make sure you have access to a database managing tool on your webserver (ie phpMyAdmin).

  1. Create a new, empty database. Make sure to keep a record of the database name.
  2. Create a database user. Make sure to keep a record of the user username and password.
information
doiweb-share users may not have access to phpMyAdmin by default, and should log a job to DOI Helpdesk requesting a new database to be created. IT Services will send a notification with the database details when the database is provisioned.

Step 4. Create the configuration file

Both Drupal 7 and Drupal 6 come with a sample default.settings.php file located in the sites/default/ folder.

Make a copy of this file, rename the copy to settings.php and upload it back to the folder. The sites/default/ folder should now contain both the default.settings.php and the settings.php files.

Step 5. Grant file and folder permissions

Change the settings.php file and sites/default/ folder permissions to be written by everyone ('others').

If your system expects numeric values to change file’s and directory’s permissions, use the following values:

  • 0666 for the settings.php file;
  • 0777 for the sites/default/ folder.
information
doiweb-share server users may not be able to change file system permissions, and should instead log a job to DOI Helpdesk requesting the settings.php file and sites/default/ folder permissions to be changed.

Step 6. Run the installation script

In your browser navigate to your site base URL, where the Drupal files are located (ie 'your-site.anu.edu.au/'). This will take you to the first page of the installation. Follow the instructions below to complete the installation.

  1. Select an installation profile: choose 'Standard' and click 'Save and continue'.
  2. Choose language: 'English (built-in)' is the default and only available option in the standard configuration. Click 'Save and continue'.
  3. Database: enter the name of the database, and user's username and password created earlier.
    information
    If your database is located on a different server you’ll have to specify a different database host. To do so expand the 'Advanced options' fieldset, delete 'localhost' and enter the database server location in the 'Database host' field. doiweb-share users should log a job to DOI Helpdesk requesting the location of the database host.
  4. Site information: enter the site name and email address and the details of the first administrator account (User 1) (in Drupal 7 the user section is called 'Site maintenance account'). In the 'Server settings' section you may configure the site's default country and time zone. In the 'Update notifications' it is recommende to keep the 'Check for updates automatically' and 'Receive e-mail notifications' checkboxes enabled, so that the system will notify the site's administrator about updates and important security releases.

Once the installation script had run you'll be automatically logged in to your new Drupal site as User 1.

Any subsequent login will have to go through the standard Drupal login form located at 'your-site.anu.edu.au/?q=user' or 'your-site.anu.edu.au/user' if 'clean URLs' is enabled.

Step 7. Restore/set folder and file permissions

After the installation process is completed remember to restore the settings.php file and sites/default/ folder permissions.

The settings.php file permissions should be writable by 'owner', but not 'group' or 'others' (rw-r--r--). In CHMOD the numeric value should be 0644.

The sites/default/ folder should be writable by 'owner', 'group', but not 'others' (rwxr-xr-x). In CHMOD the numeric value should be 0755.

Finally, the sites/default/files folder should be assigned to the group the apache user belongs to (ie 'webgroup' in doiweb-share).

information
doiweb-share users should log a job to DOI Helpdesk requesting the file and folder permissions to be set accordingly to the instructions above.

Step 8. What next?

Now your Drupal site is successfully installed. If your Drupal site is required to be ANU branded visit the Theming Drupal at ANU section for more information on how to install the ANU Acton theme and  manage your ANU site profile.

The Download section contains other modules, developed specifically for ANU, to extend your Drupal site functionality.

You may also browse the Knowledge base to find out more documentation on how to use Drupal.

alert
Please note that all new or redesigned ANU sites must be approved prior to publication. Please visit the ANU Web Style Guide website for more information.

 

Updated:  20 February 2017/Responsible Officer:  CMBE & CPMS Web Admin/Page Contact:  CMBE & CPMS Web Admin