This lab provides a step-by-step guide to installing osTicket, an open-source help desk ticketing system. It includes information on the prerequisites for installation and the installation process itself.
- Microsoft Azure (Virtual Machines/Compute)
- Remote Desktop (RDP)
- OsTicket
- Windows 10 Pro (22H2)
https://drive.google.com/drive/folders/1mKAD1ZaP1e3F0FInXuAlQ3Pcucz4Mb3O?usp=sharing
- Create a Resource Group
- Create an Azure Virtual Machine
- Install and enable IIS (Internet Information Services)
- Install "PHPManagerForIIS_V1.5.0.msi"
- Install "rewrite_amd64_en-US.msi"
- Create the "C\PHP" directory
- Extract "php-7.3.8-nts-Win32-VC15-x86.zip" to the "C\PHP" directory
- Install "VC_redist.x86.exe"
- Install "mysql-5.5.62-win32.msi"
- Register PHP from within IIS
- Install osTicket
Go to your Azure portal https://portal.azure.com/ and login. In your Azure home page, click the search bar and search for "resource group". Click "Resource groups".
Click the "Create" tab at the top left.
Select your Azure subscription, we will name the resource group "RG-osTicket". Select "(US) West US 3" for the Region, and click the "Review + create" tab at the bottom left.
Click the notification tab at the top right and confirm that the resource group "RG-osTick" has been created.
Click the search bar and search for "virtual machine". Click "Virtual machines".
Click the "Create" tab at the top left and select "Azure virtual machine".
Select your Azure subsription, select the resource group we created earlier "RG-osTicket", name the virtual machine "vm-osticket", select (US) West US 3 for the region, select "No infrastructure redundancy required" for the availability options, select "Standard" for Security type, select "Windows 10 Pro, version 22H2 - x64 Gen2 (free eligible services)" for Image, leave VM architecture as defualt, select "Standard_D4s_v3 - 4 vcpus, 16 GiB memory" for the Size. We will use "labuser" as the username, and make sure you use a unique password.
NOTE: Write down your username and password, we will need it later.
Leave "Public inbound ports" and select inbound ports" as default. Check the licensing box and click the Networking tab at the top.
The Virtual network (NIC), Subnet, and Public IP will automatically be created for us, so make sure they all say (new). Leave every thing as default, and click "Review + create" tab at the bottom left.
The "Validation pass" message indicates that all of the required information has been provided and that the VM can be created. Go ahead an click the "Create" tab at the bottom left.
The "Validation is in progress" message indicates that the Virtual machine is being created and configured. This process can take several minutes.
The message "Your deployment is complete" means that the Azure virtual machine (VM) has been successfully created and configured.
Click the search bar, and click "Virtual machines".
Click the virtual machine we just created.
Copy the Public IP address.
On your local computer search box, search for "remote desktop", and click "Open"
Paste your VMs Public IP address you copied and click the "Connect" button.
Click "More choices" > "Use a different account", go ahead and login with the username and password you used when you created your virtual machine, and click "Ok".
We've now loged into our virtual machine. Select "No" for the options and click the "Accept" button.
Select the "Yes" button.
Copy this link https://drive.google.com/drive/folders/1mKAD1ZaP1e3F0FInXuAlQ3Pcucz4Mb3O?usp=sharing
This link contains all the installation files we will need. We will open it up inside the virtual machine because it's much easier to deal with there.
In your virtual machine, double-click the "Microsoft Edge" application to open it.
Click "Search without your data" > "Don't allow" > "Confirm and continue" > "Continue without this data" > "Confirm and start browsing".
Paste the link you copied in the search bar and press the Enter key. We will come back to this page later.
We will now install and enable IIS
NOTE: Internet Information Services (IIS) is a web server that osTicket runs on. Microsoft created IIS, and it can be used to host a wide variety of websites and web applications.
Right-click the Start Menu and click "Run".
Type "control" and click the "Ok" button.
Click "Programs".
Click "Turn Windows features on or off".
Scroll to "Internet Information Services" and check the box; click the plus (+) to expand it. Expand "World Wide Web Services", expand "Application Development Features", go ahead and check "CGI".
Collaps "Application Development Features" and expand "Common HTTP Features". Make sure all the boxes are checked, and click the "Ok" button.
The image above shows that the IIS web services are being installed.
IIS is now installed, click the "Close" button.
To confirm if IIS was actually installed on our VM, open Microsoft Edge, search for "127.0.0.1" on the search bar, and click Enter.
NOTE: "127.0.0.1" is the loopback address, which is a special IP address that maps to the local computer. It's essentially saying, "Try to load a webpage that's running off myself". So, it loaded the default IIS website, which confirms that the webservices are working.
If it loads a page like the one in the image above, it means the installation was successful.
Next, we will download and install "PHPManagerForIIS_V1.5.0.msi".
Go back to the osTicket installation files web page, and click "PHPManagerForIIS_V1.5.0.msi".
Click "Download".
Disregard the warning and click "Download Anyway".
After it's downloaded, double-click "File Explore" in the taskbar.
Click "Downloads" and double-click "PHPManagerForIIS_V1.5.0". PHPManagerForIIS_V1.5.0 installation window will pop up. Click "Next", select "I Agree" and click "Next" > "Close".
Close File Explorer.
If you can't download any of the files, click the down arrow in the search bar, select "continue allowing automatic downloads of multiple files", and click "Done".
Go back to the osTicket installation files web page and download "rewrite_amd64_en-US.msi" just as we did for "PHPManagerForIIS_V1.5.0".
NOTE: The "rewrite_amd64_en-US.msi" allows osTicket to use URL rewriting. URL rewriting is a technique that allows us to change the way that URLs are displayed to users.
After it's downloaded, click "File Explore" in the taskbar. Double-click "rewrite_amd64_en-US", check the license agreement box, and click "Next" > "Install" > "Finish".
Let's create the "C\PHP" directory.
Open File Explorer, click "This PC" and double-click "Windows C:".
In "Windows C:", right-click on an empty space, click "New", click "Folder".
Create a folder called "PHP"
Next let's download "php-7.3.8-nts-Win32-VC15-x86.zip".
Dowload it just as we did for previous files.
Go back to File Explorer and right-click "php-7.3.8-nts-Win32-VC15-x86.zip". Click "Extract All".
Click "Browse" > "This PC" and double-click "Windows C:",
Select "PHP" by clicking it once. Click the "Select Folder" button.
After selecting "PHP", click "Extract". Close File Explorer
Next, let's download and install "VC_redist.x86.exe".
NOTE: "VC_redist.x86.exe" provides C++ runtime libraries (libraries that provide basic functionality for C++ programs, such as memory management, input/output, and string manipulation) that are required for osTicket to run
Go back to osTicket installation files web page and download "VC_redist.x86.exe". After it's downloaded, open File Explore, click on "Downloads", and double-click "VC_redist.x86.exe" to start the installation. Check the license agreement box and click "Install" > "Close".
Next, we will download and install "mysql-5.5.62-win32.msi".
Go back to osTicket installation files web page and download "mysql-5.5.62-win32.msi". Open File Explore, click on "Downloads", and double-click "mysql-5.5.62-win32.msi". Click "Next", check the license agreement box and click "Next" > "Typical install" > "Install" > "Finish".
Now, we will configure MySQL. Click "Next" > "Standard Configuration" > "Next" > "Next".
Let's set up our root username and password. Our password will be "Password1". Click "Next" > "Execute" > "Finish".
Let's register PHP from within IIS
Search for "iis" in the search box, click "Run as administrator".
Double-click "PHP Manager".
Click "Register new PHP version" and click the three dots (...). Double-click "PHP"
Select "php-cgi", and click "Open" > "Ok".
Reload IIS Manager by clicking "vm-osticket" in the left pane, and click "Restart" in the right pane.
Let's install osTicket. Go back to the osTicket Installation Files web page and download "osTicket-v1.15.8.zip".
Open two File Explorer windows For the first window, double-click "This PC" > "Windows C:" > "inetpub" > "wwwroot".
For the second window, click "Downloads", double-click "osTicket-v1.15.8", and drag the "upload" folder to the "wwwroot" folder in the first File Explorer window.
Let's rename the "upload" folder to "osTicket".
Right-click the "upload" folder and click "Rename".
It has now been renamed "osTicket". Reload IIS like we did earlier.
In IIS Manager, expand "Sites" > "Default Web Sites" and click "osTicket".
The osTicket installer web page will pop up.
Go back to IIS Manager. In "osTicket", double-click "PHP Manager".
Click "Enable or disable an extention".
Click "php_imap.dll", and click "Enable". Do the same for "php_intl.dll" and "php_opcache.dll".
Refresh the osTicket Installer web page and make sure some of the recommended extentions are marked green, like the image above.
Open File Explorer, click "This PC", double-click "Windows C:" > "inetpub" > "wwwroot" > "osTicket" > "include". Rename "ost-sampleconfig.php" to "ost-config.php"
Right-click "ost-config.php", and click "Properties".
Click "Security" > "Advanced" > "Disable inheritance" > "Remove all inherited permissions from this object".
Click "Add" > "Select a principle", and type "Everyone" in the box. Click "Check Names" and click "Ok".
Check "Full control" and click "Ok".
Click "Ok".
Go back to osTict Installation Files web page and download "HeidiSQL_12.3.0.6589_Setup.exe.docx".
NOTE: "HeidiSQL_12.3.0.6589_Setup.exe.docx" allows us to connect to our SQL server.
Go to "Downloads" folder and double-click HeidiSQL_12.3.0.6589_Setup" to install it.
Select "I accept the agreement", and click "next" > "Next" > "Next" > "Next" > "Install" > "Finish" > "Skip". A new window will pop up.
We are going to create a new connection to the database in this window.
Click "New", type in your username and password (Password1), and click "Open". This is the password we used when we created the "MySQL Server".
We are now connected to MySQL Server.
Let's go ahead and create a new database
Right-click "Unamed" and click "Create new" > "Database"
Name your database "osTicket" and click "Ok".
As you can see from the image above, the osTicket database has now been created. Minimize the window
Go back to the osTicket Installation web page and click "Continue". Fill in the information, and make sure you use "root" as your username and "Password1" as your password. Click "Install".
osTicket has now been installed.
Let's do some clean up. Open File Explorer, click "This PC", double-click "Windows C: > "inetpub" > "wwwroot" > "osTicket", right-click the "setup" folder, and click "delete".
We will now set the permissions for the "ost-config.php" file to "Read only"
Open File Explorer, click "This PC" and double-click "Windows C: > "inetpub" > "wwwroot" > "osTicket" > "include". Right-click "ost-config.php", and click "Properties".
Click "Security" > "Advanced", and select Everyone. Click "Edit", uncheck "Full control, Modify, Write", and click "Ok".
Click "Apply", and click "Ok".
Click "Ok"