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 |