Table of Contents

Add-ClientNode

Note

This feature is only available in NCache Enterprise and Professional editions.

Add-ClientNode cmdlet enables the user to add one or more client nodes to existing clustered cache(s). This cmdlet updates the server configuration and acquires server mapping if specified.

Add-ClientNode [-CacheName] [-AcquireServerMapping] -ClientNode [-NoLogo] [-Password] [-Port] –Server [-UpdateServerConfig] [-UserId]

These properties are explained in detail in the Properties section.

Examples

  • This command adds a Client node 20.200.21.12 to a cache named demoCache already existing on server node 20.200.20.11.
Add-ClientNode -CacheName demoCache -Server 20.200.21.11 -ClientNode 20.200.21.12
  • This command adds a Client node 20.200.21.12 to a cache named demoCache which already exists on server node 20.200.20.11 with port number 8251 which is not the default port number.
Add-ClientNode -CacheName demoCache -Server 20.200.21.11 -ClientNode 20.200.21.12 -Port 8251
  • This command adds a Client node 20.200.21.12 to a cache named demoCache which already exists on server node 20.200.20.11 and updates the client node sections of server node with the display of the logo banner suppressed.
Add-ClientNode demoCache -Server 20.200.21.11 -ClientNode 20.200.21.12 –UpdateServerConfig –NoLogo

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 the clustered cache to which client node is added. Note that the cache must exist on the source server. -
-Server* <String> Specifies a server name where the NCache service is running and a cache with the specified cache-name is registered. Client configuration is copied from this server to the destination server. Local Machine
-ClientNode* <String> Specifies the Client node (node to be added as a client node) where NCache service is running. -
-Port <Integer> Specifies the server port where NCache server is listening. 8250
-UpdateServerConfig <SwitchParameter> Specifies whether to update the client-node sections of server node of the specified cluster in the config file. (It is useful when cluster nodes and client nodes are in different networks.) True
-AcquireServerMapping <SwitchParameter> Specifies weather to fetch server mapping list from the server node(s). (It is useful when cluster nodes and client nodes are in different networks.) False
-UserId <String> Specifies the User Id used to authorize a user if security is enabled on cache server. This User Id must be the same as the active directory user credentials. -
-Password <String> Specifies the password against the user Id; to authorize a user if security is enabled on cache server. This password must be the same as active directory password. -
-NoLogo <SwitchParameter> Suppresses display of the logo banner. False