Upgrade

We regularly provide new versions of the different components. Therefore, it's highly recommended that you upgrade on a regular basis to benefit from the new features.

Latest Versions

  Latest Version Installed Version
Agent/Client 1.13.0 
blackfire-agent -v
Probe 1.17.3 
php --ri blackfire
Chrome Companion 1.12.1

Upgrading the Agent, the Client, and the Probe

Upgrading the Debian Repository

Update the Debian repository: 

sudo apt-get update

Upgrading the Agent

Upgrade the blackfire-agent package: 

sudo apt-get install --only-upgrade blackfire-agent

Restart the agent service: 

sudo /etc/init.d/blackfire-agent restart

Upgrading the Probe

Upgrade the blackfire-php package: 

sudo apt-get install --only-upgrade blackfire-php

To finish the probe upgrade, restart your web server or PHP-FPM and check that there are no error messages. To debug problems, you can change the log level and the log file in the probe configuration.

Upgrading the Agent

Upgrade the blackfire-agent package: 

sudo yum update blackfire-agent

Restart the agent service: 

sudo /etc/init.d/blackfire-agent restart

Upgrading the Probe

Upgrade the blackfire-php package: 

sudo yum update blackfire-php

To finish the probe upgrade, restart your web server or PHP-FPM and check that there are no error messages. To debug problems, you can change the log level and the log file in the probe configuration.

Upgrading the Homebrew Respository

Update the Blackfire repository: 

brew update

Upgrading the Agent

Upgrade the blackfire-agent package: 

brew upgrade blackfire-agent

Restart the service by unload it and load it again: 

launchctl unload ~/Library/LaunchAgents/homebrew.mxcl.blackfire-agent.plist && launchctl load -w ~/Library/LaunchAgents/homebrew.mxcl.blackfire-agent.plist

Upgrading the Probe

If you use Homebrew-PHP, execute the command below and replace 56 by the installed PHP version: 

brew upgrade blackfire-php56

To finish the probe upgrade, restart your web server or PHP-FPM and check that there are no error messages. To debug problems, you can change the log level and the log file in the probe configuration.

You are strongly advised to use the other installation methods available if possible as they give you seamless upgrade methods.

Upgrading manually is the same as the installation procedure.