Installing Nova

Nova 1 Getting Started Install Guide

Installing Nova on your server is a relatively painless process that should only take a few minutes if you have all the pieces you need at the start. In order to install Nova on your server, you'll need the following information:

  • Your database location (localhost or another means of connecting)
  • Your database name
  • Your database username & password (these may or may not be the same as your FTP username & password ... if you have questions, contact your host)
  • Your FTP username & password

Step 1: Upload Nova

To begin with the install, you must upload the Nova files up to your server.

Step 2: Configuring Nova

Before you can begin the installation, there are a couple steps you need to do.

Database Connection

The first thing you'll need to do before installing Nova is to set up your database connection parameters. If the connection isn't setup properly, you won't be able to connect to the database to create the tables needed and insert the necessary data. To set your database connection parameters, open application/config/database.php. Several variables on the page need to be filled out in order to continue.

Simply fill in the variables with your own values, making sure that you don't remove any of the quotation marks in the process.

$db['default']['hostname'] = "localhost";
$db['default']['username'] = "username";
$db['default']['password'] = "password";
$db['default']['database'] = "database_name";
$db['default']['dbdriver'] = "mysql";
$db['default']['dbprefix'] = "nova_";

Explaining the Parameters

  • hostname - this is the hostname of your database server. In most cases, this is localhost, but if your host is setup differently or uses a socket, you may have to change this connection parameter.
  • username - this is the username you use to identify yourself to the database server. This isn't necessarily the same as your FTP username, so make sure you check with your host about what your database username is.
  • password - this is the password you use to authenticate yourself to the database server. This isn't necessarily the same as your FTP password, so make sure you check with your host about what your database password is.
  • database - this is the name of your database and tells Nova exactly where to look for the database tables and where to install the data. If you don't know what this is, contact your host.
  • dbdriver - the database driver is the type of database you're using. Currently, Nova allows MySQL and MySQLi connections to the database. For most users, MySQL is the best option, but if you know you have the mysqli interface on your server and are using a server with PHP 5 and MySQL 4.1 or higher, you can optionally choose to run Nova through the mysqli interface instead.
  • dbprefix - Nova uses a database prefix before each table name to allow you to install more than one instance of Nova in the same database or even to have multiple systems running from the same database. By default, this is set to nova_, but you can change it to something else if need be.

Advanced Options

For users who have hosts with other options, CodeIgniter allows setting whether or not to cache queries, where to cache them to, whether to use a persistent connection and allowing changes to the charcter set and collation of the database. Changing these settings is only recommended for advanced users or if absolutely necessary.

FTP Library

Nova allows users to upload their own images to the server and use them in their bios. In order to allow this feature, you have to configure the FTP library. In order to do that, you'll need to edit application/config/ftp.php.

  • hostname - this is the location of your server like you're connecting with your FTP client
  • username - this is your FTP username
  • password - this is your FTP password
  • port - this is the port you connect to your server over. If you use SFTP, use port 22, otherwise port 21 is fine.
  • passive - if your host requires a passive connection to the server, change this value to TRUE
  • debug - if you need debug information for your FTP connection, change this value to TRUE

Step 3: Setting Up Your Genre

By default, Nova ships with DS9 as the default genre, but you can change that to a wide variety of options. In order to change this information, open application/config/nova.php.

Simply change the genre code to the genre you want. A complete list of available genres can be seen directly above this line of code. Putting in a value that is not in this list and does not have an install file and assets directory will cause the system to break!

$config['genre'] = "DS9";

Other Options

The Nova config file also gives you other options to change. Besides changing your genre, you can also change the meta data associated with the site and RSS feed information.

Step 4: Install the System

Once you have updated the database connection config file and set your genre, you can begin to install the system by opening a browser and navigating to your site. Nova will immediately check to see if the system is installed and if it isn't, redirect you to the installation page. From there, you can choose to do a fresh installation of Nova. Follow the process through to install Nova into your database to use for your RPG. The steps of the install process are as follows:

  1. Create Nova database tables
  2. Insert basic data into the tables
  3. Create genre-specific tables and insert data into them
  4. Set up your player account and the character name, rank and position of your primary character
  5. Set up some basic system settings

Step 5: Post-Installation

On PHP 5 systems, Nova will attempt to change several permissions in order to ensure all the upload features and backup features work properly. If you are running a server that uses PHP 4 or your server doesn't support allowing scripts to change permissions, you will have to make those changes manually. If you don't know how to change file permissions on your server, contact your host.

You will need to make sure that several directories are writable (777) in order for all the upload features to work:

  • application/assets/images
  • application/assets/backups
  • core/logs

Log in with your AnodyneID to rate this article or submit the article for review.