Install/2-0/ServerPackages: Difference between revisions
From Convention Master Documentation
No edit summary |
Silvershock (talk | contribs) (Updating page for 22.04/PHP 8.1) |
||
| Line 6: | Line 6: | ||
= Installing Software on the Server = | = Installing Software on the Server = | ||
This section of the guide will walk you through the configuration of a server running Ubuntu Server | This section of the guide will walk you through the configuration of a server running Ubuntu Server 22.04 LTS, on which Convention Master can run. If your server is not yet installed, you can follow the official Ubuntu guide to do so: | ||
https://tutorials.ubuntu.com/tutorial/tutorial-install-ubuntu-server | https://tutorials.ubuntu.com/tutorial/tutorial-install-ubuntu-server | ||
| Line 17: | Line 17: | ||
Once your server's operating system is installed, we can begin installing the packages you will need to run Convention Master. Log in as the user you created during installation (or any user with sudo rights), and input the following commands. | Once your server's operating system is installed, we can begin installing the packages you will need to run Convention Master. Log in as the user you created during installation (or any user with sudo rights), and input the following commands. | ||
<syntaxhighlight lang="bash"> | |||
sudo apt update | |||
sudo apt dist-upgrade -y | |||
</syntaxhighlight> | |||
These will ensure your server has the very latest versions of its available packages and kernel. With those done, run... | These will ensure your server has the very latest versions of its available packages and kernel. With those done, run... | ||
<syntaxhighlight lang="bash"> | |||
sudo reboot | |||
</syntaxhighlight> | |||
...to restart the server. | |||
With the server restarted, we will prepare your server to install MySQL 5.7, which is not available on Ubuntu 22.04 LTS from either the default Ubuntu or MySQL repositories. As a result, we need to manually configure where to get these packages. | |||
<syntaxhighlight lang="bash"> | |||
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 5072E1F5 | |||
sudo echo 'deb http://repo.mysql.com/apt/ubuntu bionic mysql-5.7' | sudo tee /etc/apt/sources.list.d/mysql.list | |||
sudo apt update | |||
</syntaxhighlight> | |||
...to | '''NOTE:''' We are aware that official support from MySQL for version 5.7 ends in October 2023. We have run Convention Master on MySQL 8.0 in a number of scenarios without incident, however we have not yet completed specific testing on 8.0 in order to make it our supported version. We expect to have this testing completed by the release of CM v11. | ||
With MySQL configured, you can use the following command to install all the packages a standard Convention Master setup needs. | |||
<syntaxhighlight lang="bash"> | |||
sudo apt install -y php8.1 php8.1-cli php8.1-curl php8.1-gd php8.1-mysql php8.1-mbstring | |||
subversion ntp nano joe apache2 libapache2-mod-php7.4 bind9 bind9utils samba html2ps | |||
htmldoc mysql-client=5.7* mysql-server=5.7* mcrypt python3-pil curl | |||
</syntaxhighlight> | |||
'''PHP 7.x:''' Convention Master 10.x will technically run on PHP 7.x. However, these versions of PHP are no longer supported by Zend, so we highly recommend immediately upgrading your server to PHP 8.x for best security and compatibility. Convention Master will cease supporting PHP 7.x as of version 11, currently under development at time of writing. | |||
Finally, let's go ahead and run the wizard to properly secure your new MySQL installation: | |||
<syntaxhighlight lang="bash"> | |||
sudo mysql_secure_installation | |||
</syntaxhighlight> | |||
Revision as of 17:08, 14 December 2022
<<Previously: 1.0 - Pre-Requisites
Installing Software on the Server
This section of the guide will walk you through the configuration of a server running Ubuntu Server 22.04 LTS, on which Convention Master can run. If your server is not yet installed, you can follow the official Ubuntu guide to do so:
https://tutorials.ubuntu.com/tutorial/tutorial-install-ubuntu-server
Note: Convention Master can run on any system meeting the Apache/PHP/MySQL requirement, but we will provide documentation only for Ubuntu. If you wish to use another operating system, such as CentOS or Windows, be aware that some of the steps in this guide may not apply, may have to be modified in order to work, or additional steps may be required. Convention Master can only guarantee official support for the Ubuntu Server OS.
Configure Server
Once your server's operating system is installed, we can begin installing the packages you will need to run Convention Master. Log in as the user you created during installation (or any user with sudo rights), and input the following commands.
sudo apt update
sudo apt dist-upgrade -y
These will ensure your server has the very latest versions of its available packages and kernel. With those done, run...
sudo reboot
...to restart the server.
With the server restarted, we will prepare your server to install MySQL 5.7, which is not available on Ubuntu 22.04 LTS from either the default Ubuntu or MySQL repositories. As a result, we need to manually configure where to get these packages.
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 5072E1F5
sudo echo 'deb http://repo.mysql.com/apt/ubuntu bionic mysql-5.7' | sudo tee /etc/apt/sources.list.d/mysql.list
sudo apt update
NOTE: We are aware that official support from MySQL for version 5.7 ends in October 2023. We have run Convention Master on MySQL 8.0 in a number of scenarios without incident, however we have not yet completed specific testing on 8.0 in order to make it our supported version. We expect to have this testing completed by the release of CM v11.
With MySQL configured, you can use the following command to install all the packages a standard Convention Master setup needs.
sudo apt install -y php8.1 php8.1-cli php8.1-curl php8.1-gd php8.1-mysql php8.1-mbstring
subversion ntp nano joe apache2 libapache2-mod-php7.4 bind9 bind9utils samba html2ps
htmldoc mysql-client=5.7* mysql-server=5.7* mcrypt python3-pil curl
PHP 7.x: Convention Master 10.x will technically run on PHP 7.x. However, these versions of PHP are no longer supported by Zend, so we highly recommend immediately upgrading your server to PHP 8.x for best security and compatibility. Convention Master will cease supporting PHP 7.x as of version 11, currently under development at time of writing.
Finally, let's go ahead and run the wizard to properly secure your new MySQL installation:
sudo mysql_secure_installation