Difference between revisions of "Recitalserver"

From Recital Documentation Wiki
Jump to: navigation, search
(start)
(shutdown)
Line 19: Line 19:
 
Used to stop the Recital Server daemon and disable interactive Recital users.  A confirmation message will be displayed showing whether the daemon was successfully stopped or not.  The optional '''message''' parameter can be used to broadcast a message to interactive Recital users.
 
Used to stop the Recital Server daemon and disable interactive Recital users.  A confirmation message will be displayed showing whether the daemon was successfully stopped or not.  The optional '''message''' parameter can be used to broadcast a message to interactive Recital users.
  
<pre># recitalserver shutdown message Please log out</pre>
+
<code lang="bash">
 
+
# recitalserver shutdown message Please log out</pre>
 +
</code>
 
Once any interactive users have logged out and the shutdown has completed, attempts to start an interactive Recital session will cause the following message to be displayed:
 
Once any interactive users have logged out and the shutdown has completed, attempts to start an interactive Recital session will cause the following message to be displayed:
  

Revision as of 09:50, 26 October 2009

recitalserver

The Recital Server daemon can be managed using the recitalserver script.

Note: recitalserver must be run as root. For systems with a hidden root account, please precede commands with ’sudo’.

start

Used to start the Recital Server daemon.

[ -l ]

An optional -l parameter can be specified to enable server logging [1].

recitalserver start -l

stop

Used to stop the Recital Server daemon. A confirmation message will be displayed showing whether the daemon was successfully stopped or not.

# recitalserver stop


shutdown

Used to stop the Recital Server daemon and disable interactive Recital users. A confirmation message will be displayed showing whether the daemon was successfully stopped or not. The optional message parameter can be used to broadcast a message to interactive Recital users.

# recitalserver shutdown message Please log out</pre>

Once any interactive users have logged out and the shutdown has completed, attempts to start an interactive Recital session will cause the following message to be displayed:

Recital logins are currently disabled. Please try again later.

disable

Used to disable new interactive Recital sessions. Existing interactive Recital sessions are unaffected.

The Recital Server

NOTE: An ODBC client attempting to connect to a disabled server will receive the following message:

Invalid license: errno(-24)

enable

Enable the recital daemon and interactive users. This will enable new connections and users

restart

Used to restart (stop, then start) the Recital Server daemon. A confirmation message will be displayed showing whether the daemon was successfully started or not.

# recitalserver restart

status

fullstatus

Used to display the following status information for the Recital Server:

  • Whether the Recital Server is running or not
  • Whether the Recital Web Server is active or not
  • Whether the Recital Web Server is listening on its default port and/or port 80
  • How many concurrent connections are licensed for each server
  • How many concurrent connections are currently being used for each server
  • Whether logging is enabled or not
# recitalserver status


help

Used to display usage information.

version

Used to display version and compilation date information for the Recital Server:

# recitalserver version