InstantWeb

This manual splits up into two parts. The first part Application describes the required steps to install the complete ClassiX® InstantWeb applications. The second chapter Development contains information on how to setup an environment to develop ClassiX® InstantWeb applications.

Application

To be able to use ClassiX® InstantWeb, it is necessary to install the following components:

Java

The Sun Java Development Kit (JDK) is required. The following steps need to be executed for the setup:

  1. The latest J2SE SDK from  Ecterne Verknüpfunghttp://java.sun.com needs to be installed, e.g. after c:\Programme\java
  2. Two new folders A* and B* from the installation process are generated (see below) (Nov.2004: A* = c:\Programme\java\j2re1.4.2_06 und B* = c:\Programme\java\jdk1.4.2)
  3. Set environment variable JAVA_HOME on <Installation Directory> (Nov.2004: jdk1.4.2):
        JAVA_HOME=c:\Programme\java\jdk1.4.2
  4. Complete environment variable PATH with <Installation Directory>\bin (Nov.2004: jdk1.4.2\bin):
        PATH=%PATH%;c:\Programme\java\jdk1.4.2\bin
  5. Testing: execute java -version in a console

The environment variables should be set permanently, under WindowsXP/2000 via "System Control" -> "System" in tab "Expanded" please select button "Environment Variables" and then generate new system variables via button "New". Now, please enter names and values as described above.

Attention!
InstantWeb has not been checked yet with Java 5 (Java 1.5.x).

Java controls the resource access via socalled Security Policies. Here an example, how all access authorization are assigned to ClassiX® InstantWeb altogether. A detailed manual about the rights assignment can be found in the InstantWeb Technical Documentation.

Please enter the following line at the start in block grant {} in <setup directory\A*(s.o.)>\lib\security\java.policy and <setup directory\B*(s.o.)>\jre\lib\security\java.policy: permission java.security.AllPermission;

Servlet Container

A servlet container is necessary to execute the ClassiX® InstantWeb and to provide it to a browser. InstantWeb got tested with different servlet containers, here the installation of the free servlet container Tomcat gets described:

  1. Download Tomcat from  Ecterne Verknüpfunghttp://jakarta.apache.org
  2. Installation via setup program, e.g. after c:\Programme\Apache\Tomcat 4.1: At the installation start, the environment variable JAVA_HOME (see above) the java directory will be displayed. Therefore, it is necessary to install Java up front! At installation end, a port (by default 8080, see below) and user name (admin) will be required - this can be confirmed as specified. On the local computer, 127.0.0.1 is the Tomcat server by default.
  3. Testing: The Tomcat programs are automatically entered int the Start/All program list under the entry Apache Tomcat.. . Here are entries for the 1. Start Tomcat, 2. Tomcat Administration (login as admin (see above)), 3. Stop Tomcat.

Web Applications

Finally, the ClassiX® InstantWeb applications need to be passed to the servlet container, and according adjutments need to be made. For this, all servlet containers bring some sort of deploy mechanism. Here, the process is explained with the example Tomcat:

  1. Eventually stop servlet container again for security reasons (for Tomcat via according entry in the start menu).
  2. At first, file %CX_ROOTDIR%\InstantWeb\InstantWeb.war needs to be deployed. For this, just copy the file into the directory <Tomcat Installation Directory>\webapps.
  3. Now, please restart Tomcat. After this, the directory "InstantWeb" exists under <Tomcat Installation Directory>\webapps.
  4. Now it is possible to make any customised adjustments (design etc.) in JSP files or HTML- and CSS files. In file Tomcat Installation DIrectory>\webapps\InstantWeb\GLOBAL_ControlWin.jsp, it is possible to remove the web applications, which are not being used. For this simply remove or comment out the according tags (with JSP comments: <%-- comment --%>).
  5. The single web applications are in directory %CX_ROOTDIR%\InstantWeb\Webapps. Each sub-directory represents a web application. The required web applications must be integrated into the base application (InstantWeb.war). For this, please copy all files directly into the sub-directory <Tomcat Setup Directory>\webapps\InstantWeb. The "css" directory content has to be copied into the folder <Tomcat Installation Directory>\webapps\InstantWeb\css. All files *.java and *.class from "WEB-INF\classes\com\classix" have to be copied into the folder <Tomcat Installation Directory>\webapps\InstantWeb\WEB-INF\classes\com\classix. Simply insert the *.properties file content at the end into the according properties files in <Tomcat Installation Directory>\webapps\InstantWeb\WEB-INF\classes\com\classix. Insert contents of the sections <form-beans>, <global-forwards> and <action-mappings> in file WEB-INF\struts-config.xml into the according sections of file <Tomcat Installation Directory>\webapps\InstantWeb\WEB-INF\struts-config.xml.

Finally, please restart Tomcat to activate all modifications.

Start

  1. Start Tomcat
  2. Start ClassiX® InstantWeb System. This is done with a machine specific .bat file, which has to call the "WEB_START.bat" from directory %CX_ROOTDIR%\InstantWeb\<Projectname>.

    The following environment variables have to be set in the machine specific ".bat" file (e.g. <ProjektName>_WEB_START.bat):

    CX_HELPROOT
CX_ROOTDIR
CX_SYSTEM_OUT

CX_COUNTRY
CX_STATE
CX_REGION

    The variable "OS_AS_SIZE" eventually needs to be adjusted, since Java requires relatively much main storage and therefore another value might make sense for ObjectStore.
    For an exact description of the environment variable, please read the general Documentation of start batch files.
     

  3. ClassiX® InstantWeb can now be accessed via Ecterne Verknüpfunghttp://localhost:8080/InstantWeb/. 
    The URL is generally: http://<Tomcat-Server>:<Tomcat-Port>/InstantWeb/

Stop

  1. Stop the ClassiX® InstantWeb system. This happens via machine specific .bat Datei, which has to call the "WEB_STOP.bat" from the directory %CX_ROOTDIR%\InstantWeb\<projectname>.

    The following environment variable needs to be set in the machine specific ".bat" file (e.g. <ProjectName>_WEB_STOP.bat):
    CX_ROOTDIR
  2. Stop Tomcat.

     

Development

The installation of components to develop web applications with ClassiX® InstantWeb is described in detail in the InstantWeb  Technical Documentation.