UpgradeTask

com.atlassian.jira.upgrade.UpgradeTask

Known Indirect Subclasses

AbstractDelayableUpgradeTask, AbstractImmediateUpgradeTask, AbstractNotificationSchemeUpgradeTask, AbstractReindexUpgradeTask, AbstractUpgradeTask, DropIndexTask, FailingUpgradeTaskForTesting, LegacyImmediateUpgradeTask, UpgradeTaskForTesting, UpgradeTaskForTestingNoReindex, UpgradeTask_Build509, UpgradeTask_Build520, UpgradeTask_Build551, UpgradeTask_Build552, UpgradeTask_Build554, and 140 others.

AbstractDelayableUpgradeTask
AbstractImmediateUpgradeTask
AbstractNotificationSchemeUpgradeTask	This upgrade task adds new scheme entities to the eventIdDestination of all notification schemes in JIRA.
AbstractReindexUpgradeTask
AbstractUpgradeTask
DropIndexTask
FailingUpgradeTaskForTesting
LegacyImmediateUpgradeTask	Old upgrade tasks will extend this.
UpgradeTaskForTesting
UpgradeTaskForTestingNoReindex
UpgradeTask_Build509	Upgrades link, active link and text color to new default of #3c78b5.
UpgradeTask_Build520	Upgrade Task to change jira.maximum.authentication.attempts.allowed to be move from blank (unlimited) to a specified value
UpgradeTask_Build551	This upgrade task adds the Labels field to the first tab of the default screen
UpgradeTask_Build552	Upgrade task to convert Label customfields to system fields.
UpgradeTask_Build554	Adds user project avatars.
UpgradeTask_Build571	This upgrade task initializes field renderers to the frother-control-renderer for the system versions & components fields as well as the multi version custom field.
UpgradeTask_Build572	This upgrade task initializes link types to a set of predefined values.
UpgradeTask_Build6001	Upgrade Task to add property jira.projectkey.maxlength
UpgradeTask_Build6005	Only show the admin gadget "Getting Started" task list on new instances.
UpgradeTask_Build6006	Upgrade Task to add property jira.projectkey.maxlength
UpgradeTask_Build6007	Update the file paths of default icons for Statuses, Issue Types, Priorities and Sub Tasks.
UpgradeTask_Build601	Migrate the OSUser.xml configuration over to the new Crowd Embedded Directories.
UpgradeTask_Build602	This task migrates OS_users and Groups to Crowd Embedded users and Groups.
UpgradeTask_Build603	Synchronise any newly created remote directories and then do a reindex of JIRA to ensure that index is up to date for JQL.
UpgradeTask_Build6038	This upgrade task will ensure that change authors and assignee/reporter change values are lowercase.
UpgradeTask_Build6039	Upgrade task to convert username fields to lowercase.
UpgradeTask_Build6040	Map existing usernames to userkeys for rename user.
UpgradeTask_Build6041	Store user properties under ApplicationUser entity for rename user.
UpgradeTask_Build6042	Change the user and site dark features to be stored as text rather then string to allow for more then 255 characters
UpgradeTask_Build6044	JRA-16974: usernames in RememberMeToken should be lowercase to match userkeys.
UpgradeTask_Build6045	This task migrates Custom field values for User and MultiUser types to store the key of the user rather than the username.
UpgradeTask_Build6047	JRA-17011: usernames in ServiceProvider OAuth tokens should be lowercase to match userkeys.
UpgradeTask_Build605	Cleans up left over configuration from JIRA issues cache
UpgradeTask_Build606	Cleans up left over application properties
UpgradeTask_Build608	Updates user avatars to the latest crowdsourced designs
UpgradeTask_Build6081	Update the file paths of default icons for Statuses, Issue Types, Priorities and Sub Tasks.
UpgradeTask_Build6083	Adds new system project avatars, hides old ones.
UpgradeTask_Build6085	This upgrade task checks whether the clone link descriptions have been swapped (specifically the check introduced in 5.2.6 to resolve JRA-24563 is used), and sets the "jira.clone.link.legacy.direction" flag to true if they have.
UpgradeTask_Build6096	Upgrade task to convert username fields to lowercase in worklogs.
UpgradeTask_Build6100	a too long index name was inadvertently merged to branch from master to support downgrades.
UpgradeTask_Build6121	Populate the MovedIssueKey DB table from Change History Items.
UpgradeTask_Build6122	Remove the VCS Update Service
UpgradeTask_Build6123	Migrate the old default workflow to a new scheme/workflow Lives in stable under build number 6097
UpgradeTask_Build6124	Allow Unassigned Issues by default for new instances.
UpgradeTask_Build6128	Drop index issue_key
UpgradeTask_Build6129	Extract Issue number to a separate column
UpgradeTask_Build6130	Adds keys to Project Key table.
UpgradeTask_Build6131	Removes issue keys from jiraissue table.
UpgradeTask_Build6132	Adding a unique constraint to the issue_proj_num index - unfortunately this means deleting it and then recreating it
UpgradeTask_Build6133	Migrate PluginPersistentState to the PluginState table
UpgradeTask_Build6134	Upgrade task to convert username fields to lowercase in project role actors.
UpgradeTask_Build6135	Fills in originalKey in project table.
UpgradeTask_Build6136	Requires a JIRA re-index to be able to migrate to a new aggressive stemming algorithm for the English language.
UpgradeTask_Build6137	Ensures that every user that is used as a reporter or assignee has a userkey mapping so that they can be indexed and searched for properly.
UpgradeTask_Build6138	Ensures that a reindex is performed to support wildcard searches on stemmed fields.
UpgradeTask_Build6139	Fills Issue Status category column
UpgradeTask_Build6140	Upgrade task to convert username fields in Scheme Issue Securities.
UpgradeTask_Build6141	Ensures that a reindex is performed to support quoted phrase queries on text fields.
UpgradeTask_Build6142	Requires a JIRA re-index to add lucene indexes to support Cascading Select fields.
UpgradeTask_Build6151	Filling in missing external ids for users in internal directory
UpgradeTask_Build6152	Swaps Cloners links to be in correct direction
UpgradeTask_Build6153	Corrects wording of Cloners link if legacy direction was used and disables support for legacy direction of links
UpgradeTask_Build6154	Removing JIRA property jira.clone.link.legacy.direction
UpgradeTask_Build6200	Remove rogue I18n remotable plugin made obsolete by Atlassian Connect changes (JRA-34978)
UpgradeTask_Build6205	Indexes attachments by name so they are JQL searchable.
UpgradeTask_Build6206	Sets status categories for all statuses in a system.
UpgradeTask_Build6207	Upgrade task to set the base sequence number for issue constants.
UpgradeTask_Build6208	Finds the earliest reporter of an issue and sets the creator to that reporter
UpgradeTask_Build6209	JRA-25705 Ensure no avatar file names interfere with our existing tagged avatar naming convention
UpgradeTask_Build6210	This upgrade task is intended to modify Workflow Descriptors meta attributes which are currently storing userNames.
UpgradeTask_Build6211	JDEV-26606 Modify permissions schemes to allow project role 'Users' to link issues if they can comment, only if both permissions are still like in the default permission scheme.
UpgradeTask_Build6251	Fill in search field in Audit Log table
UpgradeTask_Build6254	Set default project description mode in JIRA settings
UpgradeTask_Build6256	Drop broken unique index on AuditItem entity.
UpgradeTask_Build6258
UpgradeTask_Build6301	Fix field type for AuditLog searchField
UpgradeTask_Build6302	Upgrade the Quartz scheduler tables
UpgradeTask_Build6304	Upgrade task that will move all GlobalPermission entries from the SchemePermissions table to the brand new GlobalPermissionEntry table.
UpgradeTask_Build6305	This upgrade task changes two Gravatar settings in JIRA: If the "Allow Gravatar" settings is set to "default" then explicitly set Gravatar to OFF.
UpgradeTask_Build6306	Removes orphaned and incorrect mappings generated by UpgradeTask_Build6123
UpgradeTask_Build6316	Drop broken unique index on AuditItem entity.
UpgradeTask_Build6318	Add Audit Log Cleaning Service
UpgradeTask_Build6319	Triggers a reindex necessary to rebuild the exact-text field document fields so stop words are not ignored by exact phrase searches.
UpgradeTask_Build6320	Add a correctly initialised sequence for EventType
UpgradeTask_Build6321	Grants Transition permission to all users with Browse permission.
UpgradeTask_Build6322	Add issue type icons as avatars.
UpgradeTask_Build6323	Remove any plugin state related to the `com.atlassian.jira.plugin.system.licenseroles plugin`.
UpgradeTask_Build6325	Populate project permission entry keys based on ID-s and clear the permissionScheme cache.
UpgradeTask_Build6326
UpgradeTask_Build6327
UpgradeTask_Build6328	Increase width of time-related columns in Quartz tables on Oracle.
UpgradeTask_Build633	This task migrates Custom field values for Select and MultiSelect types to store the id of the option rather than the value.
UpgradeTask_Build634	This task cleans up after the CustomFieldValue upgrade (633)
UpgradeTask_Build637	Migrates custom defaults to the database for selected ApplicationProperties that have been preemptively added to the classpath via the jira-application.properties file in the installation directory under $APP_ROOT/WEB-INF/classes.
UpgradeTask_Build638	Generate an initial vote history on upgrade
UpgradeTask_Build640	Corrects the value of the "Membership" database sequence.
UpgradeTask_Build64001	Recalculates watches count because of 'JRA-34394: Watch count gets out of sync when cloning issues' bug.
UpgradeTask_Build64002	Removes the JIRA News gadget.
UpgradeTask_Build64003	JRA-33781: There's missing record for "issue comment deleted" in database startup xml file.
UpgradeTask_Build64004	Indexes worklogs in their own index so they are JQL searchable.
UpgradeTask_Build64005	Removes old indexes from jiraaction table that are rarely if ever helpful and may even be harmful to performance.
UpgradeTask_Build64006	Indexes worklogs in their own index so they are JQL searchable by date or author.
UpgradeTask_Build64007	Remove old indexes from jiraaction and changegroup table that are replaced with better performing ones.
UpgradeTask_Build64008	Marks upgrade tasks that have entries in the UpgradeHistory with a (null) status as done.
UpgradeTask_Build64009	Indexes issues because of the changes to how Number Custom Fields are indexed and searched.
UpgradeTask_Build64011	Indexes issues because of the changes to how Number Custom Fields are indexed and searched.
UpgradeTask_Build64012	The browser-metrics plugin has become a mandatory requirement in JIRA 6.4, so it's critical that it's enabled.
UpgradeTask_Build64014	Turns on the dark feature for project centric nav switch (to allow the user to turn it on and off) and the embedded issue navigator to be on by default.
UpgradeTask_Build64015	Removes the JIRA Bugzilla ID search gadget.
UpgradeTask_Build64016	This upgrade task comes with a little bit of history.
UpgradeTask_Build642	Turn soap on for new installations
UpgradeTask_Build643	Accumulates the "watchers" for issues.
UpgradeTask_Build645	Upgrade task hackery to ensure the bundled GreenHopper is enabled if a non-bundled GreenHopper was previously enabled.
UpgradeTask_Build65001	Stores the max() app_user id as a JIRA property that can be used later to determine which users are new and should see the onboarding flow.
UpgradeTask_Build663	Fix any possible corruption in the jiraissue table due to https://jira.atlassian.com/browse/JRA-25914 , also reindexes
UpgradeTask_Build70007	Converts jira-introduction-gadget into jira-introduction-dashboard-item in the portletconfiguration table.
UpgradeTask_Build70009	Repair any malformed cron expressions in the `serviceconfig` and `clusteredjob` tables.
UpgradeTask_Build70010	Migrate atlassian-scheduler data from Quartz to Caesium.
UpgradeTask_Build70011	Upgrade the Filter Subscription schedule.
UpgradeTask_Build70013	Removes the JIRA Admin gadget.
UpgradeTask_Build70023	Indexes worklogs in their own index so they are JQL searchable by comments.
UpgradeTask_Build70024	Replacing system avatars with new SVG icons.
UpgradeTask_Build70025	Remove jira.user.locale preference if current value is -1
UpgradeTask_Build70026	Reset look and feel counter.
UpgradeTask_Build70027	It's a marker for the change to the attachment file system so that stable knows which versions of 6.4 are compatiable with the new system by matching to the corresponding downgrade task
UpgradeTask_Build701	Replaces all usages of OSUserGroupCondition with `UserInGroupCondition`.
UpgradeTask_Build70100	/** Performs renaissance migration (i.e.
UpgradeTask_Build70101	Goes through all of the projects on the JIRA instance, assigning appropriate project types.
UpgradeTask_Build70102	After the Renaissance migration, sets the application as the default ones based on the available licenses.
UpgradeTask_Build70108	Remove query column from REINDEX_TABLE The reindex-request table was backported to 6.3.8 to allow for downgrade tasks.
UpgradeTask_Build705	Removing old LF colors in the databse if they are no differen from the current default colours.
UpgradeTask_Build707	Copying trackbacks to remote issue links
UpgradeTask_Build708	Cleans up left over configuration from JIRA issues cache.
UpgradeTask_Build71001	Deletes the version association for any issues that have a reference to a non-existent project version.
UpgradeTask_Build751	Reindexes JIRA due to a bug in the way `MultiSelectCFType` fields were being indexed.
UpgradeTask_Build752	JRA-26194: usernames in PortalPage should be stored lower case only.
UpgradeTask_Build753	JRA-26194: usernames in Favourite Filters should be stored lower case only.
UpgradeTask_Build754	JRA-26194: usernames in SearchRequest should be stored lower case only.
UpgradeTask_Build755	JRA-26194: usernames in AvatarStore should be stored lower case only.
UpgradeTask_Build756	JRA-26194: usernames in UserPropertyManager should be stored lower case only.
UpgradeTask_Build757	Reindexes JIRA due changes to allow native sorting of many system fields by Lucene.
UpgradeTask_Build758	JRA-24218: Ensure UPM is enabled.
UpgradeTask_Build759	This upgrade task is used to enable GZIP compression by default for new installations only.
UpgradeTask_Build771	This upgrade task will ensure that the username field is lowercase in the UserHistoryItem and FilterSubscription tables.
UpgradeTask_Build801	This upgrade task creates the notification event for the `ISSUE_COMMENT_DELETED_ID` event.
UpgradeTask_Build802	Populate the new column in SearchRequest for lower-case name.
UpgradeTask_Build807	Remove any only draft workflows schemes that might be around after a downgrade from OnDemand 5.2 to BTF 5.1.x.
UpgradeTask_Build808	Sets a date-time property that the instance was upgraded so we can know when to delete the NotificationInstance table.
UpgradeTask_Build809	Updates user searchers to be user/group searchers and single select searchers to multi-select searchers
UpgradeTask_Build810	Updates radiobutton and multi-checkbox searchers to be multi-select searchers
UpgradeTask_Build812	Reapplies Upgrade Task 787 to shorten Oracle MAnagedConfigurationItem index
UpgradeTask_Build813	This upgrade task will create a backup copy of any inactive workflow drafts stored in JIRA.
UpgradeTask_Build843	Update the file paths of default icons for Statuses, Issue Types, Priorities and Sub Tasks.
UpgradeTask_Build849	This upgrade task checks whether the clone link descriptions have been modified, and sets the "jira.clone.link.legacy.direction" flag to true if they have.
UpgradeTask_Build851	Change the user and site dark features to be stored as text rather then string to allow for more then 255 characters

Summary

Nested Classes
enum	UpgradeTask.ScheduleOption
class	UpgradeTask.Status	Track status of a task this session, if isTaskDone(String) returns true you don't need to do it again.

Public Methods
@Nullable String	dependsUpon() Return the Upgrade task id of another upgrade task that must be run prior to this task.
void	doUpgrade(boolean setupMode) Perform the upgrade.
String	getBuildNumber()
Collection<String>	getErrors() Return any errors that occur.
UpgradeTask.ScheduleOption	getScheduleOption() Return when this upgrade task can be scheduled.
String	getShortDescription() A short (<50 chars) description of the upgrade action
boolean	isDowngradeTaskRequired() Flag to claim whether this upgrade task needs an explicit downgrade task to reverse the data changes.

Public Methods

@Nullable public String dependsUpon ()

Return the Upgrade task id of another upgrade task that must be run prior to this task.

public void doUpgrade (boolean setupMode)

Perform the upgrade.

Parameters

setupMode	Indicating this upgrade task is running during set up.

Throws

Exception

public String getBuildNumber ()

Returns

The build number that this upgrade is applicable to

public Collection<String> getErrors ()

Return any errors that occur. Each entry is a string.

public UpgradeTask.ScheduleOption getScheduleOption ()

Return when this upgrade task can be scheduled.

public String getShortDescription ()

A short (<50 chars) description of the upgrade action

public boolean isDowngradeTaskRequired ()

Flag to claim whether this upgrade task needs an explicit downgrade task to reverse the data changes.

If a downgrade is a simple no-op then return false, and JIRA will ignore these changes during a downgrade.

If you need to actually undo the changes made here then declare true and add a Downgrade Task to the bug fix branch.

Returns

true if an actual Downgrade Task must run to revert these changes, false if downgrade is a no-op.

Interfaces

Classes

Enums

Exceptions

UpgradeTask

Summary

Public Methods

@Nullable public String dependsUpon ()

public void doUpgrade (boolean setupMode)

Parameters

Throws

public String getBuildNumber ()

Returns

public Collection<String> getErrors ()

public UpgradeTask.ScheduleOption getScheduleOption ()

public String getShortDescription ()

public boolean isDowngradeTaskRequired ()

Returns