Difference between revisions of "Recitaladmin"

From Recital Documentation Wiki
Jump to: navigation, search
(--integrity)
 
(31 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
Administration management tool used with the Recital software suite. It takes the following arguments.
 
Administration management tool used with the Recital software suite. It takes the following arguments.
  
Note: recitaladmin must be run as root. For systems with a hidden root account, please precede commands with ’sudo’.
+
Note: recitaladmin must be run as root. For systems with a hidden root account, please precede commands with '''sudo'''.
  
===--server===
+
===start [ -l | logging ]===
Perform administration of the recital server daemon. See [[recitalserver]] for full details.
+
Start the recital daemon.  Logging may optionally be enabled.  
 
+
<pre>
===--replication===
+
  recitaladmin start
Perform administration of the recital replication daemon. See [[recitalreplication]] for full details.
+
</pre>
 
+
===stop===
===--integrity===
+
Stop the recital daemon. This will prevent new connections and disconnect existing connectionsIt has no effect on interactive users.  
This option  is  used  to verify and if needed, repair Recital data files.
+
<pre>
====[ -f table  ]====
+
  recitaladmin stop
Specify a table to verify a table.
+
</pre>
====[ -d directory  ]====
+
===shutdown [ message ]===
Specify a directory to verify all files in a directory.
+
Shutdown the recital daemon and interactive users. This will prevent new connections and disconnect existing connections and users. Subsequent interactive users logins are disabled.  A shutdown message can be sent to interactive users before the shutdown.
====[ -D database ]====
+
<pre>
Specify a database to verify a database.
+
====[ -r ]====
+
Recursively process sub-directories.
+
 
+
====[ -y ]====
+
This will repair data errors if any are found.
+
====[ -q ]====
+
This will only display errors.
+
====[ -a ]====
+
Run in verbose mode.
+
<code lang="bash">
+
recitaladmin --integrity  -D southwind
+
</code>
+
 
+
===--convert===
+
This option is used to convert data from disparate hardware  platforms  and  databases  into  and  out  of  Recital Databases. 
+
====[ all ]====
+
Convert all files in the current directory.
+
====[ prg ]====
+
Convert program scripts in the current directory.
+
====[ dbf ]====
+
Convert tables in the current directory.
+
====[ mem ]====
+
Convert memory variable files in the current directory.
+
====[ frx ]====
+
Convert report files in the current directory.
+
==== [ <files> ]====
+
An optional file list parameter can be specified to restrict the files converted.
+
====[ -r ]====
+
Recursively convert files in sub-directories.
+
<code lang="bash">
+
  recitaladmin --convert dbf ar*.dbf
+
</code>
+
 
+
===--execute===
+
====filename [ <args> ]====
+
Execute program file in the background as an agent.  Args specified are declared as character variables  in  the  called  program.  The  file name extension defaults to .prg.  Only program files that have no user input or display output can be run.
+
<code lang="bash">
+
recitaladmin --execute  mqagent
+
</code>
+
 
+
===--users===
+
Perform user administration tasks on Recital
+
====[ -r ]====
+
This  option  will  reset the existing recital users file. All users must be logged out before this task can be performed.
+
 
+
====[ -c ]====
+
This option will create a new users file if one doesn’t already exist.
+
 
+
====[ -l ]====
+
This option will list the  current recital users.
+
<code lang="bash">
+
  recitaladmin --users -l
+
</code>
+
===--backup===
+
Backup recital database
+
<code lang="bash">
+
recitaladmin --backup
+
</code>
+
===--restore===
+
Restore recital database
+
<code lang="bash">
+
recitaladmin --restore
+
</code>
+
 
+
===shutdown===
+
Shutdown the recital daemon and interactive users. This will prevent new connections and disconnect existing connections and users.  
+
====[ Message ]====
+
A shutdown message can be sent to interactive users before the shutdown.
+
<code lang="bash">
+
 
  recitaladmin shutdown  "Please log out."
 
  recitaladmin shutdown  "Please log out."
</code>
+
</pre>
 
===disable===
 
===disable===
 
Disable the recital daemon and interactive users. This will prevent new connections, but not disconnect existing connections and users.
 
Disable the recital daemon and interactive users. This will prevent new connections, but not disconnect existing connections and users.
<code lang="bash">
+
<pre>
 
  recitaladmin  disable
 
  recitaladmin  disable
</code>
+
</pre>
 
NOTE: An ODBC client attempting to connect to a disabled server will receive the following message:
 
NOTE: An ODBC client attempting to connect to a disabled server will receive the following message:
  
 
Invalid license: errno(-24)
 
Invalid license: errno(-24)
 
 
===enable===
 
===enable===
 
Enable the recital daemon and interactive users. This will enable new connections and users
 
Enable the recital daemon and interactive users. This will enable new connections and users
<code lang="bash">
+
<pre>
 
  recitaladmin  enable
 
  recitaladmin  enable
</code>
+
</pre>
 
===suspend===
 
===suspend===
 
Suspend the recital daemon and interactive users. This will suspend all connections to the recital server and existing users.
 
Suspend the recital daemon and interactive users. This will suspend all connections to the recital server and existing users.
<code lang="bash">
+
<pre>
 
  recitaladmin  suspend
 
  recitaladmin  suspend
</code>
+
</pre>
 
===resume===
 
===resume===
 
Resume the recital daemon and interactive users. This will resume all suspended connections and users.
 
Resume the recital daemon and interactive users. This will resume all suspended connections and users.
<code lang="bash">
+
<pre>
 
  recitaladmin resume
 
  recitaladmin resume
</code>
+
</pre>
===logout===
+
===logout [ message ]===
Log out interactive users.   
+
Log out interactive users.  A log out message can be sent to interactive users before they are logged out.
====[ Message ]====
+
<pre>
A log out message can be sent to interactive users before the they are logged out.
+
  recitaladmin logout "Please log out for system maintenance."
<code lang="bash">
+
</pre>
  recitaladmin logout "Please log out for system maintenance."
+
 
</code>
+
===logoff  username ===
===broadcast===
+
Log out a specific user.  A message is sent to the user before they are logged out.
Broadcast a message to all current interactive users.  
+
<pre>
====[ Message ]====
+
recitaladmin logoff sports
If no message is specified then any previous broadcast message will be cleared.
+
</pre>
<code lang="bash">
+
 
 +
===broadcast [ message ]===
 +
Broadcast a message to all current interactive users.  If no message is specified then any previous broadcast message will be cleared.
 +
<pre>
 
  recitaladmin  broadcast  "Hello everybody."
 
  recitaladmin  broadcast  "Hello everybody."
</code>
+
</pre>
 
===terminate===
 
===terminate===
 
Terminate cleanly the specified recital process.
 
Terminate cleanly the specified recital process.
<code lang="bash">
+
<pre>
 
  recitaladmin  terminate 999
 
  recitaladmin  terminate 999
</code>
+
</pre>
 +
 
 +
===status===
 +
Display whether the recital daemon is running or not.
 +
<pre>
 +
recitaladmin status
 +
</pre>
 +
===fullstatus===
 +
Display whether the recital daemon is running or not, the maximum and current connections and whether logging is enabled or disabled.
 +
<pre>
 +
recitaladmin fullstatus
 +
</pre>
 
===help===  
 
===help===  
Display this information
+
Display help information
<code lang="bash">
+
<pre>
 
  recitaladmin help
 
  recitaladmin help
</code>
+
</pre>
 +
 
 
===version===
 
===version===
 
Display product version
 
Display product version
<code lang="bash">
+
<pre>
 
  recitaladmin  version
 
  recitaladmin  version
</code>
+
</pre>

Latest revision as of 15:30, 11 November 2014

Administration management tool used with the Recital software suite. It takes the following arguments.

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

start [ -l | logging ]

Start the recital daemon. Logging may optionally be enabled.

 recitaladmin start

stop

Stop the recital daemon. This will prevent new connections and disconnect existing connections. It has no effect on interactive users.

 recitaladmin stop

shutdown [ message ]

Shutdown the recital daemon and interactive users. This will prevent new connections and disconnect existing connections and users. Subsequent interactive users logins are disabled. A shutdown message can be sent to interactive users before the shutdown.

 recitaladmin shutdown  "Please log out."

disable

Disable the recital daemon and interactive users. This will prevent new connections, but not disconnect existing connections and users.

 recitaladmin  disable

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

 recitaladmin  enable

suspend

Suspend the recital daemon and interactive users. This will suspend all connections to the recital server and existing users.

 recitaladmin  suspend

resume

Resume the recital daemon and interactive users. This will resume all suspended connections and users.

 recitaladmin resume

logout [ message ]

Log out interactive users. A log out message can be sent to interactive users before they are logged out.

 recitaladmin logout "Please log out for system maintenance."

logoff username

Log out a specific user. A message is sent to the user before they are logged out.

 recitaladmin logoff sports

broadcast [ message ]

Broadcast a message to all current interactive users. If no message is specified then any previous broadcast message will be cleared.

 recitaladmin  broadcast  "Hello everybody."

terminate

Terminate cleanly the specified recital process.

 recitaladmin  terminate 999

status

Display whether the recital daemon is running or not.

 recitaladmin status

fullstatus

Display whether the recital daemon is running or not, the maximum and current connections and whether logging is enabled or disabled.

 recitaladmin fullstatus

help

Display help information

 recitaladmin help

version

Display product version

 recitaladmin  version