CASL: Руководство Администратора
DocumentId:GradSof-CASL-r-AD-08.08.2001-1.0.0

Введение

Инсталляция

Используя бинарный дистрибутив для UNIX

Двоичный дистрибутив поставляется в двух видах:

в виде архива выполняющегося файла

• разархивировать в с помощью команды:

  \verb|gzip -d CASL-<описание платформы>-<версия>-install.sh.gz|
  

• выполнить полученный скрипт с помощью команды:

  \verb|sh CASL-<описание платформы>-<версия>-install.sh|
  

• ввести имя директории, куда вы хотите инсталлировать CASL. Заметим, что Вы должны иметь разрешение на запись в этом месте.
• Если Вы ввели имя директории <prefix>, то:
  • исполняемый файл CASL будет находиться в <prefix>/bin/
  • библиотеки CASL и GradSoft C++ ToolBox будут находиться в <prefix>/lib/
  • заголовочные файлы CASL и GradSoft C++ ToolBox будут находится в директории <prefix>/include/GradSoft/

в виде архива cpio

• Разархивировать файл с помощью команды:

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

• развернуть архив в выбранной вами директории с помощью команды:

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

Используя дистрибутив в исходных текстах

Необходимое ПО

• Компилятор C++ :
  • Для Sun Solaris: Sun CC 6.2 или выше.
  • Для Linux и FreeBSD: gcc-2.95.3
  • Для Windows NT: MSVC 6.0
• make
• Предварительно инсталлированный GradSoft-C++ ToolBox 1.5.0 или выше.
• Если вы планируете использовать CORBA и Web сервисы, то необходима ORB: TAO-1.1 или 1.2, OmniORB-3.0.3, ORBacus-4.1.0
• Для web сервисов также необходима клиентская часть ModCbroker версии 3.0.0 или выше.

Компиляция

• Развернуть архив CASL.tar.gz
• Запустить процесс конфигурации, с помощью команды:

         ./configure <configure-options>
  

• Запустить процесс компиляции с помощью команды

          gmake
  

• Запустить процесс инсталляции, с помощью команды:

          gmake install
  

Использование

В своих программных комплексах вы можете либо использовать контейнер компонент CASL, либо использовать CASL API в своих программах.

Более подробно об этом можно прочитать в "CASL: Руководство Программиста", с точки зрения администрирования важно знать:

Расположение библиотек и исполняемых файлов

• Сам контейнер компонент называется CASL и по умолчанию инсталлируется в /usr/local/bin ¹
• Библиотека libCASL.so или libCASL.dll для Windows находится в /usr/local/lib ²
• Библиотеки сервисов находяться в /usr/local/lib/CASL ³

Опции командной строки

  --log-to-file <argument>      записывать журнал в файл <argument>
  --log-to-stderr               дублировать вывод сообщений на консоль.
  --no-syslog                   не использовать syslog для вывода сообщений.
  --services-config <argument>  читать конфигурацию сервисов из файла <argument>
  --daemonize                   после инициализации перейти в режим демона.
  --help                        показать список опций командной строки.
  --config <argument>           читать опции командной строки из файла <argument>

Файл конфигурации сервисов

Собственно все, что делает CASL определяется файлом конфигурации сервисов. Это XML файл, в котором :

• Главным елементом является CASL, у которого может быть один необязательный атрибут: 'LibraryPath'. Значение этого атрибута - путь к директории библиотеки сервиса.
• 'CASL' должен содержать последовательность елементов Service, Атрибуты Service:
  • Name - имя сервиса.
  • Library - имя библиотеки сервиса без расширения (.so или .dll)
• Елемент Service, в свою очередь должен включать последовательность елементов parameter, которые, в свою очередь, должны включать в себя последовательность элементов <name> и <value> в точности, как в конфигурации J2EE Сервисов.

CASL загружает все сервисы, указанные в конфигурационном файле и запускает их.

Пример файла конфигурации:

<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) >

Перечень изменений

• 03.07.2002 - первая внешняя редакция.
• 13.12.2001 - первая внутренняя редакция.
• 08.08.2001 - создан.

Footnotes

... /usr/local/bin¹

в более общем случае: <prefix>/bin

... /usr/local/lib²

в более общем случае: <prefix>/lib

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

в более общем случае: <prefix>/lib/CASL