Skip to content

kavismith/osticket-prereqs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 

Repository files navigation

osTicket logo

osTicket - Prerequisites and Installation

This tutorial outlines the prerequisites and installation of the open-source help desk ticketing system osTicket.

Environments and Technologies Used

  • Microsoft Azure (Virtual Machines/Compute)
  • Remote Desktop
  • Internet Information Services (IIS)

Operating Systems Used

  • Windows 10 (21H2)

List of Prerequisites

  • Create a Virtual Machine in Azure
    1. Create a resource group and create a windows 10 Virtual Machine
  • Install and Enable Internet Information Services(IIS)
    1. with CGI and Common HTTP features
  • Install PHP Manager for IIS
  • Install Rewrite Module
  • Install PHP 7.3.8
  • Install MySQL 5.5.62
  • Install osTicket v1.15.8
  • Install HeidiSQL

Create a Resource Group and Virtual Machine

image

Search for "resource groups" in the Azure Portal and create a new resource group specifically for your osTicket deployment.

image

Start by searching for "Virtual Machine" in the Azure Portal. Select your subscription and the newly created resource group.

image

In the instance details section, provide the following information:

  • Set your desired Virtual Machine Name.
  • Choose a region for your Virtual Machine.
  • Change the image to "Windows 10 Pro" to use this operating system.
  • Select a suitable size for your Virtual Machine, with 2-4 vCPUs to ensure optimal performance.
  • Create a username and password that you can easily remember; you will use these credentials to sign in to your remote desktop.
  • Make sure to check the licensing box for Windows 10/11 to ensure proper licensing for your operating system.

By following these steps, you will have configured the necessary settings for your osTicket environment in Azure, including setting up a suitable Virtual Machine with the specified operating system and resources.


Log into Remote Desktop

image

Search for "Virtual Machine" in the search bar within the Azure Portal and copy your VM's public IP address.

image

On your local computer, search for "Remote Desktop" and paste your VM's IPv4 address into the computer section, then press "Connect." A login box will appear; click on "Use a different account" and sign in using the username and password you created when setting up your Virtual Machine.

image

After successfully logging in, you will be greeted with the remote desktop welcome screen.


Download Your Files & Access IIS Features

image

In this section, download all the necessary files required for a proper osTicket installation.

image

Search for "Control Panel" in your Windows operating system and click on it. Within the Control Panel, locate and click on "Programs."

image

From the Programs section, select "Turn Windows features on or off."


Enable IIS Features

image

Click on the "Internet Information Services" box to ensure it is checked (blackened). Then, click on "World Wide Web Services."

image

Within the "World Wide Web Services" section, click on the "Application Development Features" drop-down and check the boxes for "CGI" and "Common HTTP Features."

image

After selecting these features, click "OK" and wait for the changes to be applied.


Download PHP Manager

image

Download PHP Manager and ensure that you accept all the terms and conditions during the installation process. If the installation encounters any issues, go back to the Windows Features panel and verify that the IIS (Internet Information Services) feature is enabled. After confirming the IIS feature is enabled, attempt to install PHP Manager again.


Download Rewrite_amd64_en-US

image

Download the "Rewrite_amd64_en-US" package and make sure to accept all the terms and conditions during the installation process.


Create PHP Folder

image

Open File Explorer, click on "This PC," then select the "Windows C" drive. Right-click on an empty space within the drive, choose "New," and then select "Folder." Finally, name the newly created folder as "PHP."


Download PHP-7.3.8 file

image

After you have downloaded the PHP-7.3.8 file, right-click on it and select "Extract All."

image

Browse to locate the folder you created earlier, named "PHP," and select it. Then, click "Extract" to unzip the contents into the "PHP" folder.


Download VC-redist.x86.exe

image

Download and install the file named "VC_redist.x86.exe," and be sure to accept all the terms and conditions during the installation process.


Download MySQL & Creat MSQL Password

image

Download and install MySQL version 5.5.62.

image

During the installation process, select the "Typical" option to install the most common features

image

Choose the standard configuration

image

Set up your password for root login

image

And finally, click "Execute" to proceed with the installation.

Open IIS

image

Open the Internet Information Services Manager (IIS) as an administrator.

Register PHP from within IIS

image

Once the Internet Information Services (IIS) Manager is open, double-click on "PHP," then click on "Register new PHP."

image

Browse to the C drive, navigate to the "PHP" folder, select the "php-cgi" executable, and press "OK."

Reload IIS

image

Restart the server by clicking on vm-osticket to your left and then to your right select restart

Install osTicket v1.15.8

image

Download the osTicket installation files. Open two folders in Windows Explorer.

image

In one folder, navigate to "This PC" and select the C drive. Inside the other folder, open the osTicket folder.

image

Drag the "upload" folder from the osTicket folder to the "wwwroot" folder within the C drive's "inetpub" directory.

image

Finally, rename the "upload" folder by right-clicking it and selecting "Rename."

image

Restart IIS

image

To reset IIS, you can either click on "Restart" to the right or choose to stop it first and then start it again.

Click on "Browse*:80"

image

To access the osTicket installer, navigate to the left in the "Connections" section, go to "Sites," select "Default," and click on "osTicket." Then, on the right, you'll see the "Browse" section; click on "Browse*:80(http)."

image

This action will open the osTicket Installer in your web browser, where you'll be able to view the prerequisites and recommended features.

Enable PHP features for osTicket instillation

image

To enable the necessary PHP extensions for osTicket to run smoothly, you should open IIS (Internet Information Services), then access PHP. Once in the PHP settings, click on "Enable and Disable Extensions."

image

To ensure the smooth operation of osTicket, the "php_imap.dll" extension needs to be enabled.

image

Additionally, there are two other extensions that require enabling: "php_intl.dll" and "php_opcache.dll." image

After enabling all these extensions, refresh the osTicket browser, and you will notice that the extensions we just enabled will change from red "X"s to green checkmarks.

Rename ost-sampleconfig

image

Open File Explorer and navigate to "This PC." Click on the "Windows C" drive. Navigate further to "inetpub," "wwwroot," and then "osTicket." Locate the "include" folder within the osTicket directory. Scroll down to find the file named "ost-sampleconfig.php." Right-click on "ost-sampleconfig.php" and select "Rename."

image

Now, rename the file to "ostconfig.php."

Assignn Permission: ost-config.php

image

Right-click on the "ostconfig.php" file and select "Properties." In the Properties window, go to the "Advanced" tab.

image

Click on "Disable inheritance."

image

Next, select "Add a principal" and type in "Everyone" to provide permission to everyone. Click "OK" to confirm the "Everyone" permission.

image

In the "Basic permissions" section, check the box for "Full control." Finally, click "OK" to apply the changes and grant full control permission to the "ostconfig.php" file for everyone.

Continue setting Up osTicket in the browser(click) continue

image

Set up your system settings by adding the helpdesk URL, name, and a default email address. Additionally, configure your admin user settings, including the first and last name, email address, username, and password.

Download HeidiSQL

image

image

Download HeidiSQL

image

Create a new database by right-clicking on "unnamed," selecting "Create," then clicking on "Database,".

image

Finally, naming the database as "osTicket."

Set up Database Settings on osTicket

image

Set up the MySQL information within the osTicket installer. Use the username "root" and the password obtained during the MySQL download. Enter the database name as "osTicket,".

image

Finally, click "Install Now" to proceed with the installation.

image

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published