Difference between revisions of "Install OS4X on Ubuntu 20"

From OS4X
Jump to navigation Jump to search
 
(4 intermediate revisions by the same user not shown)
Line 19: Line 19:
 
=== PHP ===
 
=== PHP ===
 
The PHP configuration must be extended in order to use big file uploads. Edit the configuration file
 
The PHP configuration must be extended in order to use big file uploads. Edit the configuration file
  /etc/php/7.0/apache2/php.ini
+
  /etc/php/7.4/apache2/php.ini
 
and set these values:
 
and set these values:
 
  upload_max_filesize = 128M
 
  upload_max_filesize = 128M
 
  post_max_size = 128M
 
  post_max_size = 128M
Don't forget to restart Apache afterwards (see below).
+
Don't forget to restart Apache afterwards:
 +
service apache2 restart
  
=== Apache prefork ===
+
== SystemD integration ==
The PHP7 module only works correctly in Apache2 prefork mode. If you have a previously installed Apache, you have to switch from MPM mode to prefork:
+
Download the source tarball from https://cdn.c-works.de/fileadmin/downloads/os4x.systemd.tar, extract it /tmp. Then, copy over the files:
  a2dismod mpm_worker
+
  cp /tmp/etc/init.d/os4x /etc/init.d/
  a2enmod mpm_prefork
+
  cp /tmp/etc/systemd/system/os4x.service /etc/systemd/system
Don't forget to restart Apache afterwards (see below).
+
Then, enable the service:
 
+
  systemctl enable os4x
=== Apache ===
+
systemctl start os4x
After successful installation of all required packages, you have to restart the Apache webserver once in order to load the MySQL functionality in the PHP module:
 
  service apache2 restart
 

Latest revision as of 07:40, 6 November 2020

General

Ubuntu 20.x is supported by the automatic OS4X installer since build 2016-11-24. Older versions lack the ability to support various features of this modern operating system.

Packages

You need the following packages to be installed:

apt-get install apache2 \
mysql-server \
libapache2-mod-php \
php-mysql \
php-xml \
xsltproc \
zip

Special installation parameter

When running the automated installer script, you will have to use "localhost" instead of "127.0.0.1" in the default MySQL installation (since the MySQL user "root" isn't allowed for 127.0.01, but for localhost). You'll get the following error otherwise:

error: 'Access denied for user 'root'@'localhost

Configuration

PHP

The PHP configuration must be extended in order to use big file uploads. Edit the configuration file

/etc/php/7.4/apache2/php.ini

and set these values:

upload_max_filesize = 128M
post_max_size = 128M

Don't forget to restart Apache afterwards:

service apache2 restart

SystemD integration

Download the source tarball from https://cdn.c-works.de/fileadmin/downloads/os4x.systemd.tar, extract it /tmp. Then, copy over the files:

cp /tmp/etc/init.d/os4x /etc/init.d/
cp /tmp/etc/systemd/system/os4x.service /etc/systemd/system

Then, enable the service:

systemctl enable os4x
systemctl start os4x