README.md

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 Windows 10 (21H2)

List of Prerequisites

• Connect to your Virtual Machine with Remote Desktop
• Install / Enable IIS in Windows
• Install Web Platform Installer
• Install osTicket v1.15.8
• Download and Install HeidiSQL
• Created database for "osTicket
• Clean up
• Change File Permissions

Installation Steps

Note: Create a Windows 10 Virtual Machine with 2 or 4 virtual CPUS to ensure that you are not troubled with hiccups and slow movement throughout the lab. Allow the VM to create a new Vnet which should be done by default.

We can do a quick search for Virtual Machine and as we create the virtual machine, we will have the option to create the Resource Group. Here we select Create New to name the name the Resource Group 'RG-osTicket' and build out the Virtual Machine (VM) with the provided settings pictured (below).

Note: Be sure to check the box recognizing 'I confirm I have an eligible Windows 10/11 license with multi-tenant hosting rights.' or else you will receive a validation error message when you choose to 'Review + Create'.

We will need connect to our Virtual Machine with Remote Desktop using the VM's public IP address.

To connect to the virtual machine, we search on the local machine for 'Remote Desktop Connection' and the following window opens and you can now copy and paste the public IP address into the provided space. Then press the Connect button.

Once you are connected and inside the virtual machine we will need to install the Web Platform Installer. To install the Web Platform Installer we will search for the Control Panel --> under programs select Uninstall a Program.

After we've reached the next page, we can now select to Turn Windows features on or off --> then enable the 'Internet Information Services' (IIS) from the available services.

Now we can download and install Web Platform Installers. Web Platform Installers (WebPI) provides a simplified installation workflow for installing common open source web applications and web platform technologies.

Once WebPI is installed, we can now add MySQL 5.5 database, PHP 5.6.31, and the various verisons of between PHP (x86) 7.0 and 7.3.

MySQL 5.5 will require a name and password, root and Password1 respectively when you try to install. Make note of the name / password in a text file as you will need it again later on in the installation process.

If necessary, fix any failures (download from within lab files: Fix any failures in the installation by going to Google Drive to download and install PHP 7.3.8, PHP Manager, and Microsoft Visual C++ 2009 Redistributable Package.

From the downloaded files, we can now install and extract the osTicket file. Extract and copy the “upload” folder INTO c:\inetpub\wwwroot 3. Within c:\inetpub\wwwroot, Rename “upload” to “osTicket”

-Reload IIS (Open IIS, Restart the server)** 1. Go to sites -> Default -> osTicket 2. On the right, click Browse *:80

Once browse: 80 is selected a browser window will open presenting osTicket installer page along with the recommendation/prerequisites of use.

Next we'll go back to IIS, sites -> Default -> 1. osTicket 2. Double-click PHP Manager 3. Click Enable or disable an extension 1. Enable: php_imap.dll 2. Enable: php_intl.dll 3. Enable: php_opcache.dll -

Refresh the osTicket site in your browser to see what has changed after enabling the PHP extensions

Rename: From: C:\inetpub\wwwroot\osTicket\include\ost-sampleconfig.php ---> To: C:\inetpub\wwwroot\osTicket\include\ost-config.php

---

Assign Permissions: ost-config.php To change the permissions, right-click ost-config --> select 'properties' --> select the 'Security' tab at the top --> select the 'Advanced' button1. Disable inheritance -> Remove All 2. New Permissions -> Everyone -> All

Then add new permissions for everyone and give Full Control.

After returning to the browser windows with osTicket installer and press 'Continue', you will now see the below form to complete before continuing.

Download and install HeidiSQL from Google Drive using the provided defaults that are available in the install wizard.

---

Next we will do the following in HeidiSql:

1. Create a new session, username:root/password:Password1
2. Connect to the session
3. Create a database called “osTicket”

Created database for "osTicket":

After the database is created, we can now enter those details into osTicket Installer

MySQL Username: root

MySQL Password: Password1

Click “Install Now!”

Congratulations, hopefully it is installed with no errors!

Results below are from of choosing for "Your Staff Control Panel" or "Your osTicket URL:"

"Your osTicket URL" will direct us to the "End User" Portal where Users can submit tickets for assistance from the help desk.

- Clean up

1. Delete: C:\inetpub\wwwroot\osTicket\setup
2. Set Permissions to “Read” only: C:\inetpub\wwwroot\osTicket\include\ost-config.php
3. Login to the osTicket Admin Panel ([http://localhost/osTicket/scp/login.php](http://localhost/osTicket/scp/login.php))

   

   Set Permission to "Read" only can be acheived by choosing to right-click on 'ost-config.php' --> select properties --> select the 'Security' tab near the top --> then click the 'Advanced' button (not pictured below) --> once advanced settings is selected, you can now select the 'Everyone' principle and now we can select to choose 'Read' only as the preferred permission(s)

   

   

   
   

   💥Well, That's All Folks and Congratulations On The Completion of This Lab! 😁

   📝 “You don’ have to see the whole staircase. Just take the first step.”📝

   
   
   

   Next Up OSTicket Post Install Configuration