This page last changed on Jun 15, 2009 by smaddox.
Before reading the information below, please make sure that you have installed the Atlassian IntelliJ Connector, as described in the Installation Guide.
The Atlassian IntelliJ Connector stores configuration settings at two levels in IntelliJ IDEA:
- Server connections are stored as project settings in IntelliJ IDEA. Project settings allow you to share the same server connections with other members of your project team. Additionally, if you work on more than one project, this allows you to configure different servers for each project. Project-level settings can be stored in your source control repository, so that the connector will load the settings at the same time as loading the project into IDEA.
- Other options are stored as IDE settings in IntelliJ IDEA. IDE settings allow each developer to configure their own workspace-specific settings, such as polling intervals and the behaviour of notification popups.
On this page:
Configuring your Crucible Server Connections
To configure your Crucible server connection(s):
- Go to the 'Project Settings' for the 'Atlassian Connector', by doing one of the following:
- Open the IDEA 'Settings' dialogue, then go to the 'Project Settings' section and click the 'Atlassian Connector'
icon.
- Or you can click the configuration icon
on your connector window.
- Click the 'Servers' tab.
To add a Crucible server:
- Click the plus icon
on the configuration panel.
- A list of server types will appear. Select 'Add Crucible Server'.
- A form will appear. Enter the information as follows:
- 'Server Enabled' — Leave this checkbox ticked (default). If necessary, you can remove the tick to disable particular servers without deleting them. This is useful if your servers are behind a firewall and you don't have access to them.
- 'Server Name' — A description of your Crucible server.
- 'Server URL' — The address of your Crucible server.
- 'Username' and 'Password' — The login name and password you use to access the Crucible server.
- 'Remember Password' — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
If you choose to remember the password, it is stored in a Base64 encoding, so it is not really secure.
- 'Use Default Credentials' — Put a tick in the checkbox if you want to use the single username and password that you have defined as your default credentials. You can set the default credentials on the 'Defaults' tab.
- Click the 'Test Connection' button to check that the connection to the server works.
- If your Crucible server is linked to a FishEye server, put a tick in the checkbox labelled 'Crucible Server Contains FishEye Instance'. Remember to set up your FishEye defaults, as described in Configuring your FishEye Options in IDEA.
Don't worry if you do not have a FishEye server. There is very little effect on the connector's functionality. The only think you will not be able to do, is to access a FishEye diff view of the source code under review.
- Click 'Apply' to save your changes and continue with server configuration.
- Click the 'Defaults tab to set up a default Crucible server, project and repository. These defaults will be used when you create a review directly from your source within IDEA.
- Now you can configure the Crucible options, as described below.
You can add more than one Crucible server.
Configuring your Crucible Options
- Open the IDEA 'Settings' dialogue, then go to the 'IDE Settings' section and click the 'Atlassian Connector' icon.
- Define the settings as follows:
- 'Popups' — Define the behaviour of the popup window that is shown when someone adds a Crucible review that affects you. (For an example of the popup itself, see Working with Crucible Reviews in IDEA.) You can choose to see a popup window whenever a review is added to the Crucible server, or you can choose not to see any popups at all.
- 'Background refresh every xx minutes' — Set the polling interval that the connector will use to monitor all defined Crucible servers. Specify the value in minutes. The default is 10 minutes.
- 'Timeout review creation after xx minutes' — Specify the number of minutes to allow, after you have initiated a new review, before the review creation will be timed out. The default is 5 minutes.
Crucible (or Fisheye to be more exact) does not necessarily notice a new Subversion commit immediately. Instead, it polls the repository for changes every minute or so. If you commit some files and then try to create a review right away, this will fail. The connector detects the error and continues attempting to create the review every 10 seconds until it is successful or until it times out.
- Click 'OK' to save your changes.
Screenshot: Configuring Crucible server connections
Screenshot: Configuring Crucible IDE options

RELATED TOPICS
Working with Crucible Reviews in IDEA
Installation and Upgrade Guide for the IntelliJ Connector
|