Installing JIRA locally with MAMP PRO (4.1.1)

Installing JIRA locally with MAMP PRO (4.1.1).md

Installing JIRA locally with MAMP PRO (4.1.1)

Steps taken beforehand

Installing MAMP PRO

1. Install MAMP PRO

• Via MAMP PRO > Ports (in the left bar), change the default ports to 80 for Apache, 81 for Nginx and 3306 for MySQL (this can be done easily by clicking the button Set ports to 80, 81, 443, 7443 and 3306)
• (optional) Change PHP version via MAMP PRO > PHP (in the left bar)
• (optional) Configure the php.ini settings via MAMP PRO > File > Edit template > PHP > {active PHP version}
• Run servers

Installing JAVA

1. In Terminal, type

$ java version

• If not currently installed, press 'More info' on the prompt window
• Download Java version from the webpage
• Open the archive (for example: jdk-8u121-macosx-x64.dmg)
• Follow the steps in the wizard
• When installation is finished, retype the command from step 1 in Terminal to check the installation has succeeded.
• Setup JAVA_HOME variable in Terminal:

export JAVA_HOME=`/System/Library/Frameworks/JavaVM.framework/Versions/Current/commands/java_home`

Steps to take

Installing JIRA

Atlassian has documentation on this subject as well. The steps I took are written below.

1. Create a new folder JIRA in your htdocs folder

• Download the JIRA Server archive, and extract the contents to Applications/MAMP/htdocs/JIRA
• Create a new folder jira-home in the JIRA folder
• Open Applications/MAMP/htdocs/JIRA/atlassian-jira/WEB-INF/classes/jira-application.properties with any text editor and set the value of jira.home:

jira.home = /Applications/MAMP/htdocs/JIRA/jira-home

• Save the file and close it

Setting up the database

Atlassian has documentation on this subject as well. The steps I took are written below.

1. Open phpMyAdmin via http://localhost:8888/phpmyadmin (default location)

• Create a new database user jiradbuser and grant all privileges
• Create a new database jiradb
• Open MAMP PRO, and edit the my.cnf file via MAMP PRO > File > Edit template > MySQL (my.cnf) > 5.6.35
  • Add the following rule below [mysqld]:

    default-storage-engine=INNODB
    

  • Set the value for max_allowed_packet to 256M
  • Uncomment innodb_log_file_size and set the value to 256M
  • Comment out MAMP_bind-address_MAMP
  • Add a rule directly below this:

    bind-address = 127.0.0.1
    

  • Comment out MAMP_skip-networking_MAMP
• Restart servers
• Download the platform independent JDBC Connector/J5.1 and extract the contents of the file
• Copy the jar for the driver (e.g. mysql-connector-java-5.x.x-bin.jar) to Applications/MAMP/htdocs/JIRA/lib

Running the wizard

1. Start JIRA via the Terminal (assuming the current directory is the installation folder Applications/MAMP/htdocs/JIRA):

$ /bin/start-jira.sh

• Open http://localhost:8080/
  • Troubleshooting: If this page doesn't respond, first check if $JAVA_HOME is set correctly or if virus scanning / firewall software is blocking access
• Select "I'll set it up myself" and click "Next"
• Select "My Own Database" and fill in the additional fields as follows:

  Database type:      MySQL
  Hostname:           localhost
  Port:               3306
  Database:           jiradb
  Username:           jiradbuser
  Password:           *password*
  

• Proceed by clicking "Next"
• Set up the application properties in the next step:

  Application title:  *title*
  Mode:               Private
  Base URL:           http://localhost:8080
  

• Click "Next" again
• If you have a license, fill it in here and skip to step 12. Otherwise, click the link generate a JIRA trial license
• On the following web page, fill in the fields that aren't prefilled:

  License type:       JIRA Software (Server) (click on the blue button)
  Organization:       *organization name*
  

• Click on the button "Generate License"
• On the next page, confirm you want to install the license on your localhost server by clicking the "Yes" button in the modal screen
• Click "Next"
• Set up an administrator account. Fill in the fields as you please, and click "Next"
• For now, skip configuring email notifications by selecting "Later" in the next screen.
• Click "Finish"

Configuration

From here, JIRA is completely installed and you can configure it to your personal preferences. Steps you will take are choosing a language and an avatar.

After this, you can choose between:

• See a project in action
• Create a new project
• Import from another tool

That's it!