Pre-installation

Top  Previous  Next

Step 1. Unpack the archive

 

If you are using Unix or Linux ssh (shell access), then you will need to first upload the archive file to your server and put it in the root directory of your web site. Once you have done that, run the following command at the command line (not including the leading ">"):

 

> unzip omnistarlive55.zip

 

This will automatically create a directory on your server called "support55" and unpack all of the archived files into it.

 

OR

 

If you do not have shell access to your server, you will have to use an FTP program with capabilities as noted on the main page.

 

First, unpack the archive using a program such as WinZip. If you use WinZip, before you unzip the file you must go to Options -> Configuration -> Miscellaneous, and undo the option for "Tar file smart CR / LF conversion".

 

This will automatically create a directory on your hard drive called "support55" and unzip the files into it.

 

Step 2 (VERY IMPORTANT). Rename to support directory.

 

The program unzips to support55 sub-directory when you unzip it. Your license file is set to use sub-directory support instead of support55. Therefore, when you unzip the folder you should re-name it to support.

 

It you want to install the program in any other directory than support, please submit a support ticket and let us know the name of the sub-directory that you would like to use.

 

Make sure you DO NOT HAVE 2 sub-directories.

 

Therefore instead of having:

 

www.yourdomain.com/helpdesk/support

 

You should have:

 

www.yourdomain.com/support/

 

(Note: Replace yourdomain.com with the actual domain name)

 

Step 3. Create an empty database

 

Create an empty database using anything you want for the database name, username and password.  You will later fill out all this database information on our install page.  If you need help with this step then you should contact your hosting company.   If you use an existing database, ALL DATA WILL BE DELETED. Write down the database name, username, password, and host for future reference.

 

Step 4. Language Pack (optional) (English is default)

 

If you want your user pages to appear in another language other then English you can customize the file called:

 

english.php

 

Located in the lib directory.

 

If you ever need to update the language pack after you install, choose "Update Language Pack" from your administrator control panel.

 

Step 5. Installing Ioncube

 

Ioncube is a program that we use to encrypt our program and by you installing ioncube it will allow you to run our program and the Ioncube program also makes the php scripts run faster.  Ioncube is very simple to install and in most cases you will not have to do anything depending on your server configurations.  Follow the instructions below to see if you will have to install Ioncube or will it just work by default. 

 

First, open a browser window and go to the site www.YOURDOMAIN.com/support/ioncube/ioncube-loader-helper.php (replacing 'YOURDOMAIN' with your site name). Click the link 'run-time loading installation instructions'. The file runs a test to see if it's possible for your server to use a run-time loader which means that you do not have to do any installation of Ioncube.

After completing the test, you should see the test results "Run-time loading should be possible on your system." If these are not the results you receive from your test, you will need to contact your hosting company because a run-time loader is not possible. Usually, your host will have to either "Turn off 'safe mode'" OR modify the "php.ini" file. When you contact your host, provide the location of the ioncube helper file (www.YOURDOMAIN.com/support/knowledgebase/ioncube-loader-helper.php) so that they can see the results of the test you've just run.

 

If your host does not want to disable safe_mode then they can also install the ioncube loaders by making a change to the php.ini which will not require them to change safe_mode or any other configurations and they can download the loaders by going to www.ioncube.com

 

If your hosting company does not want to install ioncube then we also offer a version of our program that works with zend optimizer which is another popular program that does the same thing as Ioncube and is installed by default on most servers.  You should ask your hosting company do they have Zend Optimizer installed, if they do not support Ioncube.  You can let us know if you want the Zend version by submitting a ticket at http://support.omnistaretools.com and we will make sure you get the Zend version for our software.

 

If you have any questions or concerns, please submit a ticket to http://support.omnistaretools.com