CASL: Administration Guide
DocumentId:GradSof-CASL-r-AD-08.08.2001-1.0.0

Installation

Using Binary Distributive

Binary distributive is supplied in two forms:

in form of executable file archive

• ungzip with the help of command:

  \verb|gzip -d CASL-<platform description>-<version>-install.sh.gz|
  

• execute obtained script by command:

  \verb|sh CASL-<platform description>-<version>-install.sh|
  

• input directory name, where you want to install CASL. Notice, you need to have write permission for the directory.
• If you choose directory name <prefix>, then:
  • CASL executable file will be in <prefix>/bin/
  • CASL and GradSoft C++ ToolBox libraries will be in <prefix>/lib/
  • CASL and GradSoft C++ ToolBox headers in <prefix>/include/GradSoft/

in the form of cpio archive

• Ungzip file with the help of command:

  gzip -d CASL-<platform>-<version>.cpio.gz
  

• unfold archive in preferred directory by command:

  cat CASL-<platform>-<version>.cpio | (cd $prefix; cpio -p )
  

Using Source Code Distributive

Necesary Software

• C++ Compiler:
  • For Sun Solaris: Sun CC 6.2 or higher.
  • For Linux and FreeBSD: gcc-2.95.3
  • For Windows NT: MSVC 6.0
• make
• Installed GradSoft-C++ ToolBox 1.5.0 or higher.
• If you plan to use CORBA and Web services, then you need ORB: TAO-1.1 or 1.2, OmniORB-3.0.3, ORBacus-4.1.0
• For web services you also need client ModCbroker part version 3.0.0 or higher.

Compilation

• Untar archive CASL.tar.gz
• Start configuration process, with the help of command:

         ./configure <configure-options>
  

• Start compilation process with the help of command:

          gmake
  

• Start installation process, via command:

          gmake install
  

Using

You can use CASL component container in your program complexes, or use CASL API in your programs.

For details please refer to "CASL: Programming Guide", for the administration it's important to know:

Executables and shared libraries location

• Component container is called CASL and by default is installed into /usr/local/bin ¹
• Shared library libCASL.so or libCASL.dll for Windows is situated in /usr/local/lib ²
• Services shared libraries are located in /usr/local/lib/CASL ³

Command line options

  --log-to-file <argument>      log output to file <argument>.
  --log-to-stderr               duplicate messages output to console.
  --no-syslog                   disable syslog output.
  --services-config <argument>  read services configuration from file <argument>.
  --daemonize                   daemonize after initialization.
  --help                        show command line options list.
  --config <argument>           read options from specified file <argument>

Services configuration file

Services configuration stored in XML file, where :

• Main element is CASL, which may have one optional attribute: 'LibraryPath'. The attribute value is the path to service library directory.
• 'CASL' should contain Service elements sequence. Service attributes:
  • Name - service name.
  • Library - service shared library name without extension (.so or .dll)
• Service element, should contain parameter elements sequence, that in their turn , should include <name> and <value> elements sequence exactly as in J2EE Services configuration.

CASL loads all services, listed in configuration file and starts them.

Configuration file example:

<CASL>
<Service Name="PIInclude1" Library="libPIInclude1">
  <parameter>
    <name> InputFile </name>
    <value> input.xml </value>
  </parameter>
  <parameter>
    <name> OutputFile </name>
    <value> output.xml </value>
  </parameter>
</Service>
<Service Name="CORBA" Library="libCASL_CORBA_TAO">
  <parameter>
   <name> ORBargs </name>
   <value> 
       -ORBInitRef NameService=corbaloc::localhost:1234/NameService 
   </value>
  </parameter>
</Service>
<Service Name="MyThirdService" Library="libMy3" >
  <parameter>
    <name> n1 </name> <value> v1 </value>
  </parameter>
  <parameter>
    <name> n2 </name> <value> v2 </value>
  </parameter>
</Service>
</CASL>

XML DTD

<!ELEMENT CASL  (Service+ )>
<!ATTLIST CASL  LibraryPath   CDATA #IMPLIED >

<!ELEMENT Service  (parameter*)>
<!ATTLIST Service  Name CDATA  #REQUIRED
                   Library   CDATA  #REQUIRED >

<!ELEMENT parameter  ((name, value)* )>

<!ELEMENT name (#PCDATA) >
<!ELEMENT value (#PCDATA) >

Changes list

• 02.09.2002 - preview release.
• 17.12.2001 - first internal edition.

Footnotes

... /usr/local/bin¹

in more general case: <prefix>/bin

... /usr/local/lib²

more general: <prefix>/lib

... /usr/local/lib/CASL³

more general: <prefix>/lib/CASL