There are some inconsistencies on the Installation Guide for Unix-based Systems documentation page.
Download from the official MySQL webpage is strongly recommended.
Why we strongly recommend customers to download MySQL from their website instead using the standard packages of their distributions with
which our software was tested?
Besides the testing, it's important to remember that we must provide support and reproduce customer bugs and as closer their environment is to testing and support environments, the better.
This step requires the modification of two files: Apache2 configuration file and php.ini.
These files can be edited using a terminal editor like vi or nano, or a simple text editor such as TextEdit or Atom.
The steps described in this howto to install php is incomplete and won't make sense to the supported platforms - maybe in MacOs only - and shouldn't be here.
According to the Requirements & System Configuration page, the recommended setups should be Debian, Ubuntu or RHEL / CentOS.
The paths on the page are not the ones used in neither of these systems and should be fixed.
- In the first case, the path should probably be /etc/apache2/apache2.conf in Debian and /etc/httpd/httpd.conf in CentOS.
- In the second one, /etc/apache2/apache2.conf in Debian and /etc/httpd/conf.d in CentOS.
MacOS is not a supported platform and should not be used in documentation
b. Uncomment and modify the following lines:
This does not make sense since Debian, for example, uses a2enmod to enable modules. But the main reason is we shouldn't explain how to enable modules, we should just list them as required on the Requirements page.
This step is allows you to use ez1.lh as an address to access running Platform from a web browser. You can substitute the address with the address you intend to use to access your installation (remember to change it in all other command on this page as well):
This is something only makes sense in a development environment. It should be removed from the official documentation.
I remember some time ago we - engineering - talked about having the documentation with a composer alias or the full command php -d memory_limit=-1 composer.phar and the decision was stay with the full command to have a safe standard. This rule should be kept here and in the documentation.
- If the steps described here are mandatory, why they are not described in the INSTALL.md file? I think they are not.
- The steps does not explain how to obtain the install-pear-nozlib.phar file and so they won't work.
- Again, we shouldn't explain how to install packages but list them as required on the Requirements. Besides, I think icu4c won't even exist in Debian and CentOs.
The steps listed here are very different from the ones described in the INSTALL.md file what is very confusing, specially for customers since the Manual Installation Guides page instructs them to download the software from share.ez.no/downloads/downloads.
- The steps listed here should follow the lead on Apache 2.2 / 2.4 configuration.
- Listing a virtual host file here may result in compatibility and maintenance problems. Instead, we should link it to the vhost.template on Github.
Again the full form should be used.
Afaik, these are MacOS only - see Mac OS Man page - and shouldn't be here.
Some of these steps does not make sense to Debian or CentOS.