Release 8019: Blackfire Agent v1 to v2 Upgrade

In this release we’re updating our Blackfire packages. Blackfire is deprecating their V1 agent version and the V1 version will be sunset on the first of September 2021. Blackfire is a tool that you can use to profile your webshop from your browser. Check out this Hypernode knowledge base article to see how you can use Blackfire on Hypernode.

To use blackfire there are two packages we install: the agent and the PHP module (the ‘probe’). We’re updating these two blackfire-agent and blackfire-php packages to their latest version:

Before:

ii  blackfire-agent                       1.32.0                                                           amd64        Blackfire Agent
ii  blackfire-php                         1.31.0                                                           amd64        Blackfire PHP Probe

After:

ii  blackfire-php                         1.61.0                                                           amd64        Blackfire PHP Probe
ii  blackfire-agent                       1.49.0                                                           amd64        Blackfire Agent

Then for the V1 to V2 upgrade we will uninstall the blackfire-agent package and install the new blackfire package.

ii  blackfire                             2:2.4.0                                                          amd64        Blackfire agent and tools. It replaces the blackfire-agent package.

A nice thing about this new version of blackfire is that they’ve converted their SysVInit script (/etc/init.d/blackfire-agent) for a proper modern systemd service file (/lib/systemd/system/blackfire-agent.service). For end-users this doesn’t make a difference but if you’re interested in that sort of thing that’s a cool thing to note.

# cat /lib/systemd/system/blackfire-agent.service
[Unit]
Description=Blackfire Agent
Documentation=https://blackfire.io/docs/introduction
After=network.target

[Service]
Type=simple
User=blackfire
ExecStart=/usr/bin/blackfire agent:start
PermissionsStartOnly=true
ExecStartPre=/bin/mkdir -p /var/run/blackfire
ExecStartPre=/bin/chown blackfire: /var/run/blackfire
Restart=always

[Install]
WantedBy=multi-user.target

You can find more information about this new version of Blackfire on their Agent v1 to v2 Upgrade Guide. To inspect the changes in these new versions you can also check out their packaged changelogs with $ zcat /usr/share/doc/blackfire/changelog.gz and $ zcat /usr/share/doc/blackfire-php/changelog.gz.

This upgrade will be deployed on all Hypernodes that have Blackfire enabled over the course of the coming week.