MySource Mini Virtual Machine Quick Start Guide

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

You would have received your copy of the MySource Mini VM in one of two ways; either by downloading it from the download page or by receiving a copy on a DVD. If you have a DVD, copy the MySource Mini 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 MySource Mini VM Setup Guide. This guide will take you through the process of extracting the ZIP file and locating the MySource Mini 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 MySource Mini.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:

myminidemo:~# 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 MySource Mini editing 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 mini.squiz.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 myminidemo.squiz.net

Don't forget to save the file.

Logging in and registering your new URL

MySource Mini is now running on your machine. You can now log into your new MySource Mini system and register your URL. To do this:

• 1. Go to the following URL in a web browser: http://myminidemo.squiz.net/_edit
  
  Please ensure that you use a web browser that is supported by MySource Mini. 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: admin
  Password: password

• 3. Once you have logged in, the unregistered domain message will appear. Click the Register Domain button.
• 4. The editing interface will appear automatically once the URL has been registered.

Using MySource Mini

Now that you have set up your system, you can start using MySource Mini. The first time that you log into MySource Mini, the Help Desk will appear and show a list of general help articles.

To help you get started with MySource Mini, it is recommended that you read these help articles in the order that they appear in the Help Desk window.

If you want to view these articles in the future, follow these steps:

• 1. In the toolbar at the top of the screen, click the Help button.
  
• 2. In the Help Desk window, click the General Help Articles button. The list of general help articles will appear.

Setting up the admin user account

Once you have logged into the editing interface of MySource Mini, you should change the username, password and email address of the admin user account. If you do not enter an email address, we will be unable to contact you regarding any issues you submit. 

To edit the details of the user account:

• 1. In the toolbar at the top of the screen, click the Profile button.
• 2. Enter your email address into the Email field. You may also like to change the first and last name.
• 3. Enter a username and password.
• 4. Click the Save button.

Additional user accounts

By default, two additional user accounts are also created within the system; an editor and an approver. The editor user account can be used by a user that only needs to edit content within your site and the approver user account can be used by a user that needs to edit, approve and publish content.

The log in details for the editor user account are:

Username: editor
Password: password

The log in details for the approver user account are:

Username: approver
Password: password

If your site is going to be publicly accessible, it is recommended that you either change the password for these user accounts, make them inactive or delete them.