管理生成方
本节讨论以下主题：
如要将本地部署的 Portlet 远程提供给作为 WSRP 使用方的其他门户，应创建一个生成方。一个门户可以托管多个生成方。使用方可以导入生成方提供的远程 Portlet。根据想要提供给 WSRP 使用方的 Portlet，您可能会创建一个或多个生成方。生成方可以支持注册或不需要注册。如果生成方支持注册，则使用方必须注册才能使用生成方。
创建支持注册的生成方
注册用于在使用方和生成方之间建立技术或业务关系。创建生成方时，您可以定义以下任何一种注册机制：带内注册或带外注册：
如果生成方需要注册并启用带内注册：使用方可通过 WSRP 界面提供详细信息并向生成方注册。此外，使用方也可通过带外通信注册。也就是说，使用方可以提供通过带外通信获得的注册句柄。
如果生成方需要注册并启用带外注册：使用方应通过带外通信获得注册句柄，并在注册过程中提供注册句柄。带外注册通常需要人工介入，例如电话、电子邮件等。对于支持带外注册的生成方，生成方通过带外通信获得关于使用方的详细信息，然后为使用方创建一个注册句柄。注册句柄通过带外通信传递给使用方。
创建支持注册的生成方
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户服务器。
-
单击 "WSRP" 选项卡。
-
从“选择 DN”下拉菜单选择任意 DN，然后单击“生成方”选项卡。
“WSRP 生成方”表格将会显示创建的所有生成方。
注 –组织在 Sun Java System Identity Server 中创建。根据 Portlet 的可用性，选择组织或子组织的 DN。
-
单击“新建”创建新的生成方。
-
键入名称以标识该生成方。
-
为注册选择“必需的”选项。
-
如果您希望使用方在添加配置的生成方时，使用 Sun Java System Portal Server 应用程序界面输入详细信息，则选择“支持带内注册”。
-
要添加注册属性，单击“添加行”。输入值。然后输入注册属性的名称和说明。
注 –注册属性是使用方向特定生成方注册时，您想要从使用方获得的详细信息。使用方输入的注册属性可以通过“注册验证”类进行验证。
-
如果您希望使用方通过带外通信（例如电话、电子邮件等）提供详细信息，则选择“支持带外注册”。
-
单击“下一步”。
“检查”屏幕会显示您输入的详细信息。检查详细信息。您可以单击“上一步”并更改您输入的详细信息。
-
单击“完成”。
等同的 psadmin 命令
创建不支持注册的生成方
对于不需要注册的生成方，使用方不必输入或通过带外通信获取任何信息。这种情况下，使用方无法自定义（或编辑）生成方提供的 Portlet。不支持注册的生成方为使用方提供“只读”门户。
创建不支持注册的生成方
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户服务器。
-
单击 "WSRP" 选项卡。
-
选择 "DN"。
“配置的生成方”表格显示已经配置的所有生成方。
-
单击“新建”。
-
键入生成方的名称。
-
为注册选择“不需要”选项。
-
单击“完成”。
等同的 psadmin 命令
启用和编辑 WSRP 生成方属性
应为要注册的使用方启用新建的生成方。可通过添加一个或多个 Portlet 启用生成方。
可以禁用生成方。但是，所有注册到禁用生成方的使用方将无法访问生成方提供的 Portlet。
启用和编辑生成方的属性
-
在“生成方”选项卡中，单击生成方名称链接。
会显示“编辑属性”屏幕。该屏幕显示 WSDL（Web Services Definition Language，Web 服务定义语言）URL。WSDL URL 是特定生成方的唯一 URL，使用方通过它来访问生成方。
-
将一个或多个发布的 Portlet 添加到生成方。
注 –生成方必须至少有一个发布的 Portlet 才能启用。屏幕上会显示所有发布的、与门户（生成方在其中创建）关联的 Portlet。
-
选择一个 Portlet，然后单击“添加”。
-
如有必要，编辑“注册验证类”字段。
“注册验证者”用于验证使用方输入的注册属性。您还可以根据需要自定义此类。
-
单击“保存”。现在，屏幕上会显示“启用”复选框并可进行编辑。选择“启用”并单击“保存”。
注 –您还可以编辑生成方的其他属性。
等同的 psadmin 命令
自定义注册验证类
您可以自定义 RegistrationValidator 类。使用此类，您可以处理注册属性。例如，验证使用方的邮政编码。RegistrationValidator 是在 WSRP 生成方中进行注册验证的 SPI。有关自定义验证类的更多信息，参见 http://portalID/portal/javadocs/desktop。您还可以参阅《Sun Java System Portal Server 7.1 Developer's Guide》中的 "WSRP:Validating Registration Data"。
生成注册句柄
对于支持注册的生成方，需要为特定的使用方生成一个注册句柄。生成注册句柄后，需要将它传递给使用方，以便通过带外通信方式向生成方注册。使用方向生成方注册时，需要输入注册句柄。
生成注册句柄
-
单击“使用方注册”选项卡。
屏幕上会显示所有已经向特定生成方注册的使用方。
-
单击“新建”。
-
键入详细信息，例如名称、状态、使用方代理和方法。
- 使用方名称
-
标识使用方的唯一名称。
- 状态
-
可以为“启用”或“禁用”。
- 使用方代理
-
指定使用方供应商的名称和版本。“使用方代理名称”应为 ProductName.MajorVersion.MinorVersion，其中，ProductName 标识使用方安装用于其部署的产品，而 majorVersion 和 minorVersion 是供应商为其产品定义的版本识别码。此字符串可以包含任何产品或使用方想要提供的附加字/词。
- 方法
-
指定使用方是否以支持 HTML 标记（包含使用 get 方法的表单）的方式实现 Portlet URL。
-
单击“下一步”。
屏幕显示创建生成方时指定的注册属性值。
-
输入这些值，然后单击“下一步”。单击“完成”。
将生成方详细信息发布到 ebXML Registry
发布生成方会在任一系统信息库中存储生成方的详细信息，例如 Sun Java System Service Registry Server 或 ebXML Registry 服务器。生成方发布之后，您可使用应用程序界面或使用命令行界面搜索生成方的详细信息。有关设置 Sun Java System Service Registry Server 的详细信息，参见《Service Registry 3.1 Administration Guide》。
您需要为 Registry 配置 Sun Java System Portal Server，以将生成方的详细信息发布到注册表。
为 Registry 配置 Sun Java System Portal Server
-
在安装 Portal Server 的计算机上创建目录 /soar/3.0/jaxr-ebxml/security。
-
将 keystore.jks 从 Registry Server 的 /var/opt/SUNWsrvc-registry/3.0/data/security 目录复制到 /soar/3.0/jaxr-ebxml/security。
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户服务器。
-
从子菜单单击“SSO 适配器”。
-
单击 "JES-REGISTRY-SERVER"。
将显示“编辑元适配器 - JES-REGISTRY-SERVER”屏幕。
-
键入详细信息。
如果您通过代理服务器访问注册表服务器：
- http.proxy.host
-
代理服务器的主机名。
- http.proxy.password
-
代理服务器密码（如果代理服务器需要验证）。
- http.proxy.port
-
代理服务器可用的端口。
- http.proxy.user
-
代理服务器用户名（如果代理服务器需要验证）。
如果您没有使用代理服务器：
- registry.keypassword
-
从密钥库获取密钥所需的密码。
- registry.keystorealias
-
密钥库中存在的密钥别名，用于向注册表服务器验证。
- registry.keystorelocation
-
密钥库相对于 /soar/3.0/jaxr-ebxml/ 的位置。
- registry.keystorepassword
-
用于打开密钥库的密码。
- registry.publishurl
-
注册表服务器的 URL（发布请求应发送至此）。此 URL 应接受 SOAP 请求。
- registry.queryurl
-
注册表服务器的 URL（搜索请求应发送至此）。此 URL 应接受 SOAP 请求。
向 Registry 发布生成方详细信息
以下步骤说明如何向 Registry Server 发布生成方：
-
创建组织数据和生成方数据文件。
组织数据文件可包含以下各项：
org.name= Sun Microsystems
org.description= Description
org.primarycontact.name= Henry
org.primarycontact.phoneno= 1234567
org.primarycontact.email= someone@host.com
注 –org.name 和 org.description 应与 Identity Server 中的详细信息类似，除非 Registry 在内部部署。
生成方数据文件应有以下各项：
producer.name=Producer_name
producer.description=Producer_Description
producer.id=Producer_ID
注 –不是必须创建所有的数据文件。但是，为了搜索生成方、组织或 Portlet 的详细信息，您应该创建至少一个与此关联的文件。
-
停止和重新启动 common agent container：
/usr/lib/cacao/bin/cacaoadm stop
/usr/lib/cacao/bin/cacaoadm start
-
要发布生成方详细信息，使用以下命令：
./psadmin publish-registry -u amadmin -f password_file -p portal1 -m producer -U producer_data_file -O organization_data_file -T portlet - L --debug
注 –Portlet 文件指定 WSRP 生成方提供的 Portlet。Portlet 列表以双引号内的字符串指定，并且元素以空格分隔。例如 "NotepadPortlet BookmarkPortlet WeatherPortlet"。"
注 –可使用以下命令检查日志文件：more var/opt/SUNWportal/logs/admin/portal.admin.cli.0.0.log
等同的 psadmin 命令
查找生成方
以下章节说明如何搜索生成方：
搜索生成方
-
创建“搜索生成方”数据文件。
“搜索生成方”数据文件可包含以下各项：
producer.name= producer_name
producer.description=producer_description
注 –“搜索生成方”数据文件包含要在注册表中搜索的生成方的描述。使用字符 % 作为通配符。例如，producer.name 中的 %acme% 会查找其名称中包含字符串 "acme" 的任何 WSRP 生成方。
-
要搜索注册表，使用以下命令：
./psadmin search-registry -m consumer -u amadmin -f ps_password -C search_producer_datafile -p portal1
-
创建“搜索 Portlet”数据文件。
“搜索 Portlet”数据文件可包含以下各项：
portlet.name= portlet_name
portlet.description= portlet_description
注 –“搜索 Portlet”数据文件包含要在注册中搜索的 Portlet 的描述。使用字符 % 作为通配符。例如，portlet.name 中的 %stock% 会查找其名称中包含字符串 "stock" 的所有 Portlet。
-
要根据 Portlet 详细信息进行搜索，使用以下命令：
./psadmin search-registry -m consumer -u amadmin -f ps_password -D search_portlet_datafile
-
创建“搜索组织”数据文件。
“搜索组织”数据文件应包含以下各项：
organization.name= organization_name
organization.description=organization_description
注 –“搜索组织”数据文件包含要在注册中搜索的组织的描述。使用字符 % 作为通配符。例如，organization.name 中的 %acme% 会查找其名称中包含字符串 "acme" 的所有组织。
-
要根据组织数据文件进行搜索，使用以下命令：
./psadmin search-registry -m consumer -u amadmin -f ps_password -L search_organization_datafile -p portal1
等同的 psadmin 命令
- © 2010, Oracle Corporation and/or its affiliates