Changeset 4403 for TI12-security/trunk/python/ndg.security.test/ndg/security/test/attributeauthorityclient/README

Timestamp:

31/10/08 13:41:54 (12 years ago)

Author:

pjkersha

Message:

Updated sessionmanager and attributeauthorityclient unit test readmes

File:

• TI12-security/trunk/python/ndg.security.test/ndg/security/test/attributeauthorityclient/README (modified) (1 diff)

TI12-security/trunk/python/ndg.security.test/ndg/security/test/attributeauthorityclient/README

@@ -3 +3 @@
 The test client connects to two different test Attribute Authorities
 corresponding to the fictitious Service Providers Site "A" and Site "B".  Each
-has its own respective properties file.  The services require access to specific
-security settings so the following should be done, if not running as root:
+has its own respective properties file.  
 
-i) Set the NDGSEC_DIR environment variable set to a local dir
-ii) Copy /ndg/security/server/conf and /ndg/security/server/logs directories to this dir
-iii) Set the NDGSEC_AA_PROPFILEPATH environment variable to the file with the server config
- - i.e. siteAAttAuthorityProperties.xml (the same env var should be used for the siteB config file)
+These services must be started before running the unit tests.  Start a terminal
+in this directory and run:
 
-These services must be started before
-running the unit tests.  Start a terminal in this directory and run:
-
-$ python ./siteAServer.py
+$ python ./wsgi/siteAServerApp.py
 
 ...and in a separate terminal:
 
-$ python ./siteBServer.py
+$ python ./wsgi/siteBServerApp.py
 
-Note however that the siteBServer is only needed for tests for getting mapped 
-certificates: test7GetMappedAttCert and test8GetMappedAttCertStressTest
+Configuration for these services is held in the files ./wsgi/site-a.ini and
+./wsgi/site-b.ini respectively.
 
-Settings for the client to these services are configured with 
-attAuthorityClientTest.cfg.  The default values should work as set - although these assume
-that tcpmon is running in the system - with local port = 4900 and server port = 5000.  NB,
-problems may occur due to proxy settings (Access Denied errors); no proxy should be specified for the ports used by
-the services - i.e. use:
+Note however that the siteBServerApp.py is only needed for tests for getting 
+mapped attribute certificates: test7GetMappedAttCert and 
+test8GetMappedAttCertStressTest
 
-export no_proxy=localhost:5100,localhost:5000,localhost:4900 
+Settings for the client to these services are configured with the file
+attAuthorityClientTest.cfg.  The default values should work as set.
 
-Run the unit tests script AttAuthorityClientTest.py from another terminal:
+Problems may occur due to proxy settings (Access Denied errors); no proxy 
+should be specified for the ports used by the services - i.e. use:
 
-$ python ./AttAuthorityClientTest.py
+$ unset http_proxy
+
+or set specific exceptions according to the address+port of the services used:
+
+$ export no_proxy=localhost:5100,localhost:5000
+
+Run the unit tests script test_attributeauthorityclient.py from another
+terminal:
+
+$ python ./test_attributeauthorityclient.py
 
 Tests can be run individually e.g.
 
-$ python ./AttAuthorityClientTest.py AttAuthorityClientTestCase.test1GetX509Cert
+$ python ./test_attributeauthorityclient.py AttributeAuthorityClientTestCase.test1GetX509Cert
+
+Running Services with the Twisted Application Server
+====================================================
+Services have been ported from the Twisted Application Server to run with a
+WSGI wrapper under Paste.  Paste scripts are held in the wsgi/ sub-directory
+and the previous Twisted based ones in twisted/.  These are untested and may
+be removed from future releases of NDG-Security.
+
+P J Kershaw 31/10/08