From 0080cb19b61456404df486fb8fb3a73365625844 Mon Sep 17 00:00:00 2001 From: Matthew Penner Date: Wed, 20 Jan 2021 22:39:35 -0700 Subject: [PATCH] start work on panel@1.3.0 upgrade guide --- guides/php_upgrade.md | 43 ++++++++++++++++++++++++++++++++++-- panel/1.0/getting_started.md | 10 ++++++--- panel/1.0/upgrade/1.0.md | 4 +++- wings/1.0/upgrading.md | 4 ++-- 4 files changed, 53 insertions(+), 8 deletions(-) diff --git a/guides/php_upgrade.md b/guides/php_upgrade.md index baf89158..3bf39539 100644 --- a/guides/php_upgrade.md +++ b/guides/php_upgrade.md @@ -1,6 +1,45 @@ # Upgrading PHP -| Panel Version | PHP Version | -| ------------- | ----------- | +| Panel Version | PHP Version | +| ------------- | ------------ | | 1.0.0 - 1.2.0 | ^7.3 \| ^7.4 | | 1.3.0 | ^7.4 \| ^8.0 | + +## Install PHP 7.4 +In order to install PHP 7.4, you will need to run the following command. +```bash +apt -y install php7.4 php7.4-{cli,gd,mysql,pdo,mbstring,tokenizer,bcmath,xml,fpm,curl,zip} +``` + +Once you have installed PHP 7.4, you will need to update your webserver configuration. + +## Update Composer +As of `Panel@1.3.0` we require `composer` v2. To update composer you will need to run the following command. +```bash +composer self-update --2 +``` + +## Webserver Configuration +### NGINX +After upgrading to PHP 7.4, you will most likely need to update your NGINX configuration. + +By default, your webserver configuration should be located at `/etc/nginx/sites-available/nginx.conf`. + +You can open the file by using `nano /etc/nginx/sites-available/nginx.conf`, once the file is open you will need to +replace `fastcgi_pass unix:/run/php/php7.3-fpm.sock;` with `fastcgi_pass unix:/run/php/php7.4-fpm.sock;` +(this line will be located towards the end of the file). + +Once you have edited the file, you will need to reload nginx. You can do this by running the following command +```bash +systemctl reload nginx +``` + +If you were upgrading your Panel you may now continue that process. [1.X.X Upgrade Guide](/panel/1.0/upgrade/1.0.md#fetch-updated-files) + +### Apache +```bash +a2enmod php7.4 +a2dismod php7.2 +``` + +If you were upgrading your Panel you may now continue that process. [1.X.X Upgrade Guide](/panel/1.0/upgrade/1.0.md#fetch-updated-files) diff --git a/panel/1.0/getting_started.md b/panel/1.0/getting_started.md index 7d83b619..fb500b95 100644 --- a/panel/1.0/getting_started.md +++ b/panel/1.0/getting_started.md @@ -32,11 +32,15 @@ this software on an OpenVZ based system you will — most likely — not | | 10 | :white_check_mark: | | ## Dependencies -* PHP `7.3` or `7.4` (recommended) with the following extensions: `cli`, `openssl`, `gd`, `mysql`, `PDO`, `mbstring`, `tokenizer`, `bcmath`, `xml` or `dom`, `curl`, `zip`, and `fpm` if you are planning to use NGINX. +* PHP `7.4` or `8.0` with the following extensions: `cli`, `openssl`, `gd`, `mysql`, `PDO`, `mbstring`, `tokenizer`, `bcmath`, `xml` or `dom`, `curl`, `zip`, and `fpm` if you are planning to use nginx * MySQL `5.7.22` or higher (MySQL `8` recommended) **or** MariaDB `10.2` or higher. * Redis (`redis-server`) * A webserver (Apache, NGINX, Caddy, etc.) -* `curl`, `tar`, `unzip`, `git`, and `composer` +* `curl` +* `tar` +* `unzip` +* `git` +* `composer` v2 ### Example Dependency Installation The commands below are simply an example of how you might install these dependencies. Please consult with your @@ -206,7 +210,7 @@ If you are not using `redis` for anything you should remove the `After=` line, o when the service starts. ::: -If you are are using redis for your system, you will want to make sure to enable that it will start on boot. You can do that by running the following command: +If you are are using redis for your system, you will want to make sure to enable that it will start on boot. You can do that by running the following command: ```bash sudo systemctl enable --now redis-server ``` diff --git a/panel/1.0/upgrade/1.0.md b/panel/1.0/upgrade/1.0.md index f4bc544a..f065e768 100644 --- a/panel/1.0/upgrade/1.0.md +++ b/panel/1.0/upgrade/1.0.md @@ -14,6 +14,8 @@ running `php -v`. If you are not on PHP 7.4 or PHP 8, please see the [PHP upgrade guide](/guides/php_upgrade.md). +This upgrade also requires `composer` v2, which is also covered by the [PHP upgrade guide](/guides/php_upgrade.md#update-composer). + ## Fetch Updated Files The first step in the update process is to download the new panel files from GitHub. The command below will download the release archive for the most recent version of Pterodactyl and save it in the current directory. Now is a good time @@ -21,7 +23,7 @@ to ensure that you're in the `/var/www/pterodactyl` directory as the command bel into your current folder. ::: danger -`Panel@1.3.0` requires `Wings@1.3.0` in order to run properly! +`Panel@1.3.0` requires `Wings@1.3.0` in order to work properly! ::: ``` bash diff --git a/wings/1.0/upgrading.md b/wings/1.0/upgrading.md index 07b8b06d..e3ea2b52 100644 --- a/wings/1.0/upgrading.md +++ b/wings/1.0/upgrading.md @@ -4,8 +4,8 @@ Upgrading Wings is a painless process and should take less than a minute to comp ## Download Updated Binary First, download the updated wings binary into `/usr/local/bin`. -::: warning -`Wings@1.2` requires `Panel@1.2` in order to run properly. +::: danger +`Wings@1.3.0` requires `Panel@1.3.0` in order to work properly! ::: ``` bash