Squiz Matrix Virtual Machine Quick Start Guide

This quick start guide will help you set up your virtual machine.

You would have received your virtual machine either by downloading it from the download page or on a DVD. If you have a DVD, copy the included Squiz Matrix VM.zip file onto your local machine.

Once you have copied the file onto your local machine or the download has completed, make sure that you complete the steps outlined in the Squiz Matrix VM Setup Guide. This guide will take you through the process of extracting the ZIP file and locating the virtual machine file. If you have a DVD, a copy of this guide is located on the DVD.

Starting up the virtual machine

To start up the virtual machine, double click on the Squiz Matrix.vmx file. The first time you do this, VMWare will ask if you have copied the image or moved it. Select "I copied it" and press OK. The VM will now boot up and you will eventually be presented with a login prompt, as shown below.

Log into the virtual machine using the following details:

Login: root
Password: squiz

Changing the root password

Now that you have logged in with the default password, you should change the root password to be something only you know. This ensures that your virtual machine is secure. You can do this by entering the command passwd and pressing enter. You will be asked to enter a new UNIX password twice. Once completed, you will see a confirmation message:

matrixdemo:~# passwd
Enter new UNIX password: 
Retype new UNIX password: 
passwd: password updated successfully

Your password has now been updated. Please note that this is not the password for the Squiz Matrix interface and this root password can only be changed using the passwd command on the virtual machine.

Setting up the hosts file on your local machine

The hosts file is a file that is used to map host names to IP addresses. A host name is like a URL (for example www.squizsuite.net). When you type this into your browser, your computer looks at its hosts file first to find its IP address. If it finds it, it will display the site. If not, it will ask your internet service provider to find it. Because the URL you are using for the VM is not a publicly registered URL (i.e. your internet service provider does not know about it), you need to add it to the hosts file on your local machine.

Finding the IP address of the VM

Before you can set up the hosts file, you need to find the IP address of the VM. Enter the following command:

ifconfig eth0

You will see something similar to what is shown in the image below. The IP address of the VM is displayed in the inet addr field and is highlighted yellow in the image below. Keep a note of this IP address as you will need it later.

Editing your local hosts file

Note: this step is for editing the local hosts file, not the hosts file of the VM.

If you are using Windows, the hosts file is located at C:\Windows\System32\drivers\etc\hosts

You can edit this file by opening it with a text editor on your machine. Please note that to edit this file you need to have administrator access to your machine. If you do not have administrator access, you will need to contact your system administrator for help.

If you are using a Mac, you need to make sure you open this file using the sudo command or you will not be able to save it. A quick way to do this is to open /Applications/Utilities/Terminal.app and then type in:

sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit /etc/hosts

You will need to enter the password you use to log into OS X and you will need to have an administrator account.

For both Windows and OS X, add the following line into the hosts file, making sure that you change the IP address to be the same as the IP address of your VM:

172.16.228.130 matrixdemo.squiz.net

Don't forget to save the file.

Logging in and using Squiz Matrix

Squiz Matrix is now running on your machine. You can now log into your new Squiz Matrix system and get started straight away. To do this:

• 1. Go to the following URL in a web browser: http://matrixdemo.squiz.net/_admin
  
  Please ensure that you use a web browser that is supported by Squiz Matrix. You can see the list of supported web browsers on the requirements page.
  
  If the URL is not working, try restarting your web browser and then go to the URL again.
• 2. When you see the login screen, log in using the following details:
  
  

  Username: root
  Password: root

To help you get started with Squiz Matrix, it is recommended that you read the manuals available on the Squiz Matrix User Manual Library. Specifically, the Concepts manual will take you through the basics and lead you into more advanced concepts.

Changing the root password

Once you have logged into Squiz Matrix, you should change the password of the root user.

To change the password of the root user:

• 1. Click My Details in the asset map My Space tab.
• 2. Click the Acquire Lock(s) button.
  
• 3. Enter a new password.
• 4. Click the Commit button.