Publisher

The pxGrid client, publisher, provides a new topic or modifies an existing one, and defines the topic. This topic metadata information includes: capability name, version, description, platform, query and action items, and is submitted to the ISE pxGrid node for approval. Once the topic is approved, three authorization groups are available for the Administrator for assigning privileges to the clients, including whether they will be allowed to publish subscribe, query and send action requests.

The pxGrid client, sdk01, publisher defines the Auction capability, includes the topic metadata information, and awaits approval from the admin. Once approved the topic will be successfully published and the pxGrid client, sdk01, will be placed in the Action_Publish group. If a pxGrid client now runs core_subscribe, the new capability will be displayed.

  1. Run the script below and enter the topic metadata information as shown in the table and in the code sample in the right hand panel.
Prompt Response
New capability? (y/n) y
Enter capability name Auction
Enter capability version 1.0
Enter capability description Auction Service
Enter vendor platform ABC Auction Service
Enter query name (<enter> to continue) GetInventoryItems
Enter query name (<enter> to continue) GetCurrentBids
Enter query name (<enter> to continue) Note: press Enter
Enter action name (<enter> to continue) BidOnItems

./propose_capability.sh -a 10.10.20.11 -u sdk01 -k alpha.jks -p cisco123 -t alpha_root.jks -q cisco123 -g Session -d pxGrid New Publisher

propose_capability.sh 


------- properties -------

version=1.0.2.37

hostnames=10.10.20.11

username=sdk01

group=Basic

description=pxGrid

keystoreFilename=alpha.jks

keystorePassword=cisco123

truststoreFilename=alpha_root.jks

truststorePassword=cisco123

--------------------------

01:49:30.576 [Thread-1] INFO com.cisco.pxgrid.ReconnectionManager - Started

Connecting...

Connected

01:49:33.594 [Thread-1] INFO com.cisco.pxgrid.ReconnectionManager - Connected

New capability? (y/n): y

Enter capability name: Auction

Enter capability version: 1.0

Enter capability description: Auction Service

Enter vendor platform: ABC Auction Service

Enter query name (<enter> to continue): GetInventoryItems

Enter query name (<enter> to continue): GetCurrentBids

Enter query name (<enter> to continue):

Enter action name (<enter> to continue): BidOnItems

Enter action name (<enter> to continue):

Proposing new capability...

Press <enter> to disconnect...

Connection closed

01:52:35.387 [Thread-1] INFO com.cisco.pxgrid.ReconnectionManager - Stopped

[root@pxgridcent2 bin]#
  1. Select Administration > pxGrid Services > Capabilities, note the Auction topic is in a Pending create state.

Select Administration > pxGrid Services > View by Capabilities

  1. Select the Auction topic, then Approve.

Select the Auction topic, the Approve

  1. Select Yes to approve the topic.

Select Yes to approve the topic