SNFUtility/SNFMilterConfig/SNFMilterConfigTests.txt

			SNFMilterConfig Tests

$Id$

SNFUtility revision 9

Help functionality
------------------

HELP-01: SNFMilterConfig without any command options outputs a help
message.

  Result:  Pass.


Conflict detection
------------------

CONFLICT-01: Run with -setup, -id, and -auth.  Verify that help
message is output, and that SNFMilterConfig takes no action.

  Result:  Pass.

CONFLICT-02: Run with -setup and -start.  Verify that help message is
output, and that SNFMilterConfig takes no action.

  Result:  Pass.

CONFLICT-03: Run with -setup and -stop.  Verify that help message is
output, and that SNFMilterConfig takes no action.

  Result:  Pass.

CONFLICT-04: Run with -setup and -mta=XXX, where XXX is postfix,
sendmail, and none.  Verify that help message is output, and that
SNFMilterConfig takes no action.

  Result:  Pass.

CONFLICT-05: Run with -config=SNFMilter_second.xml -start.  Verify
that help message is output, and that SNFMilterConfig takes no action.

  Result:  Pass.

Setup/Repair functionality
--------------------------

SETUP-01: Start with no configuration files installed (SNFMilter.xml,
identity.xml GBUdbIgnoreList.txt, and getRulebase).  Verify that
either "-setup" or "-repair" creates these files with the default
credentials.

  Result:  Pass.

SETUP-02:  Repeat SETUP-01 with -v and verify that files are created.

  Result:  Pass.

SETUP-03:  Repeat SETUP-01 with -explain and verify that files are not created.

  Result:  Pass?  Exception thrown (as expected) when attempting to read
  configuration file that doesn't exist.

Config file specification
-------------------------

CONF-01: Start with no configuration files, and copy the sample
configuration file to test.xml.  Run with "-setup -config=test.xml",
and verify that all configuration files except
/etc/snf-milter/SNFMilter.xml are created.

  Result:  Pass.

CONF-02:  Repeat with -v and verify the same behavior.

  Result:  Pass.

CONF-03:  Repeat with -explain.

  Result:  Pass.

Credential Functionality
------------------------

CRED-01: Configure, and run "-id=xxx -auth=yyy" with specification of
incorrect credentials.  Verify:

  1) getRulebase is not updated, and getRulebase.failed file is
     created.,

  2) The rulebase downloaded fails, and an error message is output,

  3) The identity.xml file is not changed.

  Result:  Pass.

CRED-02:  Repeat CRED-01 with -v and verify correct operation.

  Result:  Pass.

CRED-03:  Repeat CRED-01 with -explain and verify correct operation.

  Result:  Pass.

CRED-04: Install default configuration files.  Modify identity.xml as
follows:

  1) Change the license ID to "XXX" and authentication to "YYY".

  2) Add a comment.

Then run with "-id=testmode -auth=setuptestingonly".  Verify:

  1) getRulebase is updated, and the new rulebase is downloaded.

  2) identity.xml has only the license ID and authentication updated.

  Result:  Pass.

CRED-05: Repeat CRED-04 with -v and verify correct operation.

  Result:  Pass.

CRED-05: Repeat CRED-04 with -explain and verify correct operation.

  Result:  Pass

Start/stop functionality with XCI enabled
-----------------------------------------

START_STOP_XCI-01: Install default configuration files, and ensure
that SNFMilter is stoped.  Create a configuration file
SNFMilter_xci.xml as follows:

  1) Enable XCI.

  2) Enable status.second logging, with no append.

  3) Enable status.minute logging, with append.

Do the following, specifying the configuration file SNFMilter_xci.xml:

  1) Run SNFMilterConfig with "-start", and verify that SNFMilter starts.

  2) Run SNFMilterConfig with "-start" again and verify that SNFMilter
     is not started again.

  3) Run SNFMitlerConfig with "-stop" and verify that SNFMilter stops.

  4) Run SNFMitlerConfig with "-stop" again and verify that SNFMilter
     is not stopped again.

  Result:  Pass

START_STOP_XCI-02: Repeat START_STOP_XCI-01 but with "-v" in the command-line.

  Result:  Pass

START_STOP_XCI-03: Configure as for START_STOP_XCI-01, and do the following:

  1) Run SNFMilterConfig with "-start -explain".  Verify correct
     output, and that SNFMilterConfig doesn't start SNFMilter.

  2) Run SNFMilterConfig with "-stop -explain".  Verify correct
     output, and that SNFMilterConfig doesn't stop SNFMilter.

  3) Start SNFMilter.

  4) Run SNFMilterConfig with "-start -explain".  Verify correct
     output, and that SNFMilterConfig doesn't start SNFMilter.

  5) Run SNFMilterConfig with "-stop -explain".  Verify correct
     output, and that SNFMilterConfig doesn't stop SNFMilter.

  Result:  Pass

Start/stop functionality with XCI disabled, status.second enabled
-----------------------------------------------------------------

START_STOP_SEC-01: Install configuration file SNFMilter_second.xml
with the following configuration:

  1) Disable XCI.

  2) Enable status.second logging, with no append.

  3) Enable status.minute logging, with append.

Do the following:

  1) Run "SNFMilterConfig -start -v", and verify that SNFMilter
     starts.

  2) Run "SNFMilterConfig -start -v" again and verify that SNFMilter
     is still running.

  3) Run "SNFMilterConfig -stop -v" and verify that SNFMilter stops.

  4) Run "SNFMilterConfig -stop -v" again and verify that SNFMilter is
     still stopped.

  Result:  Pass

START_STOP_SEC-02: Repeat START_STOP_SEC-01 but without "-v" in the
command-line.

  Result:  Pass

START_STOP_SEC-03: Configure as for START_STOP_SEC-01, and do the
following:

  1) Run SNFMilterConfig with "-start -explain".  Verify correct
     output, and that SNFMilter is still stopped.

  2) Run SNFMilterConfig with "-stop -explain".  Verify correct
     output, and that SNFMilter is still stopped.

  3) Start SNFMilter.

  4) Run SNFMilterConfig with "-start -explain".  Verify correct
     output, and that SNFMilter is still running.

  5) Run SNFMilterConfig with "-stop -explain".  Verify correct
     output, and that SNFMilter is still running.

  Result:  Pass

Start/stop functionality with XCI disabled and status.second enabled, append mode
---------------------------------------------------------------------------------

START_STOP_SEC_APP-01: Install configuration file
SNFMilter_second_append.xml with the following configuration:

  1) Disable XCI.

  2) Enable status.second logging with append.

  3) Enable status.minute logging, with append.

  4) Set localtime to "no" for rotation.

Do the following when the local date is different from the date from
gmtime():

  1) Run "SNFMilterConfig -start -v", and verify that SNFMilter
     starts.

  2) Run "SNFMilterConfig -start -v" again and verify that SNFMilter
     is still running.

  3) Run "SNFMilterConfig -v -stop" and verify that SNFMilter stops.

  4) Run "SNFMilterConfig -stop -v" again and verify that SNFMilter is
     still stopped.

  Result:  Pass

START_STOP_SEC_APP-02: Repeat START_STOP_SEC_APP-01 but without "-v"
in the command-line.

  Result:  

START_STOP_SEC_APP-03: Configure as for START_STOP_SEC_APP-01, and do
the following:

  1) Run SNFMilterConfig with "-start -explain".  Verify correct
     output, and that SNFMilterConfig doesn't start SNFMilter.

  2) Run SNFMilterConfig with "-stop -explain".  Verify correct
     output, and that SNFMilterConfig doesn't stop SNFMilter.

  3) Start SNFMilter.

  4) Run SNFMilterConfig with "-start -explain".  Verify correct
     output, and that SNFMilterConfig doesn't start SNFMilter.

  5) Run SNFMilterConfig with "-stop -explain".  Verify correct
     output, and that SNFMilterConfig doesn't stop SNFMilter.

  Result:  

Start/stop functionality with XCI and status.second disabled, status.minute enabled
-----------------------------------------------------------------------------------

START_STOP_MIN-01: Install default configuration files, and ensure
that SNFMilter is stopped.  Create a configuration file
SNFMilter_minute.xml as follows:

  1) Disable XCI.

  2) Disable status.second logging.

  3) Enable status.minute logging, with append.

Do the following, specifying the configuration file SNFMilter_minute.xml:

  1) Run "SNFMilterConfig -config=SNFMilter_minute.xml  -start", and verify that SNFMilter starts.

  2) Run "SNFMilterConfig -config=SNFMilter_minute.xml -start" again
     and verify that SNFMilter is not started again.

  3) Run "SNFMilterConfig -config=SNFMilter_minute.xml -stop" and
  verify that SNFMilter stops.

  4) Run "SNFMilterConfig -config=SNFMilter_minute.xml -stop" again
     and verify that SNFMilter is not stopped again.

  Result:  

START_STOP_MIN-02: Repeat START_STOP_MIN-01 but with "-v" in the
command-line.

  Result:  

START_STOP_MIN-03: Configure as for START_STOP_MIN-01, and do the
following:

  1) Run SNFMilterConfig with "-start -explain".  Verify correct
     output, and that SNFMilterConfig doesn't start SNFMilter.

  2) Run SNFMilterConfig with "-stop -explain".  Verify correct
     output, and that SNFMilterConfig doesn't stop SNFMilter.

  3) Start SNFMilter.

  4) Run SNFMilterConfig with "-start -explain".  Verify correct
     output, and that SNFMilterConfig doesn't start SNFMilter.

  5) Run SNFMilterConfig with "-stop -explain".  Verify correct
     output, and that SNFMilterConfig doesn't stop SNFMilter.

  Result: