What happens when I run Add-Node in NCache?

When you run Add-Node, NCache copies the cache configuration from the specified existing server to the new server and updates the cluster membership. The new server is then registered as part of the clustered cache, allowing it to participate in data distribution once the cache is started.

Does Add-Node immediately start the cache on the new server?

No. The Add-Node cmdlet only registers the node and copies the configuration. You must separately run the 'Start-Cache' cmdlet for that new node to begin serving requests and participating in state transfer.

Does adding a node trigger data rebalancing?

Yes. Once the cache is started on the newly added node, NCache triggers an automatic state transfer (rebalancing) to distribute existing data buckets to the new node, ensuring load is balanced across the expanded cluster.

Add-Node

The Add-Node PowerShell cmdlet adds a new server node to an existing NCache clustered cache. This command automates the deployment process by copying the cache configuration from an ExistingServer to a NewServer, ensuring seamless synchronization and high availability across multiple server nodes. This cmdlet supports scaling by allowing multiple server nodes to be added to the cluster. It is available for both Windows (Add-Node) and Linux (add-node) environments.

Windows PowerShell
Linux CLI

Add-Node -CacheName -ExistingServer -NewServer [-Port] [-Credentials] [-NoLogo]

Examples

This command adds a new node 20.200.20.12 to the cache named demoCache existing on server node 20.200.20.11.

Add-Node -CacheName demoCache -ExistingServer 20.200.20.11 -NewServer 20.200.20.12

This command adds a new node 20.200.20.12 to the cache named demoCache existing on server node 20.200.20.11 using security credentials.

Add-Node -CacheName demoCache -ExistingServer 20.200.20.11 -NewServer 20.200.20.12 -Credentials(Get-Credential john_smith)

Properties

Note

The parameters with asterisk (*) on their names are the required parameters and the rest are optional.

Parameters	Data Types	Description	Default Value
`-CacheName*`	`<String>`	Specifies the name of clustered cache. Note: The cache must already exist on the source server.	-
`-ExistingServer*`	`<String>`	Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered. Cache configuration is copied from this server to the destination server.	-
`-NewServer*`	`<String>`	Specifies a server name where a cache with the specified cache-name needs to be registered. The cache configuration is copied from the source server name to this server.	-
`-Port`	`<Integer>`	Specifies the port on which the NCache Service is listening.	8250
`-Credentials`	`<pscredential>`	Specifies the user credentials required to authorize access for the specified operation. These credentials should belong to a user with the appropriate permissions at the node.	-
`-NoLogo`	`<SwitchParameter>`	Suppresses display of the logo banner.	False

add-node -cachename -existingserver -newserver [-port] [-userid] [-password] [-nologo]

Examples

This command adds a new node 20.200.20.12 to the cache named demoCache existing on server node 20.200.20.11.

add-node -cachename demoCache -existingserver 20.200.20.11 -newserver 20.200.20.12

This command adds a new node 20.200.20.12 to the cache named demoCache existing on server node 20.200.20.11 using security credentials.

add-node -cachename demoCache -existingserver 20.200.20.11 -newserver 20.200.20.12 -userid john_smith -password pass123

Properties

Note

The parameters with asterisk (*) on their names are the required parameters and the rest are optional.

Parameters	Data Types	Description	Default Value
`-cachename*`	`<String>`	Specifies the name of clustered cache. Note: The cache must already exist on the source server.	-
`-existingserver*`	`<String>`	Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered. Cache configuration is copied from this server to the destination server.	-
`-newserver*`	`<String>`	Specifies a server name where a cache with the specified cache-name needs to be registered. The cache configuration is copied from the source server name to this server.	-
`-port`	`<Integer>`	Specifies the port on which the NCache Service is listening.	8250
`-userid`	`<String>`	Specifies the user id used to authorize the user for this operation. It is required in case security is enabled on Cache Server. This user id must be the active directory user id.	-
`-password`	`<String>`	Specifies the password of the user that is used to authorize the user for this operation. It is required in case security is enabled on Cache Server. This password must be the same as the active directory user password.	-
`-nologo`	`<SwitchParameter>`	Suppresses display of the logo banner.	False

Add-Node

Examples

Properties

Note

Contact Us