If you have already been using Atlassian JIRA, and are now configuring JIRA as a Crowd application, you will probably want to import your existing JIRA users and groups into a Crowd directory.
It is recommended that you import your JIRA users into an Internal Directory that has its 'Password Encryption' set to 'ATLASSIAN-SECURITY'. Otherwise, users' passwords will not be copied across to Crowd.
To import users and groups from Atlassian JIRA into a Crowd directory,
- Ensure that the database drivers for the JIRA database are on Crowd's classpath. To do this, simply copy the JDBC driver jar for your particular JIRA database across to
apache-tomcat/common/lib in your Crowd installation directory. Then restart Crowd.
- Log in to the Crowd Administration Console.
- Click the 'Users' link in the top navigation bar.
- This will display the User Browser. Click the 'Import Users' link.
- This will display the 'Import Type' screen. Click the 'Atlassian Importer' button.
- This will display the 'Options' screen. Complete the fields as follows:
- 'Atlassian Product' — Select 'JIRA'.
- 'Directory' — Select the directory that you have created for your JIRA users.
- 'Import Passwords' — Select this checkbox if you wish to import the users' passwords from JIRA. You can only import passwords if the Crowd directory is using the 'Atlassian SHA1' encryption method.
- 'Product Database URL' — Type the URL of your JIRA instance's database. The exact syntax will depend on which database you are using; see Connecting JIRA to a Database in the JIRA Installation Guide.
- 'Database Driver' — Type the name of your JIRA instance's database JDBC driver, e.g.
- 'Username' — Type the username of the database user that Crowd will use to log in to your JIRA instance's database.
- 'Password' — Type the password of the database user Crowd will use to log in to your JIRA instance's database.
The import process will log in to the database, not into JIRA.
- Click the 'Continue' button to import the users from your JIRA instance into your Crowd directory.
- The 'Results' screen will be displayed, showing how many users and groups have been imported into your Crowd directory.
- Click the 'Users' button to view and manage the imported users and groups via the Crowd Administration Console (assuming the directory's permissions allow this).
Screenshot: 'Import JIRA Users'
To give the imported groups access to the JIRA application, see Specifying which Groups can access an Application.