Administering the WSRP Producer

This section describes how to administer the Sun Java System Portal Server Web Services for Remote Portlets (WSRP) service. The tasks to administer a WSRP producer are:

• To Create a WSRP Producer

• To Edit a WSRP Producer

• To Create a Consumer Registration

• To Edit a Consumer Registration

To Create a WSRP Producer

A WSRP producer is created with the following:

• Name of the producer instance (must be unique for the entire portal server)

• Whether registration is required. When registration is required, all WSRP consumers must register with this producer instance before making requests. Requests from unregistered WSRP consumers will be denied.

• Whether in-band registration is supported. In-band registration allows WSRP consumers to register programmatically. Otherwise, out-of-band registration is required with manual contact (such as email or telephone) between the WSRP consumer administrator and the WSRP producer administrator to set up and exchange access to a registration handle.

1. Log in to the Portal Server management console.

2. Select the Portals tab.

3. Select a portal server from Portals.

4. Click WSRP, then Producers from the submenu.

5. From Select DN drop-down menu choose any DN.

6. From WSRP Producers click New to launch the wizard

7. Follow the instructions to create the specified producer.

   For more information about the attributes, see Sun Java System Portal Server 7.1 Technical Reference

Equivalent psadmin Command

psadmin create-producer

To Edit a WSRP Producer

You can edit the WSRP Producer as follows:

• Add or remove portlets from the published list

• Change the requirement on registration

  ---

  Caution –

  This option should be modified for an existing producer.

  ---

• Enable or disable in-band registration

• Specify the Registration Validator Class. The registration validator class is used by the WSRP Producer to validate that the values sent by the WSRP consumer are acceptable.

• Add new registration properties. Any change in properties will apply to subsequent consumers registering with the producer.

1. Log in to the Portal Server management console.

2. Select the Portals tab.

3. Select a portal server from Portals.

4. Click WSRP, then Producers from the submenu.

5. From Select DN drop-down menu choose any DN.

6. Select a WSRP producer and modify the configuration attributes as necessary

   For more information about the attributes, see Sun Java System Portal Server 7.1 Technical Reference

7. Click Save to record the changes.

Equivalent psadmin Command

psadmin set-attribute

To Create a Consumer Registration

Each consumer registration represents a remote WSRP consumer that has established a relationship with the WSRP producer. A WSRP producer that supports allows multiple WSRP consumers to register with it. The registration mechanism allows a WSRP consumer to describe its capabilities to a WSRP producer.

A WSRP consumer is added out of band (such as by email or telephone). The information entered when adding a consumer registration must match the capabilities of the WSRP consumer that is given the registration handle. Consumer registrations allow a WSRP producer to scope artifacts (such as portlet preferences) that a WSRP consumer creates on the WSRP producer.

1. Log in to the Portal Server management console.

2. Select the Portals tab.

3. Select a portal server from Portals.

4. Click WSRP, then Producers from the submenu.

5. From Select DN drop-down menu choose any DN.

6. Select a WSRP producer, then Consumer Registrations.

7. Click New to launch the wizard.

8. Follow the instructions to create the specified consumer registration.

   For more information about the attributes, see Sun Java System Portal Server 7.1 Technical Reference

Equivalent psadmin Command

psadmin create-consumer-registration

To Edit a Consumer Registration

You can edit existing consumer registrations manually. Note that this could also be done via in-band registration from the WSRP Consumer end. Ensure that both out of band and in band registration are not used simultaneously.

1. Log in to the Portal Server management console.

2. Select the Portals tab.

3. Select a portal server from Portals.

4. Click WSRP, then Producers from the submenu.

5. From Select DN drop-down menu choose any DN.

6. Select producers, then select a WSRP producer, then Consumer Registrations.

7. Select a consumer registration and modify the configuration attributes as necessary.

   For more information about the attributes, see Sun Java System Portal Server 7.1 Technical Reference

8. Click Save to record the changes.