User Tools

Site Tools


en:install:provider

Install OCAx on a provider's site

Normally, you have found a website provider and you have paid them for your observatory domain name, some email accounts, a database, and a web space.

Installing OCAx isn't difficult for someone who knows how to upload files via FTP, and use databases with phpmyadmin.

Let's do it. (Remember that we can help at the Ágora)

The files

1. FTP

OCAx is made up of files, folders and subfolders, there are lots of them and you'll have to upload them to your web space. To do that, providers offer their clients FTP. Look for the FTP options your provider has given you in your website control panel and learn how to use it. When you are comfortable uploading files, continue.

2. Web root

All websites have a root folder where the first start page is kept. Let's see how that works.

Create a file on your PC and name it index.html. Edit it and paste this text into it ..

<html>
<body>
Hello world 1
</body>
</html>

.. and upload it to your web space via FTP into you root folder (it will be called public_html or something like that).
If you browse you observatory http://ocm-example.net you should see the text 'Hello world 1'

Now let's edit the file index.html in your PC a change it to read 'Hello world 2'

<html>
<body>
Hello world 2
</body>
</html>

This time, instead of uploading it to the root folder, create a sub-folder called 'app' in the server and upload it there.

 http://ocm-example.net           Hello world 1
 http://ocm-example.net/app/      Hello world 2

Now, before continuing with the next step, it's your turn to look at the options you provider has given you and see if you can configure your web root folder. Some providers make this option available, others don't.

You want to find out if you can configure the 'app' folder as the root folder, or not. We need to know this to configure OCAx.

 http://ocm-example.net   If you see 'Hello world 1',  use the Config. option 1
 http://ocm-example.net   If you see 'Hello world 2',  use the Config. option 2

You know which option is yours? You can delete the test.

3. Download OCAx to your PC

Find the latest version of OCAx here: http://ocax.net/download
Download it to your PC and decompress it.
Look at the content. There are tome files and two folders 1) app and 2) protected.

4. Download YII framework to your PC

OCAx uses the YII framework. We use YII 1, currently at version 1.1.16. Download it and decompress it. You'll se that it contains a folder called 'framework'. That's the folder we want.

5. Folder layout

According to the option you will use from Step 2. Web root, you have to organize your folder one way or another.

Config. option 1

  • Cut and paste the 'protected' folder inside the 'app' folder
  • Cut and paste the 'framework' folder inside the 'app' folder
  • Edit the lines 34, 35 and 43, 44 of the file app/index.php as shown in the image below
  • And last of all, upload all the content of the 'app' folder to the root folder on your server.

Config. option 2

  • Edit the lines 34, 35 and 43, 44 of the file app/index.php as shown in the image below
  • Upload the folders app, protected and framework to your server
  • Configure the folder 'app' as your root folder.

6. htaccess

Using FTP, find the file htaccess on your server in the root folder and change its name to .htaccess

The database

Your provider has probably given you:

  1. an empty database.
  2. a username and password to use the database.
  3. other connexion parameters like 'hostname' and 'port'
  4. management access to the database via the tool PhpMyAdmin.

Import the database

  1. Find the file schema.sql that you downloaded with OCAx and, using PhpMyAdmin, import it.
  2. Browse to http://ocax.net/download/budgetdescriptions/ and download the sql descriptions file. Import it with PhpMyAdmin.

Configure OCAx

Look again at the folder on your PC with you decompresses OCAx, find the file protected/config/main.example.php, rename it to main.php and edit it with the connection parameters your provider gave you.

Once edited, upload it to protected/config/main.php

And to finish..

You should be able to browse your new OCAx website. If you can, continue with the post-instalación configuration. If not, go over the steps above once again. If you need help, ask in the Ágora!

en/install/provider.txt · Last modified: 2015/08/09 22:54 by tuttle