Dev Site Setup Guide

Development Site Setup

*As of 08/04/2020

1. Step 1 - Cloudways

1.1. Login

Username: piers.foster@xist2.com

Password: XGp01993851750

1.2. Add A New Application

You need to navigate to Applications along the top navigation bar.

From here, you will need to click “Add Application” in green in the top right corner.

You then need to choose the server that this application will sit on – We are using the Dev Server called “XIST2 DEV 01”.

Make sure you have selected the correct server, then click “Add Application”.

You are then brought to this screen, where you need to add some details on your new application.

Under ‘Select Application’, choose the most recent version of WordPress without any additional features – these can be added later if needed on that particular website.

Under ‘Name your App’, you need to add the URL for the website, so that we know what website this is for: www.testwebsitename.xist2dev.com

Under ‘Select your Project’, choose the correct project for this website.

We need to make sure things are assigned correctly here, so if Jon at twenty eighty is doing the project, it needs to go under his folder.

If Rob is doing them, it needs to be part of his project.

Then click ‘Add Application’.

This may take a couple of minutes as it has to set itself up on the server.

1.3. Configure the New Application

Once added, you need to go into the application settings here:

Then you need to set up the Folder and the From Address.

Folder will be called something like “test_website_name”.

The From Address will need to be called “webform@testwebsitename.xist2dev.com”

You then need to go to Domain Management to set the Primary Domain to “testwebsitename.xist2dev.com”.

Finally, you need to go to Access Details to set the Application Credentials.

You will need to set a Username and Password – These can be changed later if needed.

Then you need to copy the Public IP, Username and Password – These are required later when using FileZilla and to provide to the developer.

You also need to copy down the Username and Password under ‘Admin Panel’.

These are what lets the developer into the back office of the blank site to configure settings.

You will need these details at the end of this guide to send to the developer - called ‘WordPress login details’.

2. Step 2 – TSO Host

2.1. Login

Username: piers.foster@xistgroup.com

Password: XGp01993851750

2.2. Configure TSO Host

Go to Services > My Services.

Search for xistgroup in the top right corner.

Click the Vidahost Unlimited Plan that is marked as Active - the middle one here.

Search in the top right for "xist2dev".

This will bring to the page below.

Then click Manage Website (blue button) for xist2dev.com - the bottom entry in this case.

Then click on Custom DNS under Advanced Management Tools.

That will bring you to this page:

Here you can filter the results to check that this doesn’t already exist by searching the name in the Filter search bar on the top right of the results section.

If the site you are adding isn’t already added, click Add A New Record near the top of the page (green button).

This brings you to this tab:

You will need to set the Record Name to “testwebsitename” – the “.xist2dev.com” is automatically added as this is the website it is part of.

This will be the site URL, so this is what you will need to search in ‘Step 4 – Test and Send’, to prove that it’s working.

You will also need to add the Content - this needs to be the Public IP address you copied earlier from ‘Step 1 - Cloudways’.

Then click Add Record.

3. Step 3 – Filezilla

3.1. Install Filezilla

If you don’t already have Filezilla installed on your machine, you need to get this.

You can find this here: https://filezilla-project.org/download.php?type=client

You need to make sure you are installing a compatible version too, so if you’re using windows, makes sure you download the windows compatible version etc.

3.2. Setup New Site

Once Filezilla is installed, open it up and press Command + S.

You should see the Add New Site popup like this:

You need to set the top drop down to be SFTP.

The Host needs to be set to the Public IP you copied earlier.

Then you need to set a logical Username under User: testwebsitename

Then set a Password as whatever you used before in ‘Step 1 - Cloudways’ for the section on Application Credentials.

Make sure these details are copied and saved so that we can access them in future if needed.

Press Connect at the bottom of the window.

3.3. Configure Website

Then you should come to this screen here - just with slightly less detail:

You will need to double click the public_html file in the top right section.

This will reveal the files held there in the bottom right section of the application.

Here you need to right click and click Create New File.

You will get a popup asking for a name for the file.

You will need to call this “.htpasswd”.

Then select both .htaccess and .htpasswd, right click and click View/Edit as shown below:

This will open up two files that you will need to edit like this:

You need to add the following code to the .htaccess file exactly as shown above:

AuthName "Authorisation required."

AuthType Basic

AuthUserFile /home/master/applications/test_website_name/public_html/.htpasswd

require user client

Then replace the name for the new site you are creating.

You then need to save it with Command + S.

Then you need to add the following code to the .htaccess file exactly as shown above:

client:$apr1$o9lyfhgY$LTsSVn62pa0njQ2Zye38s0

This file will have been empty to begin with, so just needs this line of code.

Then hit Command + S again to save this one too.

4. Step 4 – Test and Send

4.1. Test

Now that you have completed all the steps above, you should be able to test the site is accessible.

Search the site URL we set in Step 2 e.g. testwebsitename.xist2dev.com

You will get a popup asking for login details like this:

This is what we just set up in FileZilla.

You need to use the following details to access the site:

Username: client

Password: client

You should then see this on your screen:

If so, you have successfully set up the Dev Site and can now pass the details on to the developer.

4.2. Details for Developer

They need to be sent the following:

Site URL: testwebsitename.xist2dev.com

Popup Username: client

Popup Password: client

WordPress Username:

WordPress Password:

You also need to provide the details you copied down in Step 1 too:

Step 1 Public IP:

Step 1 Username:

Step 1 Password:

Dev Site Setup Guide

Dev Site Setup Guide

Contents:

1. Step 1 - Cloudways

1.1. Login

1.2. Add A New Application

1.3. Configure the New Application

2. Step 2 – TSO Host

2.1. Login

2.2. Configure TSO Host

3. Step 3 – Filezilla

3.1. Install Filezilla

3.2. Setup New Site

3.3. Configure Website

4. Step 4 – Test and Send

4.1. Test

4.2. Details for Developer