Data Infrastructure Management Software Discussions

Re: WFA - Add system to OCUM/DFM

 

@sinhaa

 

That's correct, the "datasource-add" isn't a "officially" supported API, but then again neither is the "dfm-about" API and that's called within functions in the "WFAWrapper.psm1" (which is supported as a component of WFA). If WFA engineering choose to use unsupported API's in WFA then why not use them WFA custom commands? (which aren't supported either)

There is no WFA certified (supported) command to add a cluster to OCUM so ultimately a custom command need to be created (which isn't supported).

 

/Matt

If this post resolved your issue, help others by selecting ACCEPT AS SOLUTION or adding a KUDO.

Re: WFA - Add system to OCUM/DFM

@mbeattie

 

Matt,

 

I'll give my opinion on this.

 

WFAWrapper is an internal module of WFA, it doesn't recommend/expose/ask the users to use any APIs. If the api used by the module are discontinued/broken in future the responsibility will be with WFA to fix the module. Its still internal to WFA.

 

There are always hidden/internal apis for most SW which are not available to public use, and they all have valid reasons. In my view I would not recommend any un-documented api to be used by NetApp customer. They can be removed, or modified in future without any notice.

 

And here we do have an alternative i.e. to use the CLI which is officially documented. I had given how to bypass the prompt for self-signed certificate. So using CLI would be my recommended way.

 

 

 

sinhaa

 

If this post resolved your issue, help others by selecting ACCEPT AS SOLUTION or adding a KUDO.

Re: WFA - Add system to OCUM/DFM

Hi Tom,

 

The OCUM ZAPI is 'cluster-iter' (supported API). To list all clusters call the API with max-records property:

 

<?xml version="1.0" encoding="UTF-8"?>
<netapp  xmlns="http://www.netapp.com/filer/admin" version="1.0">
  <cluster-iter>
    <max-records>10</max-records>
    <tag></tag>
  </cluster-iter>
</netapp>

Example output:

 

<?xml version='1.0' encoding='UTF-8'?><netapp xmlns="http://www.netapp.com/filer/admin" version="1.0">

    <!-- Output of cluster-iter [Execution Time: 330 ms] -->
	<results status='passed'>
		<num-records>1</num-records>
		<records>
			<cluster-info>
				<cluster-address>cluster1.testlab.local</cluster-address>
				<cluster-diagnosis-status>ok</cluster-diagnosis-status>
				<cluster-name>cluster1</cluster-name>
				<cluster-status>Normal</cluster-status>
				<cluster-version>9.1</cluster-version>
				<datasource-id>1</datasource-id>
				<last-update-time>1526605070</last-update-time>
				<licenses>
					<license>
						<description>CIFS License</description>
						<owner-name>testc1n1</owner-name>
						<owner-resource-key>c5143e82-4e8c-11e8-a4fa-005056ac74ec:type=cluster_node,uuid=3e0e628d-4e82-11e8-82a6-f1596ddbfe6d</owner-resource-key>
						<owner-type>cluster_node</owner-type>
						<package-name>cifs</package-name>
						<serial-number>1-81-0000000000000004082368511</serial-number>
					</license>
					<license>
						<description>Cluster Base License</description>
						<owner-name>cluster1</owner-name>
						<owner-resource-key>c5143e82-4e8c-11e8-a4fa-005056ac74ec:type=cluster,uuid=c5143e82-4e8c-11e8-a4fa-005056ac74ec</owner-resource-key>
						<owner-type>cluster</owner-type>
						<package-name>base</package-name>
						<serial-number>1-80-000008</serial-number>
					</license>
					<license>
						<description>NFS License</description>
						<owner-name>testc1n1</owner-name>
						<owner-resource-key>c5143e82-4e8c-11e8-a4fa-005056ac74ec:type=cluster_node,uuid=3e0e628d-4e82-11e8-82a6-f1596ddbfe6d</owner-resource-key>
						<owner-type>cluster_node</owner-type>
						<package-name>nfs</package-name>
						<serial-number>1-81-0000000000000004082368511</serial-number>
					</license>
					<license>
						<description>SnapMirror License</description>
						<owner-name>testc1n1</owner-name>
						<owner-resource-key>c5143e82-4e8c-11e8-a4fa-005056ac74ec:type=cluster_node,uuid=3e0e628d-4e82-11e8-82a6-f1596ddbfe6d</owner-resource-key>
						<owner-type>cluster_node</owner-type>
						<package-name>snapmirror</package-name>
						<serial-number>1-81-0000000000000004082368511</serial-number>
					</license>
					<license>
						<description>iSCSI License</description>
						<owner-name>testc1n1</owner-name>
						<owner-resource-key>c5143e82-4e8c-11e8-a4fa-005056ac74ec:type=cluster_node,uuid=3e0e628d-4e82-11e8-82a6-f1596ddbfe6d</owner-resource-key>
						<owner-type>cluster_node</owner-type>
						<package-name>iscsi</package-name>
						<serial-number>1-81-0000000000000004082368511</serial-number>
					</license>
				</licenses>
				<resource-key>c5143e82-4e8c-11e8-a4fa-005056ac74ec:type=cluster,uuid=c5143e82-4e8c-11e8-a4fa-005056ac74ec</resource-key>
				<serial-number>1-80-000008</serial-number>
			</cluster-info>
		</records>
	</results>
</netapp>

/Matt

If this post resolved your issue, help others by selecting ACCEPT AS SOLUTION or adding a KUDO.

Re: WFA - Add system to OCUM/DFM

@sinhaa

 

Fair call, that's absolutely understandable. Certainly it is possible (and is definatley the "supported" solution) to use the SSH command as you've suggested:

 

y|um datasource add -U 'UUUUU' -P 'XXXXX' hostname

However if customers wanted to automate that process (using WFA for exampe) they will have to create a custom WFA command (regardless if they use the above method it wouldn't be supported unless released by WFA engineering as a certified command).

 

When developing automation i'd always recommend using API's in preference to SSH CLI commands (definately avoid screen scraping CLI output). Instead of having to rely on CLI output to determine success\failure of adding the datasource you can in invoke the "datasource-add" ZAPI then wait for job to complete and determine the status using:

 

  • job-iter
  • job-task-iter
  • job-wait-for-state

Ultimately API support is a NetApp OCUM\WFA engineering issue, however expecting customers to rely on a CLI and or UI as the only supported solution is a serioulsy outdated concept for modern application development (just my opinion)

 

/Matt

If this post resolved your issue, help others by selecting ACCEPT AS SOLUTION or adding a KUDO.

Forums