ReadMe: 
Smans data server 1.9 2008/08
Copyright (c) 2003-2008 Sergey Savushkin 

Includes Sav Zigzag 9.0 (c) 1997-2008 Technopoles-M 
-------------------------------------------------------------------------------------------

TOOLS

Smans data server is a Web site content  manager and tools for 
Web database and data site development. Really, Smans is a set
of Java servlets (smans-ds.jar) providing a Web application by the 
following functions: 
- /servlet/menu - Menu for data navigation and management. 
  Enables to execute: 
    - /servlet/manage - Possibility to manage catalogue of Web 
       resources (database/text/html files), their content and access; 
    - /servlet/query - Generation of HTML dialog depending on 
      database schema and contents; 
    - /servlet/admin - Possibility to manage users and their accounts; 
    - /servlet/email - Email sending from Web page; 
- /servlet/record - Helps to create and fill a database table simply 
  by means of HTML language. Web developer need to create only 
  correspondent HTML form (SQL/PHP/JSP/ASP are not required); 
- /servlet/recall - Simplifies database using. To create requests, 
  Web developer need to create only correspondent HTML form (no SQL); 

REQUIREMENTS

Web application server (http://resources.coreservlets.com/jsp-servers.html 
supporting Java Servlet 2.3/JSP 1.2 or later (http://java.sun.com/products/servlet/). 

FILES

wapp/WEB-INF/web.xml - Deployment descriptor 
wapp/WEB-INF/lib/ - Library: 
    smans-ds.jar - Smans data server, 
    savz.jar - Sav Zigzag database manager, 
    activation.jar, mail.jar - email support (auxilary) 
wapp/WEB-INF/smans/sys/ - Smans system data: 
    account.sdb - account, 
    catalogue.sdb - catalogue 
wapp/WEB-INF/smans/data - Smans hidden data 
wapp/... - Examples of managed data files (*.html, *.txt, *.sdb, *.gif, ...) 

INSTALLING

1. Install any Web application server (or Web container) with Java servlet/JSP
 engine. Assure that its servlet examples are running. 
2. Deploy Smans Web application, which is represented by "wapp" directory.
 For example, copy "wapp" in "webapps" deployment directory of Tomcat server.
 Deployment directory for WebLogic is "autodeploy", for JBoss is "deploy".
 Be careful, if you attend to change managed files by Smans, WAR/EAR archive
 for application is not possible. 
3. If Web server is not local, you need to share all the managed data files,
 including WEB-INF/smans/*, with the Java application or JVM. Java rather
 belongs to group, which has to have permission attributes: READ, WRITE,
 EXECUTE (7) for directories and READ, WRITE (6) for files. 
4. For test regime, the steps above are enough. Smans server will work with
 the current web.xml, but for serious exploitation you need to adapt web.xml
 descriptor. First of all, the web.xml update is regarding the context parameters
 in <context-param> tags (see comments inside of web.xml). 

STARTING

Smans data server starts automatically as a Web module in running Web 
application server. Client may address to Smans server from PC or even 
from mobile device with HTML/XHTML Web browser through the 
http://<hostname>/[<application>/]servlet/menu URL. Example for 
standalone Tomcat: http://localhost:8080/wapp/servlet/menu. First time, 
to enter in Smans menu as administrator, you need to use login with "admin" 
name and "admin" password. 

NOTES

To process Smans database files (*.sdb) in offline, you can use desktop 
development tool, Sav ZBase, http://savtechno.com. 

Each Web server has specific configuration for Web site and Smans data 
server does not affect this. For example, in Apache Web server, very useful 
may be ".haccess" file, which sets up access limitation to a Web site/directory. 
See documentation in correspondent Web server.

INTERNATIONALIZATION

Web browser must support interface with UTF-8 code. If non-English symbols 
still look incorrect, problem may lay in a Web application server. If to say about 
new version 5/6 of Tomcat, the server.xml configuration should be changed with 
such parameter:

<Connector ... useBodyEncodingForURI="true" /> 

--------------------------------------------------------------------------------

Sergey Savushkin 
http://savtechno.com 