From b93b747e863a4097bf933921c5f21d81319cc9ec Mon Sep 17 00:00:00 2001 From: "alex.ita" Date: Mon, 11 Dec 2023 11:29:27 +0100 Subject: [PATCH] Updated installation/maintenance as per review request. - Added the C++ redistributables to the windows installation/maintenance; - Made the Linux steps less distro specific; --- home/server-installation.html | 9 +++++---- home/server-maintenance.html | 9 +++++---- 2 files changed, 10 insertions(+), 8 deletions(-) diff --git a/home/server-installation.html b/home/server-installation.html index 22b63ad..0f4a3e7 100644 --- a/home/server-installation.html +++ b/home/server-installation.html @@ -51,6 +51,7 @@ dateCreated: 2020-06-17T21:05:01.162Z

For the Linux installation, see the next step.

Please ensure you have port-forwarded before attempting to host a server! Without you ports being forwarded, you cannot host a server to the public!

    +
  1. Ensure you have installed the Visual C++ Redistributables in order to run the server.
  2. Download the server executable from beammp.com. You should end up with an executable file, called something like BeamMP-Server.exe.
  3. Once downloaded, make a folder somewhere and put the BeamMP-Server.exe there. This is where your server will live.
  4. Start the server once by double-clicking on it. This will generate all the necessary files for you, once you see text you can close it and proceed to the next step. You should see a Server.log file and a ServerConfig.toml file next to your BeamMP-Server.exe.
    5. @@ -65,10 +66,10 @@ dateCreated: 2020-06-17T21:05:01.162Z
    1. Ensure you have the dependencies installed which are listed here.
    2. Go to BeamMP.com and click the “Download Server” button, you will be redirected to the server's Github release page.
      3. -
    3. Download the correct version for your distro (Debian/Ubuntu).
      4. -
    4. Once downloaded, you should see one file called BeamMP-Server-debian or BeamMP-Server-ubuntu depending on the version you've downloaded, among others which you can ignore for now. Make a folder somewhere and put the BeamMP-Server-debian (or BeamMP-Server-ubuntu) there. This is where your server will live.
      5. -
    5. Open a terminal, go to that folder you put the BeamMP-Server-debian (or BeamMP-Server-ubuntu) in, and run chmod +x BeamMP-Server-debian (or sudo chmod +x BeamMP-Server-ubuntu). This ensures that you have permissions to run it.
      6. -
    6. Start the server once by running it with ./BeamMP-Server-debian (or ./BeamMP-Server-ubuntu). This will generate all the necessary files for you, once you see text you can close it and proceed to the next step. You should see a Server.log file and a ServerConfig.toml file next to your BeamMP-Server-debian (or BeamMP-Server-ubuntu).
      7. +
    7. Download the correct version for your distro. For sake of semplicity it will be called BeamMP-Server-xxx from now on, where xxx denotes the version for the distro you're using.
      8. +
    8. Once downloaded, you should see one file called BeamMP-Server-xxx, among others which you can ignore for now. Make a folder somewhere and put the BeamMP-Server-xxx there. This is where your server will live.
      9. +
    9. Open a terminal, go to that folder you put the BeamMP-Server-xxx in, and run chmod +x BeamMP-Server-xxx. This ensures that you have permissions to run it.
      10. +
    10. Start the server once by running it with ./BeamMP-Server-xxx. This will generate all the necessary files for you, once you see text you can close it and proceed to the next step. You should see a Server.log file and a ServerConfig.toml file next to your BeamMP-Server-xxx.
    11. (optional) It is heavily recommended to set up a user called beammpserver (or similar), as we do NOT recommend running the server as root, sudo or with your personal user account. You should then take steps to make sure that you start the server as this user only.

    Now proceed to the next step.

    diff --git a/home/server-maintenance.html b/home/server-maintenance.html index f9e491d..e47d65a 100644 --- a/home/server-maintenance.html +++ b/home/server-maintenance.html @@ -219,6 +219,7 @@ dateCreated: 2021-06-20T08:48:03.720Z

    If you built from source, you just rebuild. Make sure to run git submodule update --init --recursive before you rebuild.

    On Windows

      +
    1. Ensure you have installed the Visual C++ Redistributables in order to run the server.
    2. Go to BeamMP.com and click the “Download Server” button.
    3. Once downloaded, you should see one file called BeamMP-Server.exe. We will call this one the “new executable”.
    4. Go to the folder where your current BeamMP-Server.exe executable is located (same folder where your ServerConfig.toml is, usually). We will call this one the “old executable”.
      5. @@ -227,11 +228,11 @@ dateCreated: 2021-06-20T08:48:03.720Z

      On Linux

      1. Go to BeamMP.com and click the “Download Server” button, you will be redirected to the server's Github release page.
        2. -
      2. Download the correct version for your distro (Debian/Ubuntu).
        3. -
      3. Once downloaded, you should see one file called BeamMP-Server-debian or BeamMP-Server-ubuntu depending on the version you've downloaded. We will call this one the “new executable”.
        4. -
      4. Go to the folder where your current BeamMP-Server-debian (or BeamMP-Server-ubuntu) executable is located (same folder where your ServerConfig.toml is, usually). We will call this one the “old executable”.
        5. +
      5. Download the correct version for your distro. For sake of semplicity it will be called BeamMP-Server-xxx from now on, where xxx denotes the version for the distro you're using.
        6. +
      6. Once downloaded, you should see one file called BeamMP-Server-xxx depending on the version you've downloaded. We will call this one the “new executable”.
        7. +
      7. Go to the folder where your current BeamMP-Server-xxx executable is located (same folder where your ServerConfig.toml is, usually). We will call this one the “old executable”.
      8. Replace the old executable with the new executable (for example by copying or moving the new executable into the folder).
        9. -
      9. Open a terminal in that folder where you just replaced the executable, and run sudo chmod +x BeamMP-Server-debian (or sudo chmod +x BeamMP-Server-ubuntu). This will make sure the server can be run.
        10. +
      10. Open a terminal in that folder where you just replaced the executable, and run sudo chmod +x BeamMP-Server-xxx. This will make sure the server can be run.

      Automated Updates

      The server does not support automatic updates or update notifications (yet).