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.0.

For previous releases, see 2.5 Documentation.

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 the JIRA Standalone Distribution (here 4.3).
  • 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).
  • Into the atlassian-jira/WEB-INF/lib folder :
    • Plugin JARs (JIRA Plugin V1):
      • jira-plugin-minyaa-boot-X.Y.Z-3.0.jar
      • jira-plugin-minyaa-core-X.Y.Z-3.0.jar
      • jira-plugin-minyaa-projects-X.Y.Z-3.0.jar
      • jira-plugin-minyaa-spread-X.Y.Z-3.0.jar
      • jira-plugin-minyaa-time-X.Y.Z-3.0.jar
      • jira-plugin-minyaa-time-reports-X.Y.Z-3.0.jar
      • jira-plugin-minyaa-tools-X.Y.Z-3.0.jar
      • jira-plugin-minyaa-workflows-X.Y.Z-3.0.jar
      • jira-plugin-minyaa-workflows-designer-X.Y.Z-3.0.jar
      • jira-plugin-minyaa-reports-X.Y.Z-3.0.jar


    • Minyaa's I18n resources :
      • jira-plugin-minyaa-i18n-default-X.Y.Z-3.0.jar (English)
      • jira-plugin-minyaa-i18n-de_DE-X.Y.Z-3.0.jar (German)
      • jira-plugin-minyaa-i18n-en_US-X.Y.Z-3.0.jar (English)
      • jira-plugin-minyaa-i18n-fr_FR-X.Y.Z-3.0.jar (French)
      • jira-plugin-minyaa-i18n-pl_PL-X.Y.Z-3.0.jar (Polish)
      • jira-plugin-minyaa-i18n-ru_RU-X.Y.Z-3.0.jar (Russian)
      • jira-plugin-minyaa-i18n-tr_TR-X.Y.Z-3.0.jar (Turkish)
      • jira-plugin-minyaa-i18n-uk_UA-X.Y.Z-3.0.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.8.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.0.jar
    • jira-plugin-minyaa-time-gadgets-X.Y.Z-3.0.jar
    • jira-plugin-minyaa-reports-gadgets-X.Y.Z-3.0.jar


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:

  • Enter JIRA Application Title,
  • Select Indexes, Backup and Attachments directories,
  • Enter JIRA License Key
  • Configure Mail Server (if needed)
In case of non-Trial Licenses, you will have to register the Minyaa Licences using the Minyaa License screen.

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 read for user after that.