Files
scst/scstadmin/README
Mark Buechler be6f9f219b - Rename sysfs and procfs to better names.
- Specify module use version for procfs scstadmin.



git-svn-id: http://svn.code.sf.net/p/scst/svn/trunk@1861 d57e44dd-8a1f-0410-8b47-8ef2f437770f
2010-07-22 14:51:08 +00:00

106 lines
3.7 KiB
Plaintext

SCST Configuration/Administration scripts. Here you'll find scstadmin which reads
a configuration file /etc/scst.conf, or one if your choosing. With it you can manually
or automatically configure every aspect of SCST incuding enabling/disabling target mode
on your target SCSI controller. The old directory contains scst_db which uses a mysql
backend database to configure SCST but doesn't handle all the things scstadmin handles.
The perl module SCST::SCST is very generic and tries to handle error checking as well.
The init script was written for debian but should work on most distributions.
scstadmin.sysfs
Use this version if you've disabled procfs support in SCST.
scstadmin.procfs
This is the default version which uses the older procfs.
scst-0.8.22 This is the SCST Perl module required by scstadmin and scst_db.
scst-0.9.00 This is the SCST Perl module to be used with SCST compiled
for sysfs. Note, the current version of scstadmin will NOT yet
work with this module.
scstadmin Script which can accept operations on a command line or from
a configuration file. See scst.conf. For command help,
#> scstadmin
old Script which configures SCST using configurations
found in a database. See the examples directory database
schema and example data. You will need to edit the
config file scst_db.conf to refect your environment.
scst.conf Configuration file for scst script. Usually stored
in /etc.
examples Configuration examples.
init.d/scst Init script to start SCST on boot which uses scstadmin.
Installation:
=============
Installation is simple.
#> make
#> make install
This installs scstadmin, the init.d script and the perl module. If you want SCST to
startup and configure automatically upon boot, enable SCST using your favorite
SysV init editor.
NOTE: The init.d startup & shutdown scripts now depend on lsb-core. Ensure you have
lsb-core installed or 'make install' will fail. Make sure /usr/lib/lsb/install_initd
exists.
To enable the newer sysfs version:
#> make disable_proc
#> make
#> make install
Getting Started:
================
The following pertains to the older procfs based SCST. The new sysfs version is still
a work in progress, but should be mostly complete at this point. You may still use your
old scst.conf, however, I very much recommend you perform a -write_config and review
the resulting configuration file.
The scstadmin script is much more functional than scst_db at this point but uses a
standard text-based config file. The original thought behind scst_db was to write
a daemon process which would except network connections and issue SCST commands. A
client app would then connect to that port.
Copy scst.conf to /etc and edit it to your liking. if you have an existing configuration
then have scstadmin write it out to a config file for you:
#> scstadmin -WriteConfig /etc/scst.conf
When removing devices, users or groups from the config file keep in mind that
"scstadmin -config" will NOT remove those configurations from the running system unless
you use the -ForceConfig flag. Also, using the init script to reload the configuration
#> /etc/init.d/scst reload-config
will also not remove configurations from a running system.
NOTE! Section "[TARGETS enable]" in the config file is for qla2x00t driver only!
Mark.Buechler@gmail.com
To Do:
======
- Compare device and assignment options between current and saved configurations and
reopen/reassign as required if -ForceConfig is used.
Completed:
==========
- Create options section to scst.conf which will be carried forward in a -writeconfig.
- Add option to issue a LIP after any group assignment changes so initiators can see
the change immediately.