Important!
To install osTicket, your web server must have PHP 4.3 (or better) and MySQL 4.1 (or better) installed. If you are unsure whether your server meets these requirements, please check with your host or webmaster before proceeding with the installation.
You will need one MySQL database with valid user, password and hostname handy during installation. MySQL user must have FULL privileges on the database. If you are unsure whether you have these details or if the user has sufficient permissions, please consult your host or database admin before proceeding.
osTicket requires that the PHP directive short_open_tag be on. Depending on your server permission level - the directive can be set on in the file php.ini, .htaccess or httpd.conf.
Getting Started
At this point you should have downloaded latest osTicket. Uncompress the files and upload files and directories in upload directory to a directory of your choice on your server. For example /osticket/, /helpdesk/ or /support/ depending on your preference. Basic knowledge of using FTP is a plus at this stage. If you don't know how to use FTP, we would recommend you read the documentation supplied with your FTP client and learn the basics of uploading and setting permissions on files.
osTicket installer needs to be able to write and modify ost-config.php found in the include directory. Please follow the instructions given by the installer.
Using installation script
Once all of the above steps are complete, you can complete the installation and basic setup in a web browser. You can invoke the installer by simply browsing the osTicket URL e.g http://www.yourdomain.com/support. Alternatively you can enter the URL to it into your browser address bar e.ghttp://www.yourdomain.com/support/setup/
osTicket's installation script will attempt to auto-detect paths and any permission issues. Please follow the instructions to finish up the installation process.
- If the script spots any configuration errors then it will not allow you to continue until the errors are corrected.
- If everything checks out, you will be presented with a form to fill in the information that osTicket now requires.
- If any errors occurs, go back and check the data entered.
- On valid data the script will create and populate the database plus write a configuration file.
Note that the installer performs basic configuration required to get osTicket up and running. Further configuration is required, post-install, to make the system fully functional.
Installing osTcket Using Fantastico In CPanel
osTicket can also be installed on CPanel based web hosting accounts using Fantastico.
From your CPanel, click on Fantastico and follow the instructions to install osTicket.
Important:
- The Fantastico default installation package (as of 9 Jan 2010) installs osTicket with the default email address of support@system.com. If you install using Fantastico you MUST immediately change your default email addresses in the main System Preferences and in your Department settings. Please see http://osticket.com/forums/project.php?issueid=142 for more detail.
- The Fantastico package for osTicket may not be as up to date as the latest release available on osTicket.com. Please check the osTicket.com website for the most up to date version.
Finishing Up
If the setup script has finished running with no errors, then congratulations osTicket is installed. You can now log in with the username and password you created during the install process. After verifying that the installation completed correctly - your next step should be to fully configure your new support ticket system for use. But before you get to it please take a second to cleanup.
- Change permission of
include/ost-config.phpto remove write access - Delete
setupdirectory - Enable the system
Once you have done the above, you can proceed with the next step, Post-Install Setup.
Having trouble
We can help install and configure osTicket to your needs.
Self-Help Troubleshooting
If you can not find any solutions to the problem you are having, you can enable the "Show Errors" flags located in /main.inc.php:
#Don't display errors
ini_set('display_errors',0);
ini_set('display_startup_errors',0);
Change this to
error_reporting(E_ALL);
ini_set('display_errors',1);
ini_set('display_startup_errors',1);
Then errors should be displayed either in your web browser or in your server's error.log file.
Some users have reported blank pages when they submit a form - in some cases, errors will not display. The work around for this is to try submitting the form in different manners (such as leaving all of the form defaults, or filling in all the fields).
Moreover, don't forget to check your osTicket Dashboard page and your mail server log.
Article has been taken from **Osticket.com**
