Vivvo CMS - Installation Instructions

This installation guide provides documentation for the system requirements and installation instructions for this release of Vivvo CMS software. Process of installation is very easy and straightforward, you just need to follow the instructions. If in need of a help, please contact us at support@vivvo.net

Vivvo requires very little to run and most well configured web servers should be able to run it. Check this to ensure that you and your web host has the minimum requirements to run Vivvo.

You need at least the following:

1. Website - You must have a website in order to install the software. The software does not run on your PC, it runs on the actual computer that hosts your web pages.
2. PHP 5.2 - Your web server must have PHP 5.2 or greater. Your network administrator can download the latest version of PHP from http://www.php.net. PHP is extremely common though, and installed on virtually every webserver on Earth.
3. Apache web server - Vivvo won't work properly under IIS or other web servers.
4. XML Parser library - Expat (http://www.php.net/manual/en/ref.xml.php)
5. Remote connection - cURL extension or fsockopen() or file_get_contents() enabled
6. GD Library (libgd) - http://www.libgd.org/releases/
7. MySQL - Your web server must be setup to allow database access. MySQL 4.1 or later required. MySQL 5.x is highly recommended for best performance.

1. mod_rewrite - Apache Web server module required for usage of Search Engine Friendly URLs.
2. Zlib extension
3. ZipArchive class - Required for automatic install in Extend Vivvo plug-in.
4. Sendmail/SMTP - Required for optional email notification functionality.
5. FTP Access - You will be transferring files from your local computer to your website, so you will need some kind of “File Transfer Protocol” software. We recommend CuteFTP.
6. Write Access - You must be able to make files and directories writable on your web server. If the software doesn't have write access it won't be able to update its data files.

Before beginning the install you should do 4 things:

1. Make sure PHP is installed and configured on your server. You can do this by creating a file called phpinfo.php (or .php3) on your web server. This file should contain the following code:

   <?php phpinfo(); ?>

   This should, if PHP is installed correctly, produce a nicely formatted diagnostic page that gives you a lot of information about the current status of PHP on your system. Make sure this page contains a section entitled 'MySQL', if it does, you're ready to continue. If this section does not exist then you will have to contact your system administrator and have him/her reconfigure PHP with MySQL support.

2. You must check the status of MySQL. Make sure that MySQL is running on the system and that you have a valid username/password to use with Vivvo. If your MySQL user has access to create databases on the server this is all you have to do. If you do not have access to create databases please contact your system administrator and have them create a database for your install. Once you have a database to install into you are ready to continue.
3. Now you can upload files to your server using your favorite FTP program (like CuteFTP, Total Commander etc). Make sure to keep the folder structure as is. Use AUTO-DETECT mode when uploading files. Images need uploaded in BINARY and all other files need uploaded in ASCII. Using AUTO-DETECT mode will automatically handle this for you.
4. You have to change permissions to following files and folders:
   • /backup - chmod 777 (chmod 777 for every subfolder and chmod 666 for every file inside the backup folder and its subfolders)
   • /cache - chmod 777 (chmod 777 for every subfolder and chmod 666 for every file inside the cache folder and its subfolders)
   • /files - chmod 777 (chmod 777 for every subfolder and chmod 666 for every file inside the files folder and its subfolders)
   • conf.php - chmod 666 (for conf.php file in your Vivvo install folder)
5. Optionally, if you want to edit/modify template files from Layouts section, you will need to make template files writeable:
   • /templates - chmod 777 (chmod 777 for every subfolder and chmod 666 for every file inside the templates folder and its subfolders)
   • /themes - chmod 777 (chmod 777 for every subfolder and chmod 666 for every file inside the themes folder and its subfolders)

Open your favorite web browser and type in the address of your Vivvo install file. For example: http://www.YourSite.com/installer. Note: www.YourSite.com should be replaced with actual URL of your site. Alternatively, you can point your browser to the website root as well, it should redirect to installer page automatically. At this point, you should be presented with Installer welcome screen.

In a few moments you will be redirected to the first step where you should choose the language that you prefer to use during install. Available languages are sorted alphabetically. If available, the same language will be default language on your sites front-end and back-end panel.

Click on chosen language and then click Next step button.

After this you should see the next screen of the installer, where you will be presented with the system information, hence informed about proper configuration of your system files.

Items on Required list are mandatory in order to install and run Vivvo CMS properly. If a requirement from this list is highlighted with red you should contact your server administrator before you continue. If an item on Optional requirement list is not installed or enabled on your server it will be highlighted with yellow and you'll be able to continue install and run Vivvo CMS possibly without being able to use some function like e-mail features or friendly URLs etc.

Click on Next step to continue.

In this step you'll be prompted to enter your license number. Make sure to enter it correctly in full (with prefix, for example Standard-123456789). If you don't what is your license number you may find it in your Client area.

The installer also displays the product license. You need to accept the Software Licensing Agreement to complete the installation process successfully. Make sure to read it carefully.

If all tests are successful, and you entered correct license key and agreed to SLA, click on Next step button to reach the database configuration screen.

You need to have one database created on your server and insert its proper credentials (name, username and password) to set-up Vivvo tables. You can easily create a database using some site management tool like cPanel, Ensim, Plesk or similar. If you need assistance with this you should contact your hosting company.

There are also some optional fields and you'll see some predefined values entered for Website and Database Host. Just check if they are set correctly before proceeding. You may leave Table prefix field empty if you created empty database for Vivvo, but if another application uses the same database make sure to enter some table prefix to avoid overwriting existing tables.

Click on Next step to proceed and if all goes well your database has been set-up for Vivvo.

Next you will see a screen that prompts you for basic system preferences. This can be altered at anytime later in Administration area. However, it is important that you accurately enter Administrator user name / password because this is required to enter Administration area after installing the script.

Click Finish when you're done.

If all goes well you should be presented with a link to the administration panel where you can start building your website and adding content. You may also click on View website link and see how your website front-end looks now or go and read Vivvo CMS User Manual.

Congratulations, you have just installed Vivvo!

For security reasons it is suggested to change permissions to conf.php file - chmod 644.

Also, you might check the Security page for post-installation tips on tightening up your installation, or see how you can manipulate Vivvo configuration using CONFIG file.

You need to change the name of the folder called 'admin' to anything you want.

When renaming admin, you also need to update conf.php file:

define('VIVVO_FS_ADMIN_DIR', 'admin/');

Vivvo Support Center Home: http://www.vivvo.net/support_center.php

Support Forums: http://www.vivvo.net/forums

For assistance with using Vivvo CMS, contact our tehnical support: http://www.vivvo.net/contact.php