nfinityX™ Database Upgrade

Upgrade procedure for the nfinityX™ Database package

Check the source you can access the nfinityX™ apt repository

Using the aptitude search you should be able to search the repository for nfinityX™ software. If you do not see an output similar to the above you will need to check that the source list is installed and aptitude has been updated.

Aptitude update

The nfinityX™ environment packages adds new sources and an aptitude update is required. Run the following command to update the source lists:

aptitude update

Upgrade the nfinityX™ Database package

To upgrade the nfinityX™ Database package enter the following command:

aptitude install nfinityX-db

The will check the repository and display if the package can be updated. Press Y to continue with the upgrade.

Unsigned Software Warning

The system may warn you that the software is unsigned, type “yes” to continue. The package will then be downloaded and upgrades will commence.

Backup settings files

You will be prompted to back up the existing database :

1. Backup the settings files . ( Generally if you are upgrading the database you should choose yes. Setting files are backed up to the /tmp directory )
2. Backup the database. ( this is done as a safety and the entire database is backup in the event of failure the database can be restored manually )
3. Dropping the database should only be done in the event that you are wanting to have a fresh instillation

Mysql Password

Enter the root mysql password and press enter

Confirm Database install

You will be prompted to confirm the database install, press y to continue.

Existing Backup Detected

The installer will detect backups and will ask if you want to restore from the back up. If you have experienced problems or an upgrade failed you should choose this option otherwise press n to continue with the upgrade.

Existing database detected

If an existing nfinityX™ database is installed the system will confirm the upgrade. Press y to continue.

Master – Slave Verification

You will be prompted to verify master and slave sources. Press y to continue with the upgrade.

The upgrade script will compare the database structures and prompt you for a confirmation if any tables require changing. All tables and data are backed up to the tmp directory prior to the upgrade process

Upgrade Complete

You will see the above message if the upgrade was successful

nfinityX™ Environment Upgrade

Upgrade procedure for the nfinityX™ Environment package

Check the source you can access the nfinityX™ apt repository

Using the aptitude search you should be able to search the repository for nfinityX™ software. If you do not see an output similar to the above you will need to check that the source list is installed and aptitude has been updated.

Aptitude update

The nfinityX™ environment packages adds new sources and an aptitude update is required. Run the following command to update the source lists:

aptitude update

Upgrade nfinityx™ package

To upgrade the nfinityX™ Environment package enter the following command:

aptitude install nfinityX-env

The will check the repository and display if the package can be updated. Press Y to continue with the upgrade.

Unsigned Software Warning

The system may warn you that the software is unsigned, type "yes" to continue. The package will then be downloaded and upgrades will commence.

General System Upgrade

System upgrade using aptitude

Check the source you can access the nfinityX™ apt repository

Using the aptitude search you should be able to search the repository for nfinityX™ software. If you do not see an output similar to the above you will need to check that the source list is installed and aptitude has been updated.

Aptitude update

The nfinityX™ environment packages adds new sources and an aptitude update is required. Run the following command to update the source lists:

aptitude update

Upgrade the system using aptitude

To upgrade the system run the following command :

aptitude upgrade

You will be presented with a list of packages that can be upgraded. Some packages may require user input. After reviewing the packages to be updated press y to continue.

First Run

Default administrator login into nfinityX™

Web Administrator Login

Using a web browser enter the url into the address bar. You will be presented with a login screen as seen above. Enter the system using the default credentials below

User : x-admin
Pass: x-pass

NOTE: For security reasons we recommend you change the default password on first login.

Install Complete

The system is now complete.

nfinityX™ Server Install

Installing nfinityX™ system software

Check the source you can access the nfinityX™ apt repository

Using the aptitude search you should be able to search the repository for nfinityX™ software. If you do not see an output similar to the above you will need to check that the source list is installed and aptitude has been updated.

Aptitude update

The nfinityX™ environment packages adds new sources and an aptitude update is required. Run the following command to update the source lists:

aptitude update

Install the nfinityX™ Application software package

To install the nfinityX™ software run the following command :

aptitude install nfinityX-svr

The system will request confirmation of the install, press Y to continue.

Unsigned Software Warnings

You may be prompted to confirm that you want to install unsigned software, type “yes” to continue.

Website Setup

If the nfinityX software will be run as the main / primary website on the server press Y. If you want to run the nfinityX™ software from an alias ( http://myservername/X3/ ) press N.

Re-parse the system modules

You can force the system to re-parse the installed modules by pressing “y”. If you choose to re-parse the modules you must login to the web interface in order to invoke the rebuild process.

nfinityX™ Database Install

Installing the nfinityX™ Database.

Check the source you can access the nfinityX™ apt repository

Using the aptitude search you should be able to search the repository for nfinityX™ software. If you do not see an output similar to the above you will need to check that the source list is installed and aptitude has been updated.

Aptitude update

The nfinityX™ environment packages adds new sources and an aptitude update is required. Run the following command to update the source lists:

aptitude update

Install the nfinityX™ database package

Install the nfinityX-db package using aptitude with the following command :

aptitude install nfinityX-db

You may get a warning that the software is not signed, type "Yes" to continue with the install.

Configuration

You will be prompted for the following information:

1. Enter the customer / installation name to be used for this install
2. Enter the mysql root password that was used in the environment setup
3. Enter the host name (This may be the local server or a dedicated mysql server)
4. Enter the user name you want to install the nfinityX database as. ( The system will create this user if it does not exist )
5. Enter the password for the user you specified in the previous step
6. Enter the Database name you want to use for the installation
7. Press Y to confirm the database installation

Install completed

If the install was completed successfully you will see the above message.

nfinityX™ Environment Install

Installing the base nfinityX™ environment package

Check the source you can access the nfinityX™ apt repository

Using the aptitude search you should be able to search the repository for nfinityX™ software. If you do not see an output similar to the above you will need to check that the source list is installed and aptitude has been updated.

install nfinityX™ environment package

To install the nfinityX-env package run the following command:

aptitude install update

Conflicts and dependencies

Apt will list all the packages and their dependencies and may need to resolve some conflicts as shown above. Take care if you are installing onto a server that has existing systems installed when resolving these conflicts. Enter Y to accept the suggested resolution.

Confirm packages install

The system will then request a confirmation that you want to install the packages listed. Press Y to continue

Unsigned software warning

You may get a warning that the software is not signed, type "Yes" to continue with the install. The system will now begin installing the various packages the were lists prior to this.

Mysql Server Setup

If the server does not have mysql on it you will be prompted to enter a password for the root mysql user. The system will request you to confirm the password before continuing

Note: Note down this password as it will be required in order to install the nfinityX™ Database package

Apt Library Source Setup

Adding the nfinityX™ source list to the server’s apt source lists.

Login onto the server

Using a shell login onto the server you will be installing nfinityX™ onto. If the root login is not enabled you may have to login with a standard account and switch to the root account by using the command:

su root

The system will request the root password to allow access

Download source list

To down load the nfinityX™ source list use the following command :

wget http://software.nfinityx.com/nfinityX.list

This will download the source list to the current directory on the server.

Add nfinityX™ source list to the servers apt list of sources

Move the downloaded source list ( nfinityX.list ) to /etc/apt/sources.list.d/ as seen above.

Update aptitude sources

Update the aptitude libraries with the following command

aptitude update

As seen in the diagram above, the source list has been added to the available source lists

Search the apt library

If the install was successful you should be able to search the repository for the nfinityX™ software using the command below:

aptitude search nfinityX

You should get an output similar to the one in the above diagram.

Requirements

Requirements

System

A base installation of Ubuntu server 10.10 or greater is required. The server should have a system drive for the Linux OS and nfinityX™ software with a mass storage / NAS system attached. The server specification will can vary dependent on the projected demand and usage, but it is recommended that a minimum of a quad core processor with 8Gig memory is used.

System preparation

The following should be in place prior to commencing an installation:

1. Install open-ssh server if not installed already (this is normally installed by default)
2. Add your mass storage device / NAS to the /etc/fstab and mount it under /usr/data (mounting methods may vary depending on the storage device)
3. Ensure that the server is able to connect to the internet.

Os System Update

It is recommended to run a system upgrade to ensure that the system is up to date with all the latest packages prior to installing by using the following command:

aptitude upgrade

Introduction

Overview

This manual is intended to serve as a installation, update and removal guide for the nfinityX server software onto Linux based servers. This document assumes that the user is both familiar with Linux Os and is comfortable using commands in the default bash shell.