Installation

From GExtension Wiki
Revision as of 21:11, 5 January 2017 by Ibot3 (talk | contribs)
Jump to navigation Jump to search

This article will lead you through the installation process of GExtension.

Web

First, you have to install GMOD Web.

  1. Download the installation files from ScriptFodder
  2. Edit config.php
    1. Protocol: 'http' or 'https'. Only use 'https' if you have a valid SSL certificate.
    2. SteamAPI: Key: Get your API Key from Steam
    3. Timezone: Select the correct timezone from this site
    4. MySQL: Insert IP, port, user, password and database
    5. SMTP (optional): Insert mailserver, port, username, password, alias, security and method. You can use outlook.com if you do not have your own mailserver.
  3. Upload the files to your webserver
  4. Set directory permissions (Linux)
  5. Open the directory on your webserver using a browser
  6. Press "Retrieve" to get your license key
  7. Press "Start"

Linux Only

  • You need to allow apache to access (read/write) the GExtension directory. You may use this command:
cd path/to/gextension
chown -R www-data:www-data *
chmod -R 777 *

Troubleshooting

"Could not update" + permission error

  • Permissions are not set up correctly. Repeat step 4.

"Access denied for user 'mysqluser'@'123.12.31.123' (using password: YES)"

  • You are using a MySQL user that doesn't has access. This is caused by wrong password, not whitelisted IP or insufficient permissions to the database.

Lua

After installing the web part, you can now install the Lua addon.

  1. Open GMOD Web with your webbrowser
  2. Click on the bullhorn (further named "Admin") -> Settings -> Update
  3. Click on the "Lua" button and save the ZIP file
  4. Extract the files to a folder and navigate to "gextension/lua/gextension/config/"
  5. Edit sh_config.lua to your needs. Required: WebURL
  6. Edit sv_config.lua and insert your MySQL data (same that you used for GMOD Web)
  7. Upload the folder into your server's addon folder
  8. Restart your server

The Lua installation is now finished and you should see that GExtension has connected to the database in the console. But to work correctly, you now need to assign your server to a serverbundle.

  1. Open GMOD Web with your webbrowser
  2. Navigate to Admin -> Settings -> Servers
  3. Create a new serverbundle with a fitting name (for example "TTT") and select your server
  4. After five seconds, you can see in the console, that the server found the bundle

Groups and Bans

Go to Admin -> Settings -> Groups and create all groups you have in GMOD with the EXACT SAME name.

Import users/bans from ULX or ServerGuard

Make these steps before players connect to your server. Import:ULX-ServerGuard

Troubleshooting

The most issues can be solved by just taking a look into the SERVER console:

"Access denied for user 'mysqluser'@'123.12.31.123' (using password: YES)"

  • You are using a MySQL user that doesn't has access. This is caused by wrong password, not whitelisted IP or insufficient permissions to the database.

GExtension is not initialized/Could not initialize

  • Take a look in the SERVER-console for errors. You may forgot to assign your server to a serverbundle.

You need to have tmysql4 or mysqloo installed

  • You do not have a mysql module installed. See tMySQL4

I lost my rank on the server

  • You most likely forgot to also set you a rank for the serverbundle. Navigate to Search -> Your Pofile and click on the pencil. Please note that the name of the web and gmod groups has to be the same (case sensitive!!!).