|
|
|
|
Communication with the BVE Server consists of two phases: a connection establishment phase and a command-execution phase. After connecting to the TCP port (default 7661) on the BVE server, the remote client authenticates using a username and password, the same as logging in using the web user interface. Once the user is authenticated, all subsequent commands sent to the server are executed with the permissions and privileges of the specified department that the user belongs to. It is possible to change the privilege level at any point in the command-reply phase by entering new authentication information using the login command.
Once the connection establishment phase has been completed, the client application may send one command at a time and wait to receive a reply from the server. This may consist of multiple lines of output.
The client application establishes a connection to the BVE server by opening a TCP/IP socket on a pre-defined port number specified in etc/emerald.xml. The default port number is 7661. Upon establishment of the TCP session, the server greets the client with a welcome message following the rules outlined below.