Skip to content

ktabi/osticket-prereqs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 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 Resource Group in Azure
  • Create a VM in the resource group
  • Enable / install IIS in windows
  • Download PHP Manager for IIS (PHPManagerForIIS_V1.5.0.msi) from Microsoft
  • Rewrite Module (rewrite_amd64_en-US.msi)
  • PHP 7.3.8 (php-7.3.8-nts-Win32-VC15-x86.zip)
  • Microsoft Visual C++ Redistributable(2015-2022)
  • Heidi SQL

Creating Resource Group and Virtual Machine in Azure

Create Resource Group

Screen Shot 2023-03-31 at 8 18 52 PM

Create a Resource Group; in this example I named mine RG-osticket.


Create a Virtual Machine Group

Screen Shot 2023-03-31 at 8 46 16 PM

Screen Shot 2023-03-31 at 8 48 20 PM

Screen Shot 2023-03-31 at 8 51 04 PM

Create a virtual machine and select the Resource Group we created earlier. Make sure the region is set to the same region we created our Resource Group and for the VM image choose window 10 Pro, version 21H2. Enter a username and password for the Administrator Account and make sure to rememeber it as we will use it to log into the VM. under the Networking allow Azure to create a virtual network, a subnet, and a public ip. Click on Review + Create to create the virtual machine.


Connecting to Microsoft Remote Desktop on a mac

Screen Shot 2023-03-31 at 9 17 51 PM

If you are using a macbook like I am in this example, you will have to download the Microsoft Remote Desktop from the app store.

Screen Shot 2023-03-31 at 9 21 24 PM

Screen Shot 2023-03-31 at 9 27 08 PM

After downloading Microsoft Remote Desktop, open the app and enter the Public IP address of the VM we created in the field of PC name. the IP address can be found in Azure by clicking on the virtual machine and looking in the overview.

Screen Shot 2023-03-31 at 9 30 14 PM

Enter the administrator information we provided while creating the VM. a message will appear click continue to log in to the VM.


Installation

Installing / Enabling IIS in widows

Screen Shot 2023-04-01 at 3 29 10 PM

Screen Shot 2023-04-10 at 7 38 52 AM

In the windows VM, search control panel and clicke on programs. In "Programs and Features" clicke on "Turn Windows Features on or off". A windows features box will appear check internet information services(IIS). Expand IIS by clicking on the plus sign next to it. Expand World Wide Web Services and expand Application Development Features. in Application Development Feautes check CGI. click ok. To check if we did it right, open a web browser and type in the loopback address 127.0.0.1 the default IIS web page should load up as seen in the second image.


  • Download PHP Manager for IIS (PHPManagerForIIS_V1.5.0.msi) from Microsoft
  • Download Rewrite Module (rewrite_amd64_en-US.msi) and create a directory called PHP in the root of the c: drive
  • Download PHP Version 7.3.8 and unzip the contents into the PHP Folder we just created.
  • Download Microsoft Visual C++ Redistributable(2015-2022)

Download MySQL Server 5.5. in the setup choose typical for type of setup and finish downloading. a new window will pop up asking to configure instance. select the "standard configuration". click next and leave the check on "Install As Window Service". click next and enter the a password in "New root password". Make sure to rememeber this password as it will be used to log in to your MySQL instance. click next and execute to finish installing.

Configuration in IIS

Screen Shot 2023-04-10 at 10 45 41 AM

Click on start type in IIS and run as an administrator. In IIS,you should see the PHP Manager we downloaded earlier. double click it and click on the Register new PHP version. Select the path of the new PHP by browsing to the PHP folder we created and selecting php-cgi. click ok and restart the server by clicking on the vm and clicking restart under the Manage Server.


Download osTicket

Download osTicket v1.15.8 from link

Screen Shot 2023-04-10 at 10 33 35 PM

Screen Shot 2023-04-10 at 10 37 47 PM

Screen Shot 2023-04-10 at 10 39 55 PM

Open two file explorer tabs. Extract and copy the “upload” folder into c:\inetpub\wwwroot. In the wwwroot, rename the upload folder to "osTicket. Return to the IIS manager.


Launching osTicket

Screen Shot 2023-04-10 at 10 51 45 PM

Screen Shot 2023-04-10 at 10 53 02 PM

In the IIS manager restart the server by clicking on the server and clicking on restart under Manage Server. Expand "Sites", "Default Web Site". Click on osTicket and click on Browse *:80 (http) under Manage Folder. If everything was set right, you should see osTicket open your web browser.

Screen Shot 2023-04-10 at 11 19 51 PM

Screen Shot 2023-04-10 at 11 22 10 PM

In IIS, click on osTicket and open PHP Manager. Click on enable or disable an extension, and enable the following:

  • Enable php_imap.dll
  • Enable php_intl.dll
  • Enable php_opcache.dll

Refresh the osTicket web page and observe the changes

Rename ost-sampleconfig.php to ost-config.php

Screen Shot 2023-04-10 at 11 40 42 PM

open file exploer and browse to C:\inetpub\wwwroot\osTicket\include\ost-sampleconfig.php. Change ost-sampleconfig.php to ost-config.php.


Setting Permissions

** we allow everyone to have access this file becuase it a lab and we will be using random users.

Screen Shot 2023-04-11 at 11 32 34 AM

Screen Shot 2023-04-11 at 11 33 45 AM

Screen Shot 2023-04-11 at 11 36 17 AM

Screen Shot 2023-04-11 at 11 37 46 AM

Screen Shot 2023-04-11 at 11 38 55 AM

Right-click ost-config.php, click properties and go to security. Click Advance and disable inheritance. click on "Remove all inherited permisiions from this object". Click Add and then Select a principel. Type in "everyone" and then check Names in the box "Enter the object name to select", and click ok. check full control to allow everyone permision to the file and click ok. click apply then ok to exit.

osTicket continuation

Screen Shot 2023-04-11 at 5 26 17 PM

Return to the osTicket in the browser and fill out the basic information about your instance. Think of it as you are an administrator in a company and you are signing up for osTicket to be used by your organization. Make sure the information used are documented somewhere as it will be used to sign in to osTicket later.


Download Heidi

Heidi SQL allows us to connect to the SQL server and create a database for osTicket to use.

Screen Shot 2023-04-12 at 7 28 20 AM

Screen Shot 2023-04-12 at 7 30 23 AM

Screen Shot 2023-04-12 at 7 31 32 AM

Install Heidi SQL version 12.3.0. After installing click New to create a new connection to the database. The default user name will be root, and enter the password you entered while creating the MySQL server. Click open to connect to the SQL server.

Create a new database in Heidi by right-clicking on Unnamed and hovering on Create New. Name the database osTicket or something you will remember

Screen Shot 2023-04-12 at 7 40 42 AM

osTicket continuation

Screen Shot 2023-04-12 at 7 45 38 AM

In the osTicket browser, finish setting up "Database Settings" and click install now. In my example I recieved an error stating "conflicts with system email above". This is because I used the same email for the Help Desk setting and administrator settings. If you did the same change one of the email and then proceed to install. you should get a page success page.

Screen Shot 2023-04-12 at 7 52 01 AM


Clean Up

  • Delete: C:\inetpub\wwwroot\osTicket\setup

Screen Shot 2023-04-12 at 7 58 19 AM

Navigate to the setup folder in osTicket and delete it

  • Set Permissions to “Read” only: C:\inetpub\wwwroot\osTicket\include\ost-config.php

Screen Shot 2023-04-12 at 8 02 23 AM

Screen Shot 2023-04-12 at 8 03 38 AM

Screen Shot 2023-04-12 at 8 04 25 AM

Navigate to osTicket and set permisions to Read and execute and Read.


Admin Login

url for Admin login: http://localhost/osTicket/scp/login.php

Screen Shot 2023-04-12 at 8 12 20 AM

And voila! we have come to the end of the osTicket Installation. There is a lot of moving steps but I hope this give you some perspective of what goes on behind the curtins of some of these applications.

Hope you check out my other posts to see some practices simulating real life ticketing.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published