Registering and Unregistering Your Consumer Portal

Applicable to: remote role assignment, remote delta links, WSRP application sharing

Use

You use the Producer Registration tool in the portal to do the following:

·        Register your portal as a consumer on any producer portal you have added.

·        Unregister your portal.

·        View the current registration status of your portal with your producers.

Registration is a mandatory step before being able to use content exposed by the producer. Registration with the Producer Registration tool is not the same as the formal WSRP-based registration that some non-SAP producer portals require. Nevertheless, when you register your portal with a consumer using this tool, formal WSRP-based registration is performed if the producer requires it.

Some producers may also require that you configure certain parameters as part of the registration process. The Producer Registration tool displays these parameters and allows you to define them before registration.

To redefine your consumer parameters relative to a specific producer portal, such as Your Consumer Name and Your Consumer URL, you need to first unregister. Note however that unregistering your portal has implications on content you have already generated from the producer portal you are registered with. For information, see "Result" below.

§         Before registering, we recommend you check the connection to the producer using the System Connection Tests tool. More information: Registering and Unregistering Your Consumer Portal.

§         Use the Block Access capability in the View My Producers screen to temporarily block access to a content producer instead of unregistering. More information: Enabling/Disabling Access to Registered Producers.

§         You can use an XML script, instead of the Producer Registration tool, to register your portal. More information: Using XML to Automate FPN Tasks.

Prerequisites

●      You have access to the federated portal administration tools in the standard System Admin role on your portal.

●      You have added the producer to your portal. More information: Adding Producers.

●      You have been assigned at least administrator read-write permission to the producer object.

The producer may inherit the permission assigned to its parent folder in the Portal Catalog. For example, NetWeaver Content Producers or WSRP Content Producers.

●      (Optional) You have the registration password of the producer. A system administrator on the producer can set a password that must be entered on the consumer upon registration. More information: Configuring Your Registration Password.

Procedure

...

Launching the Producer Registration Tool

Do one of the following:

●      If you are currently editing the producer object in the Producer Editor or another secondary editor, choose Producer Registration in the object editor toolbar.

●      If the producer object is not in editing mode, do the following:

...

...

                            a.      In the consumer portal, navigate to System Administration → Federated Portal → Myself as Content Consumer → Manage My Producers.

                            b.      In the Portal Catalog, navigate to the producer object with which you want to register your portal.

                            c.      Right-click the producer object and choose Open → Producer Registration in the context menu. The Producer Registration tool is displayed, showing the current registration status.

Registering Your Consumer Portal

...

...

       1.      In the Your Consumer Name box, enter the name of your portal is sent to the producer upon registration. NetWeaver producers see this name in their View My Consumers screen.

       2.      In the Your Consumer URL field, enter your URL (<protocol>://<hostname>:<port>) to be used by a producer portal when channeling information back to your portal while fulfilling a runtime request. This parameter is useful for eliminating problems that may arise as a result of complex system networks, such as reverse proxies.

If you enter an incorrect URL, registration with the producer will still succeed. You will receive an error only at runtime when your portal attempts to retrieve and display remote content from the producer portal.

In the event you are using one or more reverse proxies in your landscape, note the following:

■       If a reverse proxy is located between the consumer and the producer, enter the protocol, host name, and port of the reverse proxy.

■       If there is no reverse proxy located between the consumer and the producer, enter the protocol, host name, and port of the consumer portal.

■       Additional configuration steps are needed when using a reverse proxy in a federated portal network landscape. More information: How to Set Up the Landscape for a Federated Portal Network guide, available on SAP Developer Network at sdn.sap.com/irj/sdn/howtoguides → SAP NetWeaver 7.0 → User Productivity Enablement → Running an Enterprise Portal.

       3.      A producer may require that you provide additional information to register, such as a password. If so, the parameters are listed in the Registration Parameters table; enter any requested information in the table to continue.

The default registration password for NetWeaver producers is: password

       4.      Choose Register.

Unregistering Your Consumer Portal

...

...

       1.      Choose Unregister.

       2.      Accept the confirmation message that appears.

 

Result

You registration status is displayed in a message on the screen. You can also view your status in the View My Producers screen. More information: Viewing Your Producers.

After Registration

When you have registered successfully with a NetWeaver producer, you are listed in the View My Consumers screen on the producer portal.

When your consumer is registered on a producer, you can no longer change its properties, including the WSDL file path, in the Producer Editor. The editor opens in read-only mode; however, you can change permissions, test connections, and unregister. More information: Editing Connection Properties to Producers.

When you re-register an existing registration scope, the runtime functionality of any remote-based content generated beforehand on the consumer portal is restored.

After Unregistering

●      Upon unregistration, remote-based content generated in the same registration scope will no longer function at runtime.

This includes roles consumed through remote role assignment, content consumed through the remote delta link mode, and proxy-to-portlet iViews generated through the WSRP application sharing mode will no longer function at runtime.

§         If you have registered yourself with multiple instances of the same producer portal, only content consumed through the portal instance you unregistered is affected.

§         You can restore the functionality of the content by re-registering your portal with the same registration scope.

●      Personalization data set for content generated through remote role assignment and remote delta links is maintained. Personalization data for proxy-to-portlet iViews is permanently deleted.

●      The status of your consumer in the View My Consumers screen on the producer is updated. The status is updated only after the system administrator on the producer chooses Refresh in the View My Consumers screen or if the producer portal is restarted.

 

Reasons for not being able to register or unregister may be:

●      The WSDL service is not accessible (upon registration only) on the producer.

●      The portal server of the producer may be down.

●      There are problems with your network or that of the producer.

●      You entered an incorrect registration password.

●      You have not set up trust with the producer.