start work on panel@1.3.0 upgrade guide

This commit is contained in:
Matthew Penner 2021-01-20 22:39:35 -07:00
parent 7fda053b6a
commit 0080cb19b6
4 changed files with 53 additions and 8 deletions

View File

@ -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)

View File

@ -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
```

View File

@ -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

View File

@ -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