This tutorial is part of the Identity Manager track within the Identity Suite Essentials program.

Description

This tutorial covers the installation and configuration of a developer environemt for Sun Identity Manager. The current development environment for Sun Identity Manager uses a Netbeans plugin. This allows a complete development environment to be setup quickly. This module does not go into advanced options of the Identity Manager Netbeans plugin, for more advanced information, see: How To Setup An IDM Project.

Top

Learning Objectives

After completing this tutorial, the following topics should be understood.

1. Install Sun Identity Manager development environment
2. Create a Identity Manager project
3. Use the Identity manager Debugger

Top

Prerequisites

The following items must be completed before starting this tutorial.

• Workstation with 2 GB RAM and 1 GB free disk space
• Access to the internet to download the required installation files
• Java Development Kit (JDK) version 1.5 or version 6 installed
• Obtain the Identity Suite Essentials zip file

Top

Setup

The following steps need to performed to enable the demonstration.

Section 1: Netbeans 6.1 with Glassfish v2ur2

Download Netbeans 6.1 and Glassfish v2ur2 Netbeans includes several download options. The requirements for this tutorial are Netbeans 6.1 and Glassfish v2ur2. The recommended download is Web and Java EE: NetBeans IDE Download Bundles since this also includes the Glassfish v2UR2 Application Server.
Uncompress the downloaded file and install Netbeans 6.1.
Select Continue
Select Install
Select Close

Section 2: Disable Glassfish HTTP monitor

Follow these instructions to disable the HTTP Monitor in Glassfish. This will dramatically improve performance of the Identity Manager projects.

Select the Services tab. Expand the Servers icon. right click and select Properties on the GlassFish V2
Uncheck: Enable HTTP Monitor

Section 3: Identity Manager Plugin

The Sun Identity Manager plugin is an open source project on java.net. This plugin can be downloaded and installed in Netbeans of Eclise. In this
Download the Netbeans Identity Manager plugin.

Install the plugin

Start Netbeans 6.1 and install the Netbeans Identity manager plugin. Select the Tools menu item, Plugins
Select the Downloaded tab, select Add Plugins, select the downloaded Identity Manager plugin to open
Select Install
Select Next
Accept the terms, select Install
Select continue to accept the plugin. A warning message will appear since the downloaded plugin is not digitally signed.

Section 4: Download Identity Manager 8.0

Download Sun Identity Manager 8.0

Uncompress the downloaded file. The idm.war file in the uncompressed directory (IDM_8_0_0_0) will be used in Section 5 below.

Section 5: Create an Identity Manager 8.0 project

Select File, New Project
Select category, Web, under Project, select Identity Manager Project, select Next
Enter a project name, Idm8, select Next
Select the WAR file Location (this is the Identity Manager idm.war file which was downloaded in the previous Section., Select Next
Select Finish
When the project is created and the repository is configured, the Output window will list Build Successful
Selec the new project Idm8, right clisk, select Run
The Identity Manager login screen will appear in the browser when the build is finished, login as: configurator / configurator
The Identity Manager Administrative interface should now be available.

Section 6: Upgrade project to Identity Manager 8 Patch 2

This step is optional, but is highly recommended if you want to use Java 6 in your environment due to a known issue with contained role provisioning
(19086 Contained Role Provisioning problem with JDK 1.6)

NOTE: you must have a sunsolve account to download this patch

Download Identity Manager 8.0 Patch 2: 139010-02.zip

Uncompress the patch in the staging directory of the new project. This will overwrite the patch files on top of the IDM8 version of the product. This staging directory is merged with the custom directory during a build to create the image/idm deployment directory. This deployment directory is used for the project at runtime.

 
# cd 139010-02
# jar -xvf IDM_8_0_0_2_manual_install.jar 
# cd Idm8/idm-staging/
# jar -xvf /Download-directory/139010-02/IDM_8_0_0_2.jar

Open Netbeans. Clean and build the project

Section 7: Configure Project Build file

Select the Files tab in the left window. Expand the Idm8 project, open the sandbox-target.properties file.
Edit the following build variables in this file: %%IDM_URL%% %%SMTP_HOST%% %%LOG_DIR%%

Section 8: Configure Email notifications

By default, Identity Manager will attempt to send email notifications. This requires an smtp server to be available. The instructions below will configure your Identity manager project to send email notifications to a file instead of sending actual emails. This is useful in a development environment when an smtp server may not be available.

Create a new folder under Custom Web Pages in the project. Useful Information NOTE: This folder on the Projects tab is an alias to the custom directory in the project. The Custom Identity Manager folder is an alias to the custom/WEB-INF/config directory.
Enter config as the name of the new folder, select Finish
Select the Files tab. Expand the Idm8 project. Expand the idm-staging folder. Expand the config folder. Copy the Waveset.properties file. (note: this is the original source file that is supplied with the idm.war file.
Paste this file into the custom/config directory created above.
Open the new custom/config/Waveset.properties file. Uncomment the notification.redirect line in the file and enter a valid path to a notification file on your developer system.
Select the Project tab. Select the Idm8 project, right click, select Clean and Build
After the build finished, select the project, right click, select Run. The project will start and Identity Manager login will appear in a new browser window.
Optional: validate that the deployment directory: image/idm contains the updated file: config/Waveset.properties with the modified line from above.

Extract the ISE project files

Follow these instructions to configure the provided Identity Manager artifacts inside your new project.

1. Obtain the Identity Suite Essentials zip file
2. Extract this file in the new Netbeans project into the custom artifacts directory. //

   NOTE:  This folder is inside the new Project folder in the *custom/WEB-INF/config* directory.  Unzip the 
   *cec-identitymanager-artifacts.zip* file in this location.
   

3. Clean and build the project to deploy the new artifacts into your project repository.
4. Run the project (the custom artifacts supplied will now be deployed to the repository and configured.

Top

Demonstration

After completing the setup above, the following steps should be performed to complete this tutorial.

Section 1: Start the project

Run the Identity Manager 8 project Idm8 which was created above.

Select the Project tab. Select the Idm8 project, right click, select Run
Login as configurator / configurator

Section 2: Validate the patch level

Hover your mouse cursor over the Help button on the top right of the screen. The installed version of Sun Identity Manager will be displayed: Sun Java System Identity Manager 8.0 (20080908 Patch 2)

Top

Resources

The following links provide more information:

• Sun Identity Manager Overview
• Sun Identity Manager IDE
• How To Setup An IDM Project
• Netbeans