This is the documentation for an older version of Folio and has been moved to the Tempo instance.
Please view the Folio Category in the Tempo Products Wiki Categories for all versions of Folio's Documentation.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

 

 

Before you begin

Please note the following information before you install, upgrade or remove FOLIO:

  • You must have the 'JIRA System Administrators' global permission.
  • Please check the Supported Platforms to ensure your version of JIRA supports the FOLIO version to be installed.
  • Chrome, Firefox, Safari and Internet Explorer 9 or higher are supported.

 

FOLIO will add additional tables to your JIRA database. Enabling or disabling FOLIO within your installed plugins will not cause any damage to your JIRA data.

 

Installing FOLIO

Instructions in the following sections may differ depending on your versions of JIRA and the Universal Plugin Manager (UPM).  See Atlassian documentation on add-on installation for more details.

  1. Log into JIRA as a user with the 'JIRA System Administrators' global permission.
  2. Click the Add-ons item in the cog menu at the top right.
  3. Select the Find new add-ons link on the left navigation bar. Featured plugins available for JIRA will be shown.
  4. Type 'FOLIO' in the search field and hit Enter. The FOLIO plugin will appear in the results.
  5. Click the Manage button. A confirmation message and the plugin details will be displayed when FOLIO is installed.

Manually installing FOLIO

  1. Download a FOLIO installation (.obr) file from the Atlassian Marketplace.
  2. Log into JIRA as a user with the 'JIRA System Administrators' global permission.
  3. Click the Add-ons item in the cog menu at the top right.
  4. Select the Manage add-ons link on the left navigation bar. The Universal Plugin Manager page will be displayed.
  5. Click the Upload add-on link and select FOLIO's installation file you have previously downloaded.
  6. Click the Upload button. A confirmation message and the plugin details will be displayed when FOLIO is installed.

Editing your FOLIO License

To enter your FOLIO License details:

  1. Log in as a user with the 'JIRA System Administrators' global permission.
  2. Click the Add-ons item in the cog menu at the top right.
  3. Select the Manage add-ons link on the left navigation bar. The Universal Plugin Manager page will be displayed.
  4. Click the FOLIO section to expand it.
  5. Paste your license into the License Key field and click Add.

 

You can copy your FOLIO license from https://my.atlassian.com, where you can either generate a new Evaluation License Key or retrieve your old License Key if you already have one.

Licensing

If you need to change your FOLIO license details at any time in the future, please refer to Specifying your License Details. Please note that if you are using a commercial (i.e. not an evaluation) license for FOLIO then it must match your JIRA's license. For example, if you have a JIRA 25 User Commercial license you must have a FOLIO 25 User Commercial license. FOLIO evaluation licenses do not need to match JIRA licenses.

 

Starting FOLIO

Click the 'FOLIO' tab in the top bar to go to FOLIO. Alternatively, you can type the shortcut keys g, then f from anywhere in JIRA to go to FOLIO.

Configuring FOLIO

To configure FOLIO, please refer to the online documentation.

Which languages are supported?

English and French. More languages will be supported in future releases.

 

Upgrading FOLIO

(warning) Before you begin, please read the latest  FOLIO 5.0 Release Notes and version-specific Upgrade Notes (if any) and ensure that you are running a version of JIRA that is compatible with your new version of FOLIO.

To upgrade FOLIO:

  1. Log in as a user with the 'JIRA System Administrators' global permission.
  2. Click the Add-ons item in the cog menu at the top right.
  3. Select the Manage add-ons link on the left navigation bar. The Universal Plugin Manager  page will be displayed.

  4. Click the FOLIO section to expand it.

  5. Click the 'Update' button.

 

To upgrade FOLIO manually (e.g. if your FOLIO system does not have internet access), please follow the manual installation instruction.

 

Disabling FOLIO

To disable FOLIO:

  1. Log in as a user with the 'JIRA System Administrators' global permission.
  2. Click the Add-ons item in the cog menu at the top right.
  3. Select the Manage add-ons link on the left navigation bar. The Universal Plugin Manager  page will be displayed.
  4. Click  the FOLIO section to expand it.
  5. Click the Disable button.

Getting Help

You may find answers in our FAQ page. Our online documentation contains information about using and administering FOLIO for JIRA. If you still cannot find answers you can submit your question to the Atlassian's user-based community or contact the FOLIO team directly.

Got some Issues? 

For production or evaluation issues, please feel free to report them directly in FOLIO's public backlog. A support engineer will follow up with you quickly.

On this page:

Related pages:

  • No labels