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

For previous releases, see 2.3 Documentation.

Minyaa Installation

Prepare Standalone JIRA distribution :
  • Download the JIRA Standalone Distribution (here 4.2).
  • 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-2.4.jar
      • jira-plugin-minyaa-core-X.Y.Z-2.4.jar
      • jira-plugin-minyaa-projects-X.Y.Z-2.4.jar
      • jira-plugin-minyaa-spread-X.Y.Z-2.4.jar
      • jira-plugin-minyaa-time-X.Y.Z-2.4.jar
      • jira-plugin-minyaa-time-reports-X.Y.Z-2.4.jar
      • jira-plugin-minyaa-tools-X.Y.Z-2.4.jar
      • jira-plugin-minyaa-workflows-X.Y.Z-2.4.jar
      • jira-plugin-minyaa-workflows-designer-X.Y.Z-2.4.jar


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


Copy your Minyaa 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

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)
As soon as JIRA Setup is ended, Minyaa start 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.