Minyaa's Installation in 5 Steps

What is it?

It is the complete procedure to install Minyaa on a JIRA Standalone distribution, in order to perform your first evaluation.

Here, we present an installation of Minyaa 3.4.

For previous releases, see :

Minyaa Installation

Note that the License key registration will have to be done after JIRA's start in case of Non-Trial Licenses.
Prepare Standalone JIRA distribution :
  • Download a JIRA Standalone or JIRA WAR distribution from the JIRA Download Center.
  • Extract it to a folder of your choosing.
  • Set your jira.home in atlassian-jira/WEB-INF/classes/jira-application.properties
  • Configure your Database following the steps in JIRA: Connecting JIRA to a Database
    Note that you can evaluate Minyaa with HSQLDB. But if you do, some features will not be available
Copy Minyaa's JARs in correct JIRA Instance folders :

Depending on JIRA's version, the list of JARs may change (See content of each distribution).

Since Minyaa 3.3.2, the distributions are provided with JAR already split in correct archive folder.
  • Into the atlassian-jira/WEB-INF/lib folder :
    • Plugin JARs (JIRA Plugin V1):
      • jira-plugin-minyaa-boot-X.Y.Z-3.3.jar
      • jira-plugin-minyaa-core-X.Y.Z-3.3.jar
      • jira-plugin-minyaa-projects-X.Y.Z-3.3.jar
      • jira-plugin-minyaa-spread-X.Y.Z-3.3.jar
      • jira-plugin-minyaa-time-X.Y.Z-3.3.jar
      • jira-plugin-minyaa-time-reports-X.Y.Z-3.3.jar
      • jira-plugin-minyaa-tools-X.Y.Z-3.3.jar
      • jira-plugin-minyaa-workflows-X.Y.Z-3.3.jar
      • jira-plugin-minyaa-workflows-designer-X.Y.Z-3.3.jar
      • jira-plugin-minyaa-reports-X.Y.Z-3.3.jar




    Since JIRA 6.2 with Minyaa 3.3.18 and over, the plugin Minyaa Project is broken and no more provided.
    • Minyaa's I18n resources :
      • jira-plugin-minyaa-i18n-default-X.Y.Z-3.3.jar (English)
      • jira-plugin-minyaa-i18n-de_DE-X.Y.Z-3.3.jar (German)
      • jira-plugin-minyaa-i18n-en_US-X.Y.Z-3.3.jar (English)
      • jira-plugin-minyaa-i18n-fr_FR-X.Y.Z-3.3.jar (French)
      • jira-plugin-minyaa-i18n-pl_PL-X.Y.Z-3.3.jar (Polish)
      • jira-plugin-minyaa-i18n-ru_RU-X.Y.Z-3.3.jar (Russian)
      • jira-plugin-minyaa-i18n-tr_TR-X.Y.Z-3.3.jar (Turkish)
      • jira-plugin-minyaa-i18n-uk_UA-X.Y.Z-3.3.jar (Ukranian)


      Any contribution is welcomed !


    • Minyaa's dependencies : Others JARs (Dependencies) to the atlassian-jira/WEB-INF/lib folder :
      Depending on JIRA's version, the list of theses dependencies may change or may be already provided by JIRA (See content of each distribution).
      • minyaa-license-manager-1.9.jar
      • dwr-2.0.5.jar
      • truelicense-1.29.jar
      • truexml-1.29.jar




  • Into the atlassian-jira-home/plugins/installed-plugins folder, the Plugin V2 JARs :
    Minyaa Plugin V2 are provided only for JIRA 4.0.x and over.
    • jira-plugin-minyaa-core-gadgets-X.Y.Z-3.3.jar
    • jira-plugin-minyaa-time-gadgets-X.Y.Z-3.3.jar
    • jira-plugin-minyaa-reports-gadgets-X.Y.Z-3.3.jar
    • jira-plugin-minyaa-workflows-attributes-X.Y.Z-3.3.jar
    • jira-plugin-minyaa-gadgets-upgrade-X.Y.Z-3.3.jar


    From JIRA 4.4.x to JIRA 6.2.7 a patch is provided for jira-project-config-plugin.

    It needs to be installed depending on your JIRA release, in order to support Permission Extension.

    Since JIRA 6.3.x, this patch is no more needed due to the change done in JIRA for Permission Management.


    Since JIRA 6.0.x with Minyaa 3.3.14 and over a patch has been done in jira-quick-edit-plugin related the Issue Validation (MYAA-1389).

    It needs to be installed depending on your JIRA release.
    • jira-quick-edit-plugin-1.0.69.1.jar for JIRA 6.0 to 6.0.4
    • jira-quick-edit-plugin-1.0.75.1.jar for JIRA 6.0.5
    • jira-quick-edit-plugin-1.0.80.1.jar for JIRA 6.0.5 to 6.1.3
    • jira-quick-edit-plugin-1.0.82.1.jar for JIRA 6.1.4 to 6.1.7
    • jira-quick-edit-plugin-1.0.85.1.jar for JIRA 6.1.8
    • jira-quick-edit-plugin-1.0.87.1.jar for JIRA 6.2 to 6.2.6
    • jira-quick-edit-plugin-1.0.90.1.jar for JIRA 6.2 to 6.2.7
    • jira-quick-edit-plugin-2.0.1.1.jar for JIRA 6.3 to 6.3.?
      For JIRA 6.3.x, Atlassian has encountered issue in Source Disctribution, and the patch may be provided separately after Minyaa release


Copy your Minyaa Trial license key file (*.key) to the atlassian-jira/WEB-INF/lib folder

This will allow Minyaa to automatically register your trial license when JIRA starts-up

In case of non-Trial licenses, you will have to perform the step 5
Start JIRA and follow the default Setup Wizard:

As soon as JIRA Setup is ended, Minyaa starts automatically its installation.

Minyaa will process following tasks :
See below, parts of log in case of Minyaa 2.2 with JIRA 3.13.
  1. License will be controlled : If no license is found, an deactivation of Minyaa is processed.

    ERROR [minyaa.license.managers.ProductLicenseManager] There is no license certificate installed for Minyaa Suite for JIRA.
    WARN [minyaa.license.manager.AbstractPluginLicenseManager] Try Auto-Registration with Key file, if present!
    


  2. For each available Minyaa plugin, required changes in Database Model are applied,

    WARN [atlassian.jira.service.ConsistencyCheckerService$1] Start to apply Entity Model change defined in [com.minyaa.model.MinyaaCoreModelManager] for Plugin [jira.plugin.minyaa.core]
    WARN [core.entity.jdbc.DatabaseUtil] Entity "MyaaConstantMapping" has no table in the database
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] No ModelManager for Plugin [jira.plugin.minyaa.tools]
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] Start to apply Entity Model change defined in [com.minyaa.model.MinyaaTimeModelManager] for Plugin [jira.plugin.minyaa.time]
    WARN [core.entity.jdbc.DatabaseUtil] Entity "TimesheetEntity" has no table in the database
    WARN [core.entity.jdbc.DatabaseUtil] Entity "TimesheetScheme" has no table in the database
    WARN [core.entity.jdbc.DatabaseUtil] Entity "WorklogExt" has no table in the database
    WARN [core.entity.jdbc.DatabaseUtil] Entity "WorklogType" has no table in the database
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] No ModelManager for Plugin [jira.plugin.minyaa.workflows]
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] No ModelManager for Plugin [jira.plugin.minyaa.projects]
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] Start to apply Entity Model change defined in [com.minyaa.model.MinyaaSpreadModelManager] for Plugin [jira.plugin.minyaa.spread]
    WARN [core.entity.jdbc.DatabaseUtil] Entity "LinkEntity" has no table in the database
    WARN [core.entity.jdbc.DatabaseUtil] Entity "LinkScheme" has no table in the database
    


  3. For each available Minyaa plugin, UpgradeManagers are launched,

    WARN [atlassian.jira.service.ConsistencyCheckerService$1] Start UpgradeManager [com.minyaa.upgrade.MinyaaCoreUpgradeManager] for Plugin [jira.plugin.minyaa.core]
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Detected that an upgrade is needed; existing data at build 0
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Doing Upgrade...
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Upgrades Kaamelot's Portlets to Minyaa's Portlets
    ...
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Upgrades Kaamelot's Portlets to Minyaa's Portlets' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 1
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Analyses all Workflows to identify required changes ...
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Analyses all Workflows to identify required changes ...' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 2
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Migrates Kaamelot's CustomFields to Minyaa's CustomFields
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Migrates Kaamelot's CustomFields to Minyaa's CustomFields' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 3
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Upgrades Kaamelot Roll Over Backup Service
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Upgrades Kaamelot Roll Over Backup Service' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 4
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade succeeded! Setting data build number to 5
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] Start UpgradeManager [com.minyaa.upgrade.MinyaaToolsUpgradeManager] for Plugin [jira.plugin.minyaa.tools]
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Detected that an upgrade is needed; existing data at build 0
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Doing Upgrade...
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Upgrades Configuration for RegExp and UserGroupsPicker
    WARN [minyaa.upgrade.tasks.MinyaaToolsUpgradeTask_001] Updating RegExp CustomField Config
    WARN [minyaa.upgrade.tasks.MinyaaToolsUpgradeTask_001] Updating RegExp CustomField Config
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Upgrades Configuration for RegExp and UserGroupsPicker' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 1
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade succeeded! Setting data build number to 1
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] Start UpgradeManager [com.minyaa.upgrade.MinyaaTimeUpgradeManager] for Plugin [jira.plugin.minyaa.time]
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Detected that an upgrade is needed; existing data at build 0
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Doing Upgrade...
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Upgrades Relation between Worker/Issue
    WARN [minyaa.upgrade.tasks.MinyaaTimeUpgradeTask_001] Updating Issue/Worker Relations
    WARN [minyaa.upgrade.tasks.MinyaaTimeUpgradeTask_001] Starting to update Issue/Worker Relations for [admin]
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Upgrades Relation between Worker/Issue' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 1
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Migrates Worker CustomField to CurrentWorker CustomField
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Migrates Worker CustomField to CurrentWorker CustomField' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 2
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Update of Minyaa's Portlets [MYAA-182]
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Update of Minyaa's Portlets [MYAA-182]' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 3
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Upgrading Worklog Closure Settings
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Upgrading Worklog Closure Settings' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 4
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Upgrade Timesheet Configuration is Timesheet Management is enabled
    ERROR [minyaa.upgrade.tasks.MinyaaTimeUpgradeTask_005] admin.schemes.timesheet.management.error.timesheet.unavailable
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Upgrade Timesheet Configuration is Timesheet Management is enabled' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 5
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade succeeded! Setting data build number to 5
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] Start UpgradeManager [com.minyaa.upgrade.MinyaaWorkflowsUpgradeManager] for Plugin [jira.plugin.minyaa.workflows]
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Detected that an upgrade is needed; existing data at build 0
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Doing Upgrade...
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Disable JIRA Workflow Function (Replaced by Minyaa Workflows functions)
    WARN [minyaa.upgrade.tasks.MinyaaWorkflowsUpgradeTask_001] Disabling Workflow Permission Condition [com.atlassian.jira.plugin.system.workflow:permission-condition]
    WARN [minyaa.upgrade.tasks.MinyaaWorkflowsUpgradeTask_001] Disabling Workflow Permission Validator [com.atlassian.jira.plugin.system.workflow:permission-validator]
    WARN [minyaa.upgrade.tasks.MinyaaWorkflowsUpgradeTask_001] Minyaa provides 2 new Workflows Function providing similar features default Permission Conditon and Validator. See http://www.minyaa.com/documentation/latest/Features/ModuleCore/WorkflowConditions/ExtendedPermissionCondition.html and http://www.minyaa.com/documentation/latest/Features/ModuleCore/WorkflowValidators/ExtendedPermissionValidator.html
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Disable JIRA Workflow Function (Replaced by Minyaa Workflows functions)' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 1
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Apply default color to Workflow Designer
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Apply default color to Workflow Designer' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 2
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Performing Upgrade Task: Enable JIRA Workflow Function (See MYAA-658)
    WARN [minyaa.upgrade.tasks.MinyaaWorkflowsUpgradeTask_003] Enabling Workflow Permission Condition [com.atlassian.jira.plugin.system.workflow:permission-condition]
    WARN [minyaa.upgrade.tasks.MinyaaWorkflowsUpgradeTask_003] Enabling Workflow Permission Validator [com.atlassian.jira.plugin.system.workflow:permission-validator]
    WARN [minyaa.upgrade.tasks.MinyaaWorkflowsUpgradeTask_003] Minyaa provides 2 Workflows Functions providing similar features as default Permission Conditon and Validator to allow the use of Custom Permissions. See http://www.minyaa.com/documentation/latest/Features/ModuleCore/WorkflowConditions/ExtendedPermissionCondition.html and http://www.minyaa.com/documentation/latest/Features/ModuleCore/WorkflowValidators/ExtendedPermissionValidator.html
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade Task: 'Enable JIRA Workflow Function (See MYAA-658)' succeeded
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Setting current build number on to 3
    INFO [atlassian.jira.upgrade.AbstractPluginUpgradeManager] Upgrade succeeded! Setting data build number to 3
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] No UpgradeManager for Plugin [jira.plugin.minyaa.projects]
    WARN [atlassian.jira.service.ConsistencyCheckerService$1] No UpgradeManager for Plugin [jira.plugin.minyaa.spread]
    


  4. JIRA is ready for user after that.