topic Re: ZAPI is not enabled in pre-cluster mode in Software Development Kit (SDK) and API Discussions

ZAPI is not enabled in pre-cluster mode

ronaldmajor — Wed, 06 Sep 2017 19:37:16 GMT

I am scripting the tasks to build a new filer with PSTK 4.4 and it is failing at the first step. I am testing on a 9.1 simulator.

I manually set the node management IP and execute Connect-NcController then get the following result.

PS C:\Scripts> Connect-NaController 192.168.146.21 -HTTPS
Connect-NaController : ZAPI is not enabled in pre-cluster mode.
At line:1 char:1
+ Connect-NaController 192.168.146.21 -HTTPS
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidResult: (192.168.146.21:NaController) [Connect-NaController], EAPIPRIVILEGE
+ FullyQualifiedErrorId : HttpConnectionFailed,DataONTAP.PowerShell.SDK.ConnectNaController

What am I missing?

Re: ZAPI is not enabled in pre-cluster mode

asulliva — Wed, 06 Sep 2017 21:19:23 GMT

Hello @ronaldmajor,

Have you seen this post by @JohnChampion: Automate Cluster Setup in 12-Steps with ONTAP PowerShell Toolkit 4.1?

He walks through the process of setting up a cluster using the PowerShell Toolkit.

Hope that helps.

Andrew

Re: ZAPI is not enabled in pre-cluster mode

ronaldmajor — Thu, 07 Sep 2017 15:09:00 GMT

Thank you. I did see that post and am using those techniques. Looking back at the prerequisites, step 2 may be the part that I need to work on.

In the simulator, I "Clean configuration and initialize all disks." After the clean and filer reboots it asks for the node network information. I enter the IP information and then it it says to use a browser to complete the setup. At this point I, use Ctrl-C to break out of the setup and set the admin password. I then use the Connect-NcController with the node IP and provide the admin user and password to log in. This is where I get the error.

Could this be specific to the simulator. I have a FAS2520 to test with, but do not have it ready to use at this time.

I was hoping to test with the simulator before tackling the real thing.

Re: ZAPI is not enabled in pre-cluster mode

ronaldmajor — Thu, 07 Sep 2017 17:30:57 GMT

OK, I found that if I break out of the cluster setup after boot, set the admin password, and manually create the node management lif, then Connect-NcController works.

It looks like a level of manual effort must be accomplished before automation can be used.

Re: ZAPI is not enabled in pre-cluster mode

JohnChampion — Thu, 07 Sep 2017 17:56:35 GMT

Glad you got it working!

Interesting though - I just tried it with the 9.1 Simulator and it connected (without manually creating a LIF) - just ran node setup, Ctrl-C, then set the password.

You might want to verify all your network mappings (vmnic->virtual netowrk->ONTAP port e0?). I set all 4 of mine to "Host-Only" which is vmnet1. If I recall, the default uses NAT on a couple vmnics..

Did you verify you could ping the IP address you assigned in node setup before creating the LIF?

Also, there are a limited number of ZAPI commands that work before the cluster is created...I haven't checked this lately but seems to still be correct 😉

Allowed Precluster ZAPI calls:

net-interface-create
net-interface-modify
net-interface-delete
net-port-modify
net-device-discovery-get-iter
net-port-get-iter
net-interface-get-iter
storage-disk-get-iter
aggr-spare-get-iter
cf-status
system-get-node-info-iter
net-options-get
net-options-modify
net-cluster-ping
security-login-modify-password
system-node-discovery-get-iter

So if a PowerShell cmdlet uses any ZAPI calls not listed above BEFORE the cluster is created - you will get the "ZAPI is not enabled in pre-cluster mode" error.

Re: ZAPI is not enabled in pre-cluster mode

ronaldmajor — Thu, 07 Sep 2017 18:11:53 GMT

Thanks for the reply.

Interesting though - I just tried it with the 9.1 Simulator and it connected (without manually creating a LIF) - just ran node setup, Ctrl-C, then set the password.

You might want to verify all your network mappings (vmnic->virtual netowrk->ONTAP port e0?). I set all 4 of mine to "Host-Only" which is vmnet1. If I recall, the default uses NAT on a couple vmnics..

The first two vmnics (e0a and e0b) are for cluster interconnects and do not need host access.

Did you verify you could ping the IP address you assigned in node setup before creating the LIF?

Yes, I can ping the the node address and access with a browser. I do not know what the difference is between the LIF created by node setup or manual. I'll have to look deeper.

Also, there are a limited number of ZAPI commands that work before the cluster is created...I haven't checked this lately but seems to still be correct

Allowed Precluster ZAPI calls:

net-interface-create
net-interface-modify
net-interface-delete
net-port-modify
net-device-discovery-get-iter
net-port-get-iter
net-interface-get-iter
storage-disk-get-iter
aggr-spare-get-iter
cf-status
system-get-node-info-iter
net-options-get
net-options-modify
net-cluster-ping
security-login-modify-password
system-node-discovery-get-iter

So if a PowerShell cmdlet uses any ZAPI calls not listed above BEFORE the cluster is created - you will get the "ZAPI is not enabled in pre-cluster mode" error.

This is good stuff. It looks like some additional setup may be required before I can create the cluster since New-NcCluster does not work. That's another question.

Re: ZAPI is not enabled in pre-cluster mode

JohnChampion — Thu, 07 Sep 2017 19:11:52 GMT

I'm doing some tests using the 9.1 and 9.2 simulators.

Looks like if you're building a single node cluster, the 2 ports assigned to the Cluster ipspace need to be moved to the Default ipspace.

I got it to work on 9.2 sim - but I corrupted my root volume on the 9.1 sim 😉

I also used the -NodeCount 1 parameter on the New-NcCluster cmdlet.

Will update once I get through a few runs.

Re: ZAPI is not enabled in pre-cluster mode

JohnChampion — Thu, 07 Sep 2017 19:52:07 GMT

OK - I'm assuming you're building a single node cluster with the 9.1 simulator

I ran node setup and set the admin password

Then I moved e0a and e0b out of the Cluster ipspace and placed them in the Default ipspace

net port modify -node localhost -port e0a -ipsapce Default

net port modify -node localhost -port e0b -ipsapce Default

Rebooted (may not be necessary but I wanted to make sure the changes stuck)

PS> Import-Module DataONTAP

PS> Connect-NcController {node IP}

PS> New-NcCluster -ClusterName TEST -License {whatever} -NodeCount 1

PS> Get-NcClusterCreateProgress

CurrentStatusMessage : Cluster has been created.
IsComplete : True
NcController : 192.168.201.11
Status : success
IsCompleteSpecified : True

TEST::> cluster show

Node Health Eligibility

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

TEST-01 true true

I have a 2-node 9.1 simulator that I can zero and try as well - I'm curious 😉

Re: ZAPI is not enabled in pre-cluster mode

ronaldmajor — Tue, 12 Sep 2017 12:42:30 GMT

When I moved the cluster ports to the Default IPspace New-NcCluster worked.

I tried to use Set-NcNetPort to change the cluster port IPspace but it fails.

PS C:\windows\system32> Set-NcNetPort -Node localhost -Name e0b -Ipspace Default
Set-NcNetPort : You must provide one or more values to apply your changes.
At line:1 char:1
+ Set-NcNetPort -Node localhost -Name e0b -Ipspace Default
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidOperation: (192.168.146.21:NcController) [Set-NcNetPort], EINVALIDINPUTERROR
+ FullyQualifiedErrorId : ApiException,DataONTAP.C.PowerShell.SDK.Cmdlets.Net.SetNcNetPort

I don't know if this is not supported in ONTAP 9.1 or if I am missing an argument. I am using PSTK 4.4.

Re: ZAPI is not enabled in pre-cluster mode

mirko — Wed, 26 Oct 2022 14:38:50 GMT

I know it's an old thread, but just for other to follow. I have managed to setup a simulator with zero human interaction, using the vmware api Vmware.vim.usbScanCodeSpec. this allows you to interact with a vm through a vcenter connection. I used this to interupt boot, using option 4, setup cluster. The rest can then be done ansible or code of preference.