dbmigrate_legacy-license-names.php File Reference

Retire deprecated license shortnames an agent may have re-created. More...

Go to the source code of this file.

Functions
	getLegacyLicenseNames ()
	Deprecated shortname => current shortname. More...
	getLicenseRefReferences ()
	Columns referencing license_ref.rf_pk, as table => column pairs. More...
	legacyLicenseWrite (DbManager $dbManager, $sql, $params, $statementName)
	Run a parameterised write; getSingleRow() would fetch a command result. More...
	renameOrMergeLicense (DbManager $dbManager, $old, $new, $verbose=false)
	Rename a license, or merge it away when the target already exists. More...
	Migrate_Legacy_License_Names (DbManager $dbManager, $verbose=false)

Detailed Description

Retire deprecated license shortnames an agent may have re-created.

A shortname corrected by a release migration comes back whenever an agent still reports the old name: every scan after the upgrade inserts the deprecated row again. Release migrations are version gated and never run a second time, so that correction has to be repeated unconditionally.

For each pair the migration either renames the deprecated row, or – when both rows exist – moves every reference onto the current row and drops the deprecated one.

Definition in file dbmigrate_legacy-license-names.php.

Function Documentation

getLegacyLicenseNames()

getLegacyLicenseNames

(

)

Deprecated shortname => current shortname.

Returns

array

Definition at line 28 of file dbmigrate_legacy-license-names.php.

getLicenseRefReferences()

getLicenseRefReferences

(

)

Columns referencing license_ref.rf_pk, as table => column pairs.

Returns

array

Definition at line 40 of file dbmigrate_legacy-license-names.php.

legacyLicenseWrite()

legacyLicenseWrite	(	DbManager	$dbManager,
			$sql,
			$params,
			$statementName
	)

Run a parameterised write; getSingleRow() would fetch a command result.

Parameters

DbManager	$dbManager
string	$sql
array	$params
string	$statementName

Returns

void

Definition at line 67 of file dbmigrate_legacy-license-names.php.

Migrate_Legacy_License_Names()

Migrate_Legacy_License_Names	(	DbManager	$dbManager,
			$verbose = false
	)

Parameters

DbManager	$dbManager
bool	$verbose

Returns

void

Definition at line 129 of file dbmigrate_legacy-license-names.php.

renameOrMergeLicense()

renameOrMergeLicense	(	DbManager	$dbManager,
			$old,
			$new,
			$verbose = false
	)

Rename a license, or merge it away when the target already exists.

Parameters

DbManager	$dbManager
string	$old	Deprecated shortname
string	$new	Current shortname
bool	$verbose

Returns

void

Definition at line 82 of file dbmigrate_legacy-license-names.php.