JIRA¶
General Setup¶
Navigate to https://jira.example.org/secure/admin/ViewApplicationProperties.jspa
Click
Edit Settings
Base URL: <set as appropriate> Introduction: <p>You will need a Linux Foundation ID to login here.</p> <p style="color:red"> You can create a Linux Foundation ID username (or request a new password if forgotten) at <a href="https://identity.linuxfoundation.org"> https://identity.linuxfoundation.org </a>. </p>
Navigate to https://jira.example.org/secure/admin/EditDefaultDashboard!default.jspa
Move the “Introduction” widget to under the “Your Company JIRA” widget
Navigate to https://jira.example.org/secure/admin/EditAnnouncementBanner!default.jspa
Configure the Annoucement as follows:
<style type="text/css"> div#publicmodeoffmsg { display: none; } a#forgotpassword { display: none; } a#login-form-cancel { display: none; } /* a.aui-nav-link.login-link { display: none; } */ </style>
Set Visibility Level to
Public
Navigate to https://jira.example.org/secure/admin/OutgoingMailServers.jspa
Configure outgoing email as follows:
Name: localhost From address: jira@example.org Email prefix: [JIRA] Protocal: SMTP Host Name: localhost
Click Update
LDAP¶
Navigate to https://jira.example.org/plugins/servlet/embedded-crowd/directories/list
Click
Add Directory
Choose
Internal with LDAP Authentication
and clickNext
Configure LDAP
Name: Delegated LDAP Authentication Directory Type: OpenLDAP Hostname: ldap.example.org Port: 636 Use SSL: True Copy User on Login: True Default Group Membership: jira-software-users Synchronize Group Memberships: True Base DN: dc=example,dc=org User Name Attribute: uid Additional User DN: ou=Users User Display Name Attribute: cn # Group Schema Settings Additional Group DN: ou=Groups Group Object Class: groupOfNames Group Object Filter: (&(objectclass=groupOfNames)(|(cn=PROJECT-*)(cn=lf-releng)(cn=lf-sysops)(cn=lf-helpdesk))) # Membership Schema Settings Group Members Attribute: member User Membership Attribute: memberOf
Note
In Group Object Filter, change cn=PROJECT-* to replace PROJECT with the group prefix for the project you want to have group permissions on this JIRA instance. Eg. odl, onap, opnfv, etc…
Click
Save and Test
Ensure the
Internal
directory has higher precedence thanOpenLDAP
At this point we should be able to log in using our personal account to continue managing the JIRA Server. This is necessary for the LDAP admin groups to appear.
Admin Permissions¶
Navigate to https://jira.example.org/secure/admin/GlobalPermissions!default.jspa
Add
lf-collab-admins
andlf-helpdesk
to the following groups:JIRA System Administrators
JIRA Administrators
Browse Users
Create Shared Objects
Manage Group Filter Subscriptions
Bulk Change
Post configuration¶
Inform LF Helpdesk about new Jira instance
Create a new Helpdesk ticket with the following text:
Greetings Helpdesk, This is a notification that a new JIRA is online at https://jira.example.org and ready for you to take on license management and renewals. Please install the initial trial license. Thanks, Releng