Defines a new portal connection from this server to another chat server. When you establish a network connection between two chat servers, you create a portal on each server that contains information about the other server. This information identifies the connection (portal name), indicates where to find the server (IP address), designates the specific protocol connection over which chat information will travel (port), and uniquely identifies the chat server (server ID number).
In addition to a network connection, servers on a chat network need a way to propagate their state information and to maintain a consistent record of it across the network. When you create a portal between a pair of servers, you must indicate which server will initiate the connection to acquire the other server's state information. You do this by setting the Mode to UPLINK on the server you create the portal from.
A complete portal connection requires portal entries on both servers. Only one side of each two-server connection can be the UPLINK connection.
Note The Chat Service must be stopped and restarted for this command to take effect.
See also /DeletePortal, /SetPortal, /GetPortal, /ListPortals.
Chatcmd Server /AddPortal: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 /addportal:myserv02=2,10.113.3.33,6665 | |
| Adds a portal between Myserv01 and Myserv02. | |
chatcmd myserv02 /addportal:myserv01=1,10.113.3.44,6665,uplink | |
| Adds a portal between Myserv02 and Myserv01, and enables Myserv02 to initiate a connection to Myserv01 to aquire state information. |