Add-ClientNode
This PowerShell cmdlet enables users to add one or more client nodes to existing clustered cache(s). This cmdlet updates the server configuration and acquires the relevant server mapping if specified.
Note
This feature is also available in the NCache Community Edition.
Add-ClientNode -CacheName –Server -ClientNode [-Port] [-UpdateServerConfig] [-AcquireServerMapping] [-Credentials] [-NoLogo]
Examples
- This command adds a client node 20.200.20.12 to a cache named demoCache which already exists on server node 20.200.20.11.
Add-ClientNode -CacheName demoCache -Server 20.200.20.11 -ClientNode 20.200.20.12
- This command adds a client node 20.200.20.12 to a cache named demoCache which already exists on server node 20.200.20.11 while specifying port number.
Add-ClientNode -CacheName demoCache -Server 20.200.20.11 -ClientNode 20.200.20.12 -Port 8250
- This command adds a client node 20.200.20.12 to a cache named demoCache which already exists on server node 20.200.20.11 and updating the server config.
Add-ClientNode -CacheName demoCache -Server 20.200.20.11 -ClientNode 20.200.20.12 –UpdateServerConfig
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 the client node will be added. Note: that the cache must already exist on the source server. |
- |
-Server* |
<String> |
Specifies the name of the server where the NCache Service is running and the specified cache is registered. The client configuration will be copied from this server to the destination server. | - |
-ClientNode* |
<String> |
Specifies the client node to be added, where the NCache Service is running. | - |
-Port |
<Integer> |
Specifies the server port where the NCache Service is listening. | 8250 |
-UpdateServerConfig |
<SwitchParameter> |
Specifies whether to update the client node section on the server node's configuration file for the specified cluster. This is useful when cluster nodes and client nodes are on different networks. | True |
-AcquireServerMapping |
<SwitchParameter> |
Specifies whether to fetch the server mapping list from the server node(s). This is useful when cluster nodes and client nodes are on different networks. | False |
-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 |
