Difference between revisions of "Installation"
Jump to navigation
Jump to search
(→Lua) |
|||
(25 intermediate revisions by the same user not shown) | |||
Line 2: | Line 2: | ||
== Web == | == Web == | ||
− | First, you have to install GMOD Web. | + | First, you have to install the GExtension webpanel (GMOD Web). |
− | + | <ol> | |
− | + | <li>Download the installation files from [https://www.gmodstore.com/market/view/2899/download GmodStore]</li> | |
− | + | <li>Edit config.php</li> | |
− | + | <ul> | |
− | + | <li>'''Protocol''': 'http' or 'https'. Only use 'https' if you have a valid SSL certificate.</li> | |
− | + | <li>'''SteamAPI''': Key: Get your API Key from [http://steamcommunity.com/dev/apikey Steam]</li> | |
− | + | <li>'''Timezone''': Select the correct timezone from [http://php.net/manual/en/timezones.php this site]</li> | |
− | + | <li>'''MySQL''': Insert ''IP'', ''port'', ''user'', ''password'' and ''database''</li> | |
− | + | <li>'''SMTP''' (optional): Insert ''mailserver'', ''port'', ''username'', ''password'', ''alias'', ''security'' and ''method''. You can use [https://outlook.live.com outlook.com] if you do not have your own mailserver.</li> | |
− | + | </ul> | |
− | + | </li> | |
− | + | <li>Upload the files to your webserver</li> | |
+ | <li>'''(LINUX, self hosted)''' Set directory permissions: Your webserver needs read/write permissions for every GExtension file or folder. (Commands may differ per system)<br/> | ||
− | + | For default PHP:<br/> | |
− | + | <pre>chown -R www-data:www-data /path/to/gextension/ | |
− | + | chmod -R 770 /path/to/gextension/</pre> | |
− | chown -R | + | |
− | + | For PHP FastCGI/FPM:<br/> | |
+ | <pre>chown -R <CGI-USER>:www-data /path/to/gextension/<br/> | ||
+ | chmod -R 770 /path/to/gextension/</pre> | ||
+ | |||
+ | </li> | ||
+ | |||
+ | <li>Open the directory on your webserver using a browser</li> | ||
+ | <li>Press '''"Retrieve"''' to get your license</li> | ||
+ | <li>Press '''"Start"'''</li> | ||
+ | </ol> | ||
===Troubleshooting=== | ===Troubleshooting=== | ||
− | [[Troubleshooting | + | [[Troubleshooting]] |
== Lua == | == Lua == | ||
− | Attention: Your players may | + | Attention: Your players may lose their groups if you do not follow the instructions under "Groups and Bans" |
After installing the web part, you can now install the Lua addon. | After installing the web part, you can now install the Lua addon. | ||
− | #Open GMOD Web with your webbrowser | + | #Open the GExtension webpanel (GMOD Web) with your webbrowser |
#Click on the '''bullhorn (further named "Admin") -> Settings -> Update''' | #Click on the '''bullhorn (further named "Admin") -> Settings -> Update''' | ||
#Click on the "Lua" button and save the ZIP file | #Click on the "Lua" button and save the ZIP file | ||
− | #Extract the files to a folder and navigate to ''"gextension/lua/gextension/config/"'' | + | #Extract the files to a '''local''' folder and navigate to ''"gextension/lua/gextension/config/"'' |
#Edit ''sh_config.lua'' to your needs. Required: WebURL | #Edit ''sh_config.lua'' to your needs. Required: WebURL | ||
#Edit ''sv_config.lua'' and insert your MySQL data (same that you used for GMOD Web) | #Edit ''sv_config.lua'' and insert your MySQL data (same that you used for GMOD Web) | ||
#Upload the folder into your server's addon folder | #Upload the folder into your server's addon folder | ||
− | #[[ | + | #[[MySQL|Install MySQLoo]] |
#Restart your server and connect | #Restart your server and connect | ||
Latest revision as of 19:10, 11 April 2020
This article will lead you through the installation process of GExtension.
Contents
Web
First, you have to install the GExtension webpanel (GMOD Web).
- Download the installation files from GmodStore
- Edit config.php
- Protocol: 'http' or 'https'. Only use 'https' if you have a valid SSL certificate.
- SteamAPI: Key: Get your API Key from Steam
- Timezone: Select the correct timezone from this site
- MySQL: Insert IP, port, user, password and database
- SMTP (optional): Insert mailserver, port, username, password, alias, security and method. You can use outlook.com if you do not have your own mailserver.
- Upload the files to your webserver
- (LINUX, self hosted) Set directory permissions: Your webserver needs read/write permissions for every GExtension file or folder. (Commands may differ per system)
For default PHP:
chown -R www-data:www-data /path/to/gextension/ chmod -R 770 /path/to/gextension/
For PHP FastCGI/FPM:
chown -R <CGI-USER>:www-data /path/to/gextension/<br/> chmod -R 770 /path/to/gextension/
- Open the directory on your webserver using a browser
- Press "Retrieve" to get your license
- Press "Start"
Troubleshooting
Lua
Attention: Your players may lose their groups if you do not follow the instructions under "Groups and Bans"
After installing the web part, you can now install the Lua addon.
- Open the GExtension webpanel (GMOD Web) with your webbrowser
- Click on the bullhorn (further named "Admin") -> Settings -> Update
- Click on the "Lua" button and save the ZIP file
- Extract the files to a local folder and navigate to "gextension/lua/gextension/config/"
- Edit sh_config.lua to your needs. Required: WebURL
- Edit sv_config.lua and insert your MySQL data (same that you used for GMOD Web)
- Upload the folder into your server's addon folder
- Install MySQLoo
- Restart your server and connect
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.
- Open GMOD Web with your webbrowser
- Navigate to Admin -> Settings -> Servers
- Create a new serverbundle with a fitting name (for example "TTT") and select your server
- 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