FS
Documentation

Backup3G/EWC/Man Pages

From Documentation

(Difference between revisions)
Jump to: navigation, search
Revision as of 12:29, 19 February 2008
Moff (Talk | contribs)
(COSserver)
← Previous diff
Revision as of 12:50, 19 February 2008
Moff (Talk | contribs)
(COSserver)
Next diff →
Line 38: Line 38:
'''EXAMPLES''' '''EXAMPLES'''
:<code>COSserver -install</code> :<code>COSserver -install</code>
- +::Install the COSserver as a service.
- Install the COSserver as a service.+
:<code>COSserver -remove</code> :<code>COSserver -remove</code>
- +::Remove the COSserver service.
- Remove the COSserver service.+
:<code>COSserver -d</code> :<code>COSserver -d</code>
- +::Run COSserver interactively, and turn on debug information. Note that the COSserver service must be turned off for this to work.
- Run COSserver interactively, and turn on debug information. Note that+
- the COSserver service must be turned off for this to work.+
'''FILES''' '''FILES'''
:<tt>$EBC_HOME/db/hostinfo</tt> :<tt>$EBC_HOME/db/hostinfo</tt>
- This file contains the list of hosts that are allowed to+::This file contains the list of hosts that are allowed to execute commands on the local host. Each host is followed by a comunications method that is used from the local host to execute commands on that host.
- execute commands on the local host. Each host is followed by a+
- comunications method that is used from the local host to execute commands+
- on that host.+
'''ENVIRONMENT''' '''ENVIRONMENT'''
- <B>APPL_HOME</B><BR>+:<tt>APPL_HOME</tt>
- The base directory of the Enterprise Windows Client. This value is+::The base directory of the Enterprise Windows Client. This value is retrieved from the registry via the <tt>HomeDir</tt> value under the Enterprise Windows Client section of <tt>HKEY_LOCAL_MACHINE\SOFTWARE</tt>
- retrieved from the registry via the HomeDir value under the Enterprise+
- Windows Client section of <I>HKEY_LOCAL_MACHINE\SOFTWARE</I>.<BR>+
- e.g. /cygdrive/C/Program Files/Functional Software/EWC_5.1<BR><BR>+::For example: <tt>/cygdrive/C/Program Files/Functional Software/EWC_5.1</tt>
- <B>APPL_NAME</B><BR>+:<tt>APPL_NAME</tt>
- For the <I>cos</I> command to be run in the correct environment, the+::For the ''cos'' command to be run in the correct environment, the variable <tt>APPL_NAME</tt> must be set. <tt>APPL_NAME</tt> can be set to either backup or task.
- variable <CODE>APPL_NAME</CODE> must be set. <CODE>APPL_NAME</CODE> can+
- be set to either backup or task.<BR><BR>+
- <B>EWC_HOME</B><BR>+:<tt>EWC_HOME</tt>
- The base directory of the Enterprise Windows Client in <I>DOS</I> syntax.+::The base directory of the Enterprise Windows Client in <I>DOS</I> syntax.
- <BR>+
- e.g. C:\Program Files\Functional Software\EWC_5.1<BR><BR>+::For example: <tt>C:\Program Files\Functional Software\EWC_5.1</tt>
- <B>FULLNAME</B><BR>+:<tt>FULLNAME</tt>
- The fullname of the user connecting to the Enterprise Windows Client.<BR>+:The fullname of the user connecting to the Enterprise Windows Client.
- e.g. COSmanager<BR><BR>+::For example: <tt>COSmanager</tt>
- <B>LOGNAME</B><BR>+:<tt>LOGNAME</tt>
- The username of the user connecting to the Enterprise Windows Client.<BR>+::The username of the user connecting to the Enterprise Windows Client.
- e.g. cosmos<BR><BR>+::For example: <tt>cosmos</tt>
- <B>PATH</B><BR>+:<tt>PATH</tt>
- The location, relative to <I>EWC_HOME</I> of the Enterprise Windows Client+::The location, relative to <tt>EWC_HOME</tt> of the Enterprise Windows Client executables is prepended to the <tt>PATH</tt> variable.
- executables is prepended to the <tt>PATH</tt> variable.+
-e.g. /bin:/cygdrive/c/Windows/system32:/cygdrive/c/Windows+::For example: <tt>/bin:/cygdrive/c/Windows/system32:/cygdrive/c/Windows</tt>
- '''USERNAME'''<BR>+:<tt>USERNAME</tt>
- The username of the user connecting to the Enterprise Windows Client.<BR>+::The username of the user connecting to the Enterprise Windows Client.
- e.g. cosmos+::For example: <tt>cosmos</tt>
 +<br>
'''DIAGNOSTICS''' '''DIAGNOSTICS'''
- <TD ALIGN=LEFT COLSPAN=3>The following exit values are returned:</TD>+:The following exit values are returned:
- </TR>+:{|
- <TR>+|width=20 |1
- <TD WIDTH=16></TD>+|program or system error
- <TD WIDTH=16>1</TD>+|-
- <TD>program or system error</TD>+|0
- </TR>+|successful
- <TR>+|-
- <TD></TD>+|}
- <TD>0</TD>+
- <TD>successful</TD>+
- +
 +<br>
'''SEE ALSO''' '''SEE ALSO'''
-FSremote+[[#FSremote|FSremote]]
- +
 +<br>
'''COPYRIGHT''' '''COPYRIGHT'''
:Copyright © 1990-{{CURRENTYEAR}} Functional Software. All rights reserved. :Copyright © 1990-{{CURRENTYEAR}} Functional Software. All rights reserved.

Revision as of 12:50, 19 February 2008

Contents

COSserver

NAME

COSserver - remote COSmanager command execution


SYNOPSIS

COSserver -i | -install
COSserver -r | -remove
COSserver [-d]


DESCRIPTION

COSserver is a TCP service listening on port 9002 and provides remote execution facilities. It is used to execute commands requested by remote COSserver clients.
Clients connect to the server and request the execution of a command on behalf of a user. If the client has the necessary authority, theserver will execute the command and return the standard output and standard error of the command to the client. Any standard input sent from the client is passed to the command. It will also return the exit status of the command executed.
COSserver does a series of authentication steps to ensure that the request is genuine. These are:
  1. The local hostinfo table is consulted, to ensure that the request originates from a known COSmanager host;
  2. COSserver generates a random number, which is passed back to the host making the request. This random number is then hashed with the contents of the request, and the encrypted hash code is passed back to COSserver. COSserver then verifies that the hash code is correct.


OPTIONS

-i
-install
Install COSserver as a service. Once installed, it can be controlled using the net command, or using the Services window invoked from the Control Panel.
-r
-remove
Remove the COSserver service.
-d Turn on debugging. Useful if there is a problem connecting.
There are a couple of other flags mentioned in the help screen which are only useful for testing purposes.


EXAMPLES

COSserver -install
Install the COSserver as a service.
COSserver -remove
Remove the COSserver service.
COSserver -d
Run COSserver interactively, and turn on debug information. Note that the COSserver service must be turned off for this to work.


FILES

$EBC_HOME/db/hostinfo
This file contains the list of hosts that are allowed to execute commands on the local host. Each host is followed by a comunications method that is used from the local host to execute commands on that host.


ENVIRONMENT

APPL_HOME
The base directory of the Enterprise Windows Client. This value is retrieved from the registry via the HomeDir value under the Enterprise Windows Client section of HKEY_LOCAL_MACHINE\SOFTWARE
For example: /cygdrive/C/Program Files/Functional Software/EWC_5.1
APPL_NAME
For the cos command to be run in the correct environment, the variable APPL_NAME must be set. APPL_NAME can be set to either backup or task.
EWC_HOME
The base directory of the Enterprise Windows Client in DOS syntax.
For example: C:\Program Files\Functional Software\EWC_5.1
FULLNAME
The fullname of the user connecting to the Enterprise Windows Client.
For example: COSmanager
LOGNAME
The username of the user connecting to the Enterprise Windows Client.
For example: cosmos
PATH
The location, relative to EWC_HOME of the Enterprise Windows Client executables is prepended to the PATH variable.
For example: /bin:/cygdrive/c/Windows/system32:/cygdrive/c/Windows
USERNAME
The username of the user connecting to the Enterprise Windows Client.
For example: cosmos


DIAGNOSTICS

The following exit values are returned:
1 program or system error
0 successful


SEE ALSO FSremote


COPYRIGHT

Copyright © 1990-2024 Functional Software. All rights reserved.
Based on version 1.5 - Last modified 5th January 2008.

^

FSntcpio

FSregback

FSremote

FSsysstate

busplit

cos

db_date

devio

NAME

devio - handle I/O to devices such as tape drives


SYNOPSIS

devio -i|o [-bcdLmnprs1] [command]


DESCRIPTION

Devio reads data from or writes data to either a disk file or a device such as a tape drive. Devio can be called several times in succession to write to a set of tapes or other media, and handle volume changes as necessary.
Normally devio reads from the device, passing data to standard output (-i option) or writes to the device, obtaining data from standard input (-o option). However, if a command is given as a parameter (which must be quoted to ensure that it is passed as a single parameter), then it is executed, and data is piped to or from that process. Devio will then terminate with the same exit status as this process. This is useful if devio is called from a shell script which needs to know whether the data transfer was successful.


OPTIONS

-i Devio will read data from the device, passing it to STDOUT or to the standard input of the optional command.
-o Devio will write data to the device, reading it from STDIN or from the standard output of the optional command.
-d device I/O will be done to the specified device or file. Typically this would be a Windows tape device name, such as tape0. If this option is omitted, the environment variable TAPE should specify the device.
-n name This specifies a name by which the user knows the device, as specified by the -d option. If this option is specified, then any user messages referring to the device will use the specified name, rather than the Windows device name.
-b blocksize The blocksize in KB that should be used for I/O to the device. The default is 64KB.
-c capacity The capacity in KB of each volume. This figure should be the amount of data that can safely be written. Devio will request a change of volume after this amount has been read or written. The default is unlimited capacity, implying that media changes will occur at physical end of volume or on an I/O error.
-m command A command to run to change the volume in the device. This command should exit with a status of 0 when the drive is ready and loaded with the new volume. It can also optionally write the name of the next device to use on its STDOUT (if it has changed). A non-zero exit status will cause devio to exit with that status. This command can also do things like checking for or writing a label on the new tape.
-s startpos The amount of data in KB to to skip or that has already been written on the first volume. This tells devio how much data can still fit (if writing) or remains (if reading) on the first volume. On subsequent volumes it is assumed that the full capacity (given by -c) is available. The default is 0, i.e.: starting at the beginning of the volume.
-r amount The amount of data in KB that devio should read. This is only applicable with the -i option, and is only necessary on devices, such as floppy disks, which have no mechanism for delimiting files or datasets on the one volume. By default devio will read to end of file.
-P volsizes The amounts of data in KB that devio should read on each volume. If more than one size is given, devio will read the first amount, request a volume change, and continue to read the second amount etc. This is only applicable with the -i option. By default devio will stop at end of file.
-L Indicates that the data being read or written is a single block tape label. Unless -b is specified, this will be a 512 byte block.
-p Indicates that all blocks are to be written at the specified blocksize. Normally devio will write a short last block if there is insufficient data to fill the block. This flag will cause such a block to be NULL padded.
-1 Indicates that at least one block should be written to the device, even if there is no input data. This is useful for jobs which write multiple files to one tape, and want to ensure that the relative positions of each file is constant, even if one file is empty. Many tape devices have no means of writing an empty file.
-u Causes devio to write details of the amounts of data written, the elapsed time & rate to the given file.


EXAMPLES

devio -o -b32 -d tape0 'FSntcpio -f C:/local'
Write a backup of C:/local to tape device tape0 using 32K blocksize.
devio -i -b32 -d tape0 'FSntcpio -r C:/tmp'
Recover the contents of tape device tape0 to C:/tmp. Data is read from tape0 in 32K blocks and passed to FSntcpio.


SEE ALSO

devscan(1), ntcpio(1), FSntcpio(1)


COPYRIGHT

Copyright © 1990-2024 Functional Software. All rights reserved.
Based on version 4.1 - Last modified 24th January 2008.

^

devscan

ewc

file_excl

file_list

mt

ntcpio

regback

rsh

rshd

service

tapelabel