Setup

Tools Needed

Here is a list of tools required for the Azure v316 project.
You may need to download them if you don't already have them installed

• Git - Version Control Software
  • For advanced users
  • You can use the following command: choco install git if you are using Chocolatey to manage your software
  • Otherwise, install using the instructions from the Git Website
• GitHub Desktop/Sourcetree/GitHub CLI (OPTIONAL) - Git Desktop Client
  • Beginner-friendly option
• Java 20 JDK - SDK for Development
• IntelliJ - Java IDE
• MariaDB & HeidiSQL - Database Management and Administration
  • OR MySQL Workbench & WAMP/XAMP
• Azure v316 Server Source Code - See Setup Guide below for instructions
• Azure v316 Client - Test Client for Localhost

Supported versions:

	Target	Tested
Java SDK Version	Java 8 Update 231	Java 20
IDE	IntelliJ	IntelliJ
DB Management System	MariaDB	MySQL 5.7.28
DB Administration Tool	HeidiSQL	MySQL Workbench 8.0 CE with WAMP 3.2

*If a tool is not listed in the table, its version doesn't matter.

---

Setup Guide

1. Clone or Fork this repository

Here are 3 ways you can do this:

Option 1: GitHub Desktop Route (GUI)

• Make sure you have GitHub Desktop installed
• In the toolbar, click File -> Clone repository...
  • Alternatively use the keyboard shortcut Ctrl+Shift+O
    
• Click on the URL tab, and paste in https://github.com/SoulGirlJP/AzureV316
• Set the Local path as the folder where you want the source code to be stored
  
• Click Clone

Option 2: Sourcetree Route (GUI)

• Make sure you have Sourcetree installed
• In the toolbar, click File -> Clone/New...
  • Alternatively use the keyboard shortcut Ctrl+N
    
• In the Source Path/URL field, paste in https://github.com/SoulGirlJP/AzureV316
• In the Destination Path field, select the folder where you want the source code to be stored
  
• Click Clone

Option 3: Command Line Route

• Make sure you have Git installed
  • You can use the following command: choco install git if you are using Chocolatey to manage your software
  • Otherwise, install using the instructions from the Git Website
• Navigate to the folder you want to use
  • E.g. cd server_tools/azure
• Clone the repository
  • HTTPS: git clone https://github.com/SoulGirlJP/AzureV316
  • SSH: git clone git@github.com:SoulGirlJP/AzureV316.git
  • GitHub CLI: gh repo clone SoulGirlJP/AzureV316

2. Setup the DB management system

Either HeidiSQL or MySQL Workbench

• Add a new connection (see last point for example)
• By default the username may be set to root and the password left empty, with SSL disabled. Port should be set to 3306.
• Note: Encoding is eucKR (not UTF-8), if you need to know
• For MySQL Workbench, see Steps 1-4 in here for more details

3. Setup the DB administration tool

Either HeidiSQL or MySQL Workbench

• Run either one of the SQL script files found in AzureV316/sql/
• It should create a new schema named kms_316.
• Note: this will cause errors if MySQL Workbench is running in safe mode. Follow the error message instructions to disable safe mode.
• For MySQL Workbench, see Steps 5-6 in here for more details

4. Turn off innodb strict mode - MariaDB only

• This can be achieved by editing the .ini file in the install path of the DB management system, and requires a restart

5. Open the project in IntelliJ

• When the project is first opened, the IDE will automatically start indexing all the files
• Remember to allow the IDE to finish indexing
• See here if you have difficulty doing so

6. Configure project settings

IntelliJ: File -> Project structure

• Set the project SDK to an appropriate JDK version (see above in tech specs)
• Ensure that all the required libraries (in AzureV316/AzureMS/lib/) are imported.
• See here for references

7. Ensure that the details in Step 2 are reflected in the source code

1. Hit Shift twice to bring up the search menu, and search for mysql.
2. Select the first option.
   
3. Check the username and password strings in MYSQL.java are correct.
   • Have it match your DB settings from earlier!
   • This reference screenshot uses defaults

8. Compile and Run

Navigate to Azure_316\AzureV316\AzureMS\src\launcher to reach Start.java

• Try Build and Run this file. (HeidiSQL or WAMP should be running in background)
  
• Note that the first build/run may take quite a while!
• For subsequent runs, you may use the top right corner to run