Guides
v1.9.79
Guides

Upgrading Prosper202

Back up, check your PHP and database versions, then upgrade Prosper202 to 1.9.79 by hand or with the 1-Click Upgrade.

Suggest Edits

Upgrading Prosper202 ClickServer takes a few minutes, but it only goes one way. Read this before you replace any files.

Back up first, every time

  • Stop traffic to the site, then dump the database with mysqldump or take your host's snapshot. Keep a copy of 202-config.php too.
  • There is no downgrade. The upgrade changes the database in place, so the backup you took beforehand is the only way back; putting the old files back won't undo it.

Upgrading to 1.9.79

1.9.79 carries security fixes, so update every install. It goes in one pass from 1.9.76 or later, and from 1.9.55 and older.

  • Requirements are unchanged: PHP 8.3+, and MySQL 8.0+ or MariaDB 10.6+. Check with SELECT VERSION(); before you start, because a 1-Click Upgrade from 1.9.55 replaces the files before it reaches the database check.
  • Docker: rebuild the image as well as the files. On Coolify, redeploy; with Compose, run docker compose build --pull and then docker compose up -d.
  • Cron: keep the minutely 202-cronjobs/index.php job running. After the upgrade it folds clicks that were re-clicked through a redirector into one visit each; p202 system dataengine reports its progress.
  • Big installs: if the upgrade page times out, the upgrade keeps going. Give it a few minutes and reload.
  • From source: run composer install --no-dev after replacing the files. Building the p202 CLI yourself now takes Go 1.27.3; the release zip already includes the binaries.

Check after upgrading

  • Customer LTV is now a role permission. Viewing it needs Access to campaign data, editing customers, companies and products needs Access to the Setup section, and LTV Settings needs Access to API integrations. Grant these in User Management to anyone who should keep using LTV.
  • Click filtering is an account setting. Match conversions by IP address now lives under Personal Settings > Advanced, and the new Personal Settings > Click filtering page sets each filter check, the repeat-click window and an always-count or always-filter address list.
  • The daily email report is gone from Personal Settings, because Tracking202 has retired that service.
  • Sign-ins: switching off or removing a user now signs them out everywhere, and a password change ends every other session and "Keep me signed in" cookie.
  • Coming from 1.9.55 or older: review the view_attribution_reports and manage_attribution_models permissions, and the "Delete click data older than" setting, which starts removing old clicks at the first cron run.

Manual upgrade

  1. Get the latest release from your account: download Prosper202 ClickServer.
  2. Back up the database and 202-config.php.
  3. Remove every old file from the domain, since old files can carry vulnerabilities, then upload the new release into the empty directory.
  4. Copy your database details from the old 202-config.php into 202-config-sample.php, then rename it 202-config.php. Versions 1.8.x and later use a different config file.
  5. Open your Prosper202 URL and follow the prompts.

Newer versions can also use the 1-Click Upgrade in the new-version notice under the header.

📘

Full guide on prosper.tracking202.com

Every upgrade note in detail, the cron checks and the changelog: how to upgrade Prosper202 ClickServer to 1.9.79

Updated 12 days ago

Did this page help you?