Updates an existing portal connection from this server to another chat server.
Note The Chat Service must be stopped and restarted for this command to take effect.
See also /AddPortal, /DeletePortal, /GetPortal, /ListPortals.
Chatcmd Server /SetPortal:PortalName=Nsid,IpAddress,IpPort,Mode
| Server | This switch does not support multiple servers in its command line. Creating or setting a portal on one server does not update other servers on the network. Specify all servers individually on the network for a consistent state. |
| PortalName | The friendly name of the portal. The portal name is limited to 63 characters. You can use alphabetic characters (in the current language), numerals, the underscore, and the hyphen. The portal name must begin with an alphabetic character, an underscore, or a hyphen. |
| Nsid | The Network Server Identifier (NSID) must be between 1 and 255. Each server on a chat network must contain a unique NSID or server-to-server linkage will not occur. |
| IpAddress | The IP address to connect to on the chat server. |
| IpPort | The IP port to connect to on the chat server. A port is a unique, protocol-specific number that identifies the type of traffic on a network connection. The default server-to-server TCP/IP port is 6665. |
| Mode | The only value for Mode is UPLINK, which indicates that this server will initiate a connection to the chat server at the other end of the portal to acquire that server's state information. The state information includes the server's persistent and dynamic channels and their membership, users currently logged on to the service, and any access restrictions that are in effect, such as user bans. UPLINK designates the direction in which the state information is sent. |
| State information must travel in only one direction over a portal connection; that is, only one server can initiate the uplink. This prevents loops, or circuits, in a network of two or more chat servers. | |
| This parameter is optional. |
chatcmd myserv01 /setportal:myserv02=2,10.113.3.33,6665 | |
| Configures the portal between Myserv01 and Micrsrv02. | |
chatcmd myserv02 /setportal:myserv01=1,10.113.3.44,6665,uplink | |
| Configures the portal between Myserv02 and Micrsrv01, and enables Myserv01 to initiate a connection to Myserv02 to aquire state information. |