Running the Setup Wizard

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Before running the Setup Wizard described below, please follow the instructions on installing Crowd.

When you access the Crowd Administration Console for the first time, you will see the Crowd Setup Wizard. This is a series of screens which will prompt you to configure your database connection and to supply some default values (which you can change later if necessary).

On this page:

tip/resting Created with Sketch.

Do you need to restart the Setup Wizard from the beginning?

Read this hint in the Crowd Knowledge Base.

Step 1. Starting the Setup Wizard

Go to the following URL in your web browser: http://localhost:8095/crowd or http://localhost:8095/crowd/console.

  • If there are no errors, you should see the 'License' screen described below.
  • If there is an error in your configuration, you will see the 'Crowd Checklist' screen. Read more about troubleshooting your installation.

Step 2. Licensing

Crowd licenses are based on the number of end-users who will log in to the applications that are integrated with Crowd.

You can obtain an evaluation license from the Atlassian website. When you obtain an evaluation license — or purchase, renew or upgrade your license — you will receive a license key via email or on the Atlassian website.

Type or paste your license key into the 'License' field, shown on the screenshot above.

Step 3. Installation Type



In this step, you will choose whether to set up a new Crowd database or restore an existing database. Choose an option as follows:

  • 'New Installation' — Set up a new Crowd database.
    (tick) Hint: Choose this option if you are evaluating Crowd.
  • 'Import data from an XML Backup' — Import your Crowd data from an XML backup file, which has been exported from your existing Crowd installation.

Step 4. Database Configuration

The 'Database Configuration' screen allows you to choose the type of database connection, as described below.

tip/resting Created with Sketch.

If in any doubt, choose the default '*Embedded*' option for evaluation purposes.

 

(info) When you click 'Continue' after choosing your database options, there may be a short wait while Crowd writes the information to the database tables. Please be patient.

Database Option 1: Embedded HSQLDB (For Evaluation Purposes Only)



The Crowd distribution (not EAR-WAR) is shipped with an embedded HSQLDB database. If you choose the 'Embedded' option, the data files are stored in the Crowd Home directory, as configured on installation.

The HSQLDB database is fine for evaluation purposes, but for production installations you should connect Crowd to an enterprise database using the JDBC or JNDI datasource connections described below. This also lets you take advantage of your existing database backup and recovery procedures.

Database Option 2: JDBC Connection



Select the 'JDBC Connection' if you want to connect to an external database via a JDBC connection. (If you have not yet created your database for Crowd, follow the database setup instructions.)

Supply the details for your database:

Field

Description

Database

Select your database server type.

Driver Class Name

Enter the class name for your database driver. Make sure that the class is in the class path on your application server. See guidelines on creating your specific database.

JDBC URL

Enter the URL at which Crowd can access the database JDBC connection. Do note that if you wish to change the default database name, you can specify it in the URL as well. E.g. for SQL Server, the default URL is jdbc:jtds:sqlserver://localhost:1433/crowd , and if you wish to connect to crowddb instead, modify the URL so that it looks like this: jdbc:jtds:sqlserver://localhost:1433/crowddb

Username

Enter the username which Crowd will use to access the database.

Password

Enter the password corresponding to the above username.

Hibernate Dialect

This is the Hibernate configuration for the selected database type. The Crowd installation will supply a default dialect for the database type you have chosen. You should only alter this dialect if you need an alternative for the database type or are using an unsupported database type.

  • To configure Crowd to support Unicode in MS SQL Server 2005 and 2008, enter the following in the 'Hibernate Dialect' field on the Crowd Setup Wizard's Database Configuration screen:
    com.atlassian.crowd.util.persistence.hibernate.SQLServerIntlDialect

Overwrite Existing Data

Crowd will ask you to confirm that existing data should be overwritten, if both of the following are true:

  • You chose 'New Installation' or 'Import data from an XML Backup' in Step 3 above, and
  • The database configured on the above screen already exists and contains Crowd data.

Database Option 3: JNDI Datasource



Select the 'JNDI Datasource' if you want to connect to an external database via a datasource managed by your application server.

Supply the details for your database:

Field

Description

Database

Select your database server type.

JNDI Name

Enter the datasource name, e.g. jdbc/CrowdDS or java:comp/env/jdbc/CrowdDS.

Hibernate Dialect

This is the Hibernate configuration for the selected database type. The Crowd installation will supply a default dialect for the database type you have chosen. You should only alter this dialect if you need an alternative for the database type or you have selected an unsupported database type.

  • To configure Crowd to support Unicode in MS SQL Server 2005 and 2008, enter the following in the 'Hibernate Dialect' field on the Crowd Setup Wizard's Database Configuration screen:
    com.atlassian.crowd.util.persistence.hibernate.SQLServerIntlDialect

Overwrite Existing Data

Crowd will prompt you to confirm that existing data should be overwritten, if both of the following are true:

  • You chose 'New Installation' or 'Import data from an XML Backup' in Step 3 above, and
  • The database configured on the above screen already exists and contains Crowd data.

Step 5. (Optional) Import Existing Crowd Data



This screen will appear only if you selected 'Import data from an XML Backup' in Step 3 above.

In 'File Location', enter the full path to your XML backup file including the name of the XML file.

tip/resting Created with Sketch.

Upgrading from an existing Crowd installation?

If you have connected to an existing database or imported your data from XML, the setup will be complete once you have clicked 'Continue' on the above screen. See Step 11 below and read more about upgrading Crowd.

Step 6. Options



This part of the setup process allows you to specify general options for the Crowd server.

  • The deployment title is a unique name for your Crowd instance. The deployment title is used by default in the subject line of email notifications.

    You can change this value later, via the Crowd Administration Console.
  • The session timeout determines how long a session will be considered valid during any period of inactivity. This value is specified in minutes and must be greater than 0.

    You can change this value later, via the Crowd Administration Console.
  • The base URL is the website address of the Crowd server. You can change this value later, via the Crowd Administration Console.

Step 7. (Optional) Mail Server

Crowd can send email notifications to users for specific events, such as when a password is reset.

The 'Mail Configuration' screen allows you to choose between an SMTP and a JNDI mail server, as described below. You can also skip this step. If you do so, Crowd will not be able to send email notifications until the mail configuration is entered via the Crowd Administration Console.

tip/resting Created with Sketch.

If in any doubt, skip this step for evaluation purposes.

 

Mail Server Option 1: SMTP



Enter the details as follows:

  • Notification Email Address — The email address which will receive notifications about server events.
  • From Email Address — Crowd will add this email address as the 'sender' on the emails generated by Crowd and sent to users.
  • Subject Prefix — The prefix which will appear at the start of the email subject, for all emails generated by Crowd. This can be useful for email client programs that offer filtering rules.
  • Mail Server Type — Select the 'SMTP Server' radio button.
  • SMTP Host — The hostname of the SMTP mail server, e.g. 'localhost' or 'smtp.acme.com'.
  • SMTP Port — The port on which the SMTP mail server listens. The default is '25'.
  • Username — The username that your Crowd server will use when it logs in to your mail server.
  • Password — The password that your Crowd server will use when it logs in to your mail server.
  • Use Secure Sockets Layer (SSL) — Select this check-box if you want to access your mail server over SSL (Secure Sockets Layer). This ensures that all email communications between Crowd and your mail server are encrypted, provided your mail server supports SSL.

Mail Server Option 2: JNDI Location



Select the 'JNDI Location' if you want to connect to a mail server via a datasource managed by your application server.

Enter the details as follows:

  • Notification Email Address — The email address which will receive notifications about server events.
  • From Email Address — Crowd will add this email address as the 'sender' on the emails generated by Crowd and sent to users.
  • Subject Prefix — The prefix which will appear at the start of the email subject, for all emails generated by Crowd. This can be useful for email client programs that offer filtering rules.
  • Mail Server Type — Select the 'JNDI Location' radio button.
  • JNDI Location — The datasource name of a javax.mail.Session object which has been set up by your application server.

Step 8. Default Directory



Please configure a default user directory. For information about configuring different types of directories (Internal, LDAP, Delegated Authentication or Custom) refer to Adding a Directory.

Crowd administrators group is in default directory

The default group crowd-administrators will be automatically created in the default directory. Members of this group have rights to administer Crowd.

Step 9. Default Administrator



Please specify a default Crowd administrator. The default administrator will be automatically added to the default group crowd-administrators, thereby giving them rights to access the Crowd Administration Console.

Step 10. Integrated Applications



You have the option to auto-configure two applications.

Step 11. Setup Complete

You are now ready to log in with the default administrator account you have just created, and use the Crowd Administration Console. For details, please see the Administration Guide.

RELATED TOPICS

Last modified on Jul 11, 2017

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.