Tecpan Quetzalpapalotl : 'Palace of the Gorgeous Butterfly', located at Teuhctihuacan ['Teotihuacan'].
Any likeness to XochiQuetzal, i.e., 'Gorgeous Flower'
--the real Mexicah's collectively held archetype of female beauty--
is not a mere artistic coincidence.
After a couple of ensuing build iterations following previous successful build of Engine X (Nginx), I updated my original patch to include a sample b2evolution Blog/CMS configuration. At the same time Nginx 1.17.0 was released and I decided to upgrade a Metztli Reiser4 instance running Nginx 1.16.0 in the cloud. Once that instance was running Nginx 1.17.0, notwithstanding, Drupal CMS 8.x.y Status Report displayed a notice advising that PHP 7.2 would be a significant improvement over PHP 7.0; this latter, however, is the only currently available version even in Debian Stretch backports repository used by Metztli Reiser4. The following post thus illustrates 'the Debian way' guiding procedure that I hacked to build PHP 7.3.5̶ 6, a slightly newer version than that currently found in the upcoming Debian Buster repositories.
Preliminary Tasks Prior to PHP 7.3.5̶ 6 Build
First I created a tekitl- [work] tlacauhtli [space] area where I changed into --subsequently fetching the Debian Buster packaging for PHP 7.3.4-2 as well as the source for php-7.3.5̶ 6.
Note: As I was writing this blog entry, php-7.3.6 became available at PHP Downloads and I verified it builds, too.
After expanding the Debian Buster packaging for PHP 7.3.4-2 archive, I then proceeded to fulfill required dependencies using its debian/control file as my guide for AMD64:
We will be peeking into debian/control so as to evaluate necessary dependencies; but we must be careful not to install dependencies for architectures for which we do not intend to build our software as that will only introduce unnecessary errors in our build. We should not forget that this file is from upcoming Debian 10 Buster and thus we will need to fetch some newer resources than those found in Stretch repositories.
Note: to fulfill MySQL requirement, I selected MariaDB 10.3.15 instead; hence libmariadb-dev-compat is an alternative to libmysqlclient-dev, and I had to 'pin' a preferred source repository specified in a file with .pref extension written into
/etc/apt/preferences.d/ directory. For instance, below is sample content if your preferred repository is, say, in New York:
Pin: origin 'nyc2.mirrors.digitalocean.com'
Your mileage may vary (YMMV) as it will depend on your nearest and/or preferred location as you make your selection and follow instructions provided in the above referenced MariaDB resource link. Or you might as well use available, lower-version, MariaDB from Debian repositories and forget about 'pinning', etc..
Hence we peek into debian/control to figure out dependencies prior to our php-7.3.5̶ 6 build:
We will need the upcoming New Perl Compatible Regular Expression Library- 8, 16, 32 bit runtime files, the development files, and posix-compatible runtime files --which I downloaded manually from ensuing Buster packages repository
Additionally, we will need the memory-hard hashing function - runtime library and development files. Accordingly, downloaded these other two(2) packages from this other Buster repository
I thus resolved an error which halted my initial build attempts and the log files were ambiguous as to its cause. Naturally, prior to my PHP 7.3.5̶ 6 successful build, I installed those seven(7) files from Buster manually as,
Patching Debian Packaging Patch To Build PHP 7.3.5̶ 6
We must change a couple of strings for this
debian/patches/0038-php-5.6.0-oldpcre.patch to apply cleanly
debian/patches/seriesfile, we locate and neutralize
debian/patches/0039-hack-phpdbg-to-explicitly-link-with-libedit.patchas it seems to be redundant against newer PHP:
Then we can expand the PHP 7.3.5̶ 6 that we downloaded a priori:
and move our modified debian packaging for php into newly created directory as we change directory to the latter, as well:
Create a symbolic link to debian/patches so that we may subsequently apply those with quilt.
And note our new upstream php 7.3.6 in debian/changelog
We save our modifications and dch will close our text editor.
And finally, we begin our PHP 7.3.6 build for our Metztli Reiser4 and/or Debian 9.x Stretch Backports AMD64:
where X represents the number of CPU/cores we want to assign to our build task. Please read the manual page for dpkg-buildpackage, especially for option -d
Installing Our Newly Built PHP 7.3.5̶ 6 and/or Purging Stretch/Backports PHP 7.0 in Our Target System.
It is good practice to make a backup of a working Linux, Engine X, MariaDB, PHP (LEMP) stack prior to engaging in the installation of software which is not available in your default Debian repositories. For instance, my target Metztli Reiser4 instance was on Google Compute Engine (GCE) and I wanted to make sure I could recover relatively straightforward in case something went wrong. Thus, I created a snapshot of the target instance underlying disk, i.e., Best Practices for Persistent Disk Snapshots, prior to engaging in the task.
At the very least make a backup of /etc/ directory as that contains important configuration files that will be overwritten by our newly built PHP 7.3.6.
Additionally, depending upon having --or not-- an existing LEMP installation will determine whether some of the following steps are/or not applicable:
Assuming that you are using PHP 7.0 from Debian repositories, prior to installation of PHP 7.3.5̶ 6 packages, find out which packages you will need to replace those older ones. For instance,
will show which packages are installed that should be replaced with equivalent PHP 7.3.5̶ 6 ones. Consequently, after acquiring a list of older packages, I purged them as:
Note: prior to installing PHP 7.3.5̶ 6 in another target VirtualBox instance running Metztli Reiser4, but not LEMP, I had to fulfill these dependencies:
Notwithstanding, unless you are currently running Debian Buster, these other dependencies are a must -- whether or not a current LEMP existed a priori:
Manually download memory-hard hashing function - runtime library libargon2-1_0~20171227-0.2_amd64.deb (or newer version from the date of this post) from Buster packages repository -- as well as libpcre2-8-0_10.32-5_amd64.deb (or newer version from the date of this post) runtime files from Buster packages repository -- and manually install as:
Then we could try to install (wielding root privilege) our newly built PHP 7.3.6 starting with four(4) packages:
and/or all your desired DEB packages at once but putting ahead of the queue the four(4) packages above --so as to decrease potential dependency issues by the installation of ensuing packages:
Your mileage may vary (YMMV) as you may need more or less packages installed.
Hack Debian Packaging to Build Engine X (Nginx) 1.17.0 with ModSecurity v3 Nginx Connector module.
We covered Engine X build in prior blog post. Suffice it to say that ModSecurity v3 is a prerequisite prior to building Nginx 1.17.0. After all, if ModSecurity v3 Nginx Connector was being offered in Debian repositories we would not be engaged in this hack. Accordingly, we review our links to libmodsecurity3 and download:
And install these required libmodsecurity3 dependencies:
Additionally, I assume that, from prior blog post, the Nginx build requirements have been fulfilled, i.e.,
I assume we are downloading ensuing resources to our tekitl-tlacauhtli [work-space] directory:
Alternatively, you may hack together your own components and/or patch --as elaborated in previous blog post.
Fetch Debian Buster packaging for (older) Nginx source -- as well as Engine X 1.17.0 source.
Verify Engine X source integrity and apply patch to Debian Buster packaging for Nginx
MOST IMPORTANT NOTE: Your build will fail if libnginx-mod-http-modsecurity.nginx is not executable; thus, make sure not to overlook the last command immediately above. Analyze following screenshot: Then we build Engine X 1.17.0 'the Debian way':
Install Engine X (Nginx) 1.17.0 Into Metztli Reiser4 and/or Debian Stretch Backports for AMD64.
Fulfill dependencies by installing these packages:
Then nginx-full with the integrated ModSecurity v3 Nginx Connector module may be installed thus:
Again, your mileage may vary (YMMV) as you may need less or more packages from the pool generated and listed previously.
Elsewhere at this site, in Amatzintli collection, there exists a paged illustration of working LEMP PHP 7.3.6 component phpinfo function, link:
PHP 7.3.6 and Nginx 1.17.0 builds, as well as PHP app b2evolution on Metztli Reiser4 Virtual Machine Instance in VirtualBox 6.0.8: phpinfo()
Create, Download, and Setup, Modsecurity v3 Configuration and Rules.
The following instructions, gleaned from the final phase of Linux Journal2 topic, do work appropriately for our task. As a matter of fact, that article provided me with flash of insight to hack a 'Debian way' procedure to build LEMP for Metztli Reiser4 / Debian Stretch Backports for AMD64.
Wielding root/sudo privilege, create modsec directory anchored at /etc/nginx to nest ModSecurity v3 rules/configuration
and rename ModSecurity v3 rules configuration file:
Fetch and rename the libmodsecurity3 configuration corresponding to our previously installed libmodsecurity3 DEB packages:
Then we generate a main.conf by writing the three(3) directives below -- which start with 'Include' -- to bind everything ModSecurity v3 together:
We can verify proper content by using, say, tiny text editor xvi to open main.conf, as I did in the snapshot above in an Eterm small console.
DISCLAIMER although due diligence has been applied, this resource is made available for testing/evaluation purposes on an AS IS basis. The procedure only reflects my own modifications, my limited testing, and the potential user(s) who execute(s) the procedures assumes all risks.
Please do not hold me or Metztli Information Technology (and/or its associates) responsible if the information provided here does not achieve the desired result. The information is provided AS IS and with the hope that it may be useful to the Internet community --especially those interested in PHP 7.3.5̶ 6 and/or Engine X (Nginx) 1.17.0 on Metztli Reiser4 / Debian for stretch-backports AMD64.
Notwithstanding, There is no implicit or explicit guarantee that the information presented here is accurate --even though due diligence was exercised during the procedure. Accordingly, if an user(s) decide to use the resources available here and/or implement the procedure and/or shell commands described here she, he, or them, do so at her, his, or their own risk. You have been forewarned.
Metztli IT, but not other entities, reserves the right to modify the content and/or even delete it, including blog post, without previous notice.