Minyaa - Minyaa's Installation in 10 Steps

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.

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!

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

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]

JIRA is read for user after that.

Minyaa Suite

Features by Plugin

Features by Plugin Module

Features for Developers

Minyaa's Installation in 5 Steps

What is it?

Minyaa Installation

See also