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

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).
  • Plugin JARs (JIRA Plugin V1) and Minyaa's its dependencies to the atlassian-jira/WEB-INF/lib folder :
    • jira-plugin-minyaa-core-X.Y.Z-2.2.jar
    • jira-plugin-minyaa-i18n-X.Y.Z-2.2.jar
    • jira-plugin-minyaa-projects-X.Y.Z-2.2.jar
    • jira-plugin-minyaa-spread-X.Y.Z-2.2.jar
    • jira-plugin-minyaa-time-X.Y.Z-2.2.jar
    • jira-plugin-minyaa-time-reports-X.Y.Z-2.2.jar
    • jira-plugin-minyaa-tools-X.Y.Z-2.2.jar
    • jira-plugin-minyaa-workflows-X.Y.Z-2.2.jar




  • 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.7.jar
    • dwr-2.0.5.jar
    • truelicense-1.29.jar
    • truexml-1.29.jar




  • Plugin JARs (JIRA Plugin V2) to the atlassian-jira-home/plugins/installed-plugins folder :
    Minyaa Plugin V2 are provided only for JIRA 4.0.x and over.
    • jira-plugin-minyaa-core-gadgets-X.Y.Z-2.2.jar
    • jira-plugin-minyaa-time-gadgets-X.Y.Z-2.2.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.

See also