Code Monkey home page Code Monkey logo

osticket-prereqs's Introduction

1

osTicket - Prerequisites and Installation

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.

Environments and Technologies Used

  • Microsoft Azure (Virtual Machines/Compute)
  • Remote Desktop (RDP)
  • OsTicket

Operating Systems Used

  • Windows 10 Pro (22H2)

osTicket Installation Files

https://drive.google.com/drive/folders/1mKAD1ZaP1e3F0FInXuAlQ3Pcucz4Mb3O?usp=sharing

List of Prerequisites

  • 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

Installation Steps

img

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".

img

Click the "Create" tab at the top left.

img

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.

img

Click the notification tab at the top right and confirm that the resource group "RG-osTick" has been created.

img

Click the search bar and search for "virtual machine". Click "Virtual machines".

img

Click the "Create" tab at the top left and select "Azure virtual machine".

img

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.

img

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.

img

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.

img

The "Validation is in progress" message indicates that the Virtual machine is being created and configured. This process can take several minutes.

img

The message "Your deployment is complete" means that the Azure virtual machine (VM) has been successfully created and configured.

img

Click the search bar, and click "Virtual machines".

img

Click the virtual machine we just created.

img

Copy the Public IP address.

img

On your local computer search box, search for "remote desktop", and click "Open"

img

Paste your VMs Public IP address you copied and click the "Connect" button.

img

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".

img

We've now loged into our virtual machine. Select "No" for the options and click the "Accept" button.

img

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.

img

In your virtual machine, double-click the "Microsoft Edge" application to open it.

img

Click "Search without your data" > "Don't allow" > "Confirm and continue" > "Continue without this data" > "Confirm and start browsing".

img

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

img

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".

img

Type "control" and click the "Ok" button.

img

Click "Programs".

img

Click "Turn Windows features on or off".

img

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".

img

Collaps "Application Development Features" and expand "Common HTTP Features". Make sure all the boxes are checked, and click the "Ok" button.

img

The image above shows that the IIS web services are being installed.

img

IIS is now installed, click the "Close" button.

img

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.

img

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".

img

Click "Download".

img

Disregard the warning and click "Download Anyway".

img

After it's downloaded, double-click "File Explore" in the taskbar.

img

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.

img

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.

img

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".

img

Let's create the "C\PHP" directory.

Open File Explorer, click "This PC" and double-click "Windows C:".

img

In "Windows C:", right-click on an empty space, click "New", click "Folder".

img

Create a folder called "PHP"

img

Next let's download "php-7.3.8-nts-Win32-VC15-x86.zip".

Dowload it just as we did for previous files.

img

Go back to File Explorer and right-click "php-7.3.8-nts-Win32-VC15-x86.zip". Click "Extract All".

img

Click "Browse" > "This PC" and double-click "Windows C:",

img

Select "PHP" by clicking it once. Click the "Select Folder" button.

img

After selecting "PHP", click "Extract". Close File Explorer

img

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".

img

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".

img

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".

img

Let's register PHP from within IIS

Search for "iis" in the search box, click "Run as administrator".

img

Double-click "PHP Manager".

img

Click "Register new PHP version" and click the three dots (...). Double-click "PHP"

img

Select "php-cgi", and click "Open" > "Ok".

img

Reload IIS Manager by clicking "vm-osticket" in the left pane, and click "Restart" in the right pane.

img

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.

img

Let's rename the "upload" folder to "osTicket".

Right-click the "upload" folder and click "Rename".

img

It has now been renamed "osTicket". Reload IIS like we did earlier.

img

In IIS Manager, expand "Sites" > "Default Web Sites" and click "osTicket".

img

The osTicket installer web page will pop up.

img

Go back to IIS Manager. In "osTicket", double-click "PHP Manager".

img

Click "Enable or disable an extention".

img

Click "php_imap.dll", and click "Enable". Do the same for "php_intl.dll" and "php_opcache.dll".

img

Refresh the osTicket Installer web page and make sure some of the recommended extentions are marked green, like the image above.

img

Open File Explorer, click "This PC", double-click "Windows C:" > "inetpub" > "wwwroot" > "osTicket" > "include". Rename "ost-sampleconfig.php" to "ost-config.php"

img

Right-click "ost-config.php", and click "Properties".

img

Click "Security" > "Advanced" > "Disable inheritance" > "Remove all inherited permissions from this object".

img

Click "Add" > "Select a principle", and type "Everyone" in the box. Click "Check Names" and click "Ok".

img

Check "Full control" and click "Ok".

img

Click "Ok".

img

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.

img

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".

img

We are now connected to MySQL Server.

img

Let's go ahead and create a new database

Right-click "Unamed" and click "Create new" > "Database"

img

Name your database "osTicket" and click "Ok".

img

As you can see from the image above, the osTicket database has now been created. Minimize the window

img

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".

img

osTicket has now been installed.

img

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".

img

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".

img

Click "Security" > "Advanced", and select Everyone. Click "Edit", uncheck "Full control, Modify, Write", and click "Ok".

img

Click "Apply", and click "Ok".

img

Click "Ok"

osticket-prereqs's People

Contributors

collinsu99 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.