UAKGQuery: Руководство администратора

31/01/2001

DocumentID: GradSoft-UAKGQuery-AG503-79-19.09.2000-1.7

Contents

• Contents
• Введение
• Компиляция
  • Необходимое ПО
  • Процесс компиляции/инсталляции
• Использование
  • Запуск сервера
  • Запуск клиента UAKGQueryService
• Запись изменений

Введение

UAKGQuery - модуль предназначенный для работы с реляционными БД ( в данный момент поддерживает работу с сервером Oracle и InterBase).

Используя UAKGQuery можно организовать эффективный и однородный доступ к данным из разных источников, вне зависимости от их расположения и архитектурных ограничений БД.

Компиляция

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

Для Windows NT

• ORB - ORBacus-4.0 или выше
• Компилятор C++ Microsoft Visual C версии 6.0 или выше.
• клиентская часть Oracle 8.1.5 или выше (для компиляции серверной части с поддержкой Oracle)
• клиентская часть InterBase 6 или выше (для компиляции серверной части с поддержкой Interbase)
• Предварительно установленный GradC++ ToolBox версии 1.4.0 или выше.

Для Unix

• ORB - один из
  • ORBacus-4.0 или выше,
  • TAO-1.1, TAO-1.2
• Компилятор C++ : gcc-2.95.2 или SunProc CC 6.2
• клиентская часть Oracle 8.1.5 или выше (для компиляции серверной части с поддержкой Oracle)
• клиентская часть InterBase 6 или выше (для компиляции серверной части с поддержкой Interbase)
• Предварительно установленный GradSoft C++ ToolBox версии 1.4.0 или выше.

Опция поддержки сервиса транзакций

Для поддержки сервиса транзакций необходим ORbacus Tranzaction Service и соответственно, совместимая с ним ORB

Внимание: под Windows NT транзакции не поддерживаются.

Процесс компиляции/инсталляции

Для Windows NT

1. Развернуть архив UAKGQuery-1.1.0.tar.gz
2. Перейти в образовавшуюся директорию CosQuery.1 (далее - корневой каталог проекта)
3. Установить в файле env_inc.nt.mak следующие переменные:
   • PROJECT_ROOT - корневой каталог проекта
   • ORB_DIR - директория, куда проинсталирован ORBACUS
   • OCI_HOME - директория, куда проинсталирован Oracle Call Interface (раскомментировать строчку HAVE_ORACLE=1)
   • IBASE_HOME - директория, куда проинсталирован Interbase (раскомментировать строчку HAVE_INTERBASE=1)
   • MSVC_HOME - директория, где находится MS Visual C++
   • INSTALL_DIR - абсолютный путь к целевой директории инсталляциии (внимание, в нем уже должна находиться инсталляция C++ ToolBox)
4. Зайти в директорию CosQuery.1
5. Запустить компиляцию:
   • для сервера запустив make.bat
   • для клиента запустив make.bat client
6. Запустить инсталляцию
   • для сервера запустив make.bat install
   • для клиента запустив make.bat install-client

Для Unix

1. Развернуть архив UAKGQuery-1.1.0.tar.gz
2. Перейти в образовавшуюся директорию CosQuery.1
3. Запустить ./configure, при необходимости указав опции конфигурирования.
   • --with-ob-xa - если вы хотите использовать XA механизм транзакций.
   • --with-ots - если вы хотите использовать CORBA Transaction Service.
   • --toolbox=<toolbox-prefix> - если ваш GradSoft C++ ToolBox установлен не в /usr/local
   • corbaconf (http://corbaconf.kiev.ua) опции для определения ORB.
4. Запустить компиляцию:
   • для сервера запустив gmake
   • для клиента запустив gmake client-stub-library
5. Запустить инсталляцию
   • для сервера запустив make install
   • для клиента запустив make install-client-stub-linrary

Состав инсталляции

В результате инсталляции следующие файлы будут переписаны:

1. Куда:
   - в подкаталоги idl, include и lib "каталога инсталляции". Имя этого каталога определяется путем редактирования переменной INSTALL_DIR в Makefile.nt для Windows NT (см. раздел 2.2.1) либо при помощи опции configure --prefix для UNIX (см. раздел 2.2.2).

2. Что:
   1. idl-модули, в составе:
      CosQuery.idl
      CosQueryCollection.idl
      CosQueryIDLConfig.idl
      CosQueryIDLConfigV2.idl
      RC.idl
      UAKGQuery.idl
      - в подкаталог idl
   2. заголовочные файлы стабов и скелетонов, полученные в результате трансляции idl-модуей
      - в подкаталог include
   3. заголовочные файлы
      DecimalAccess.h
      FieldDescriptionAccess.h
      FieldValueAccess.h
      RecordAccess.h
      RecordDescriptionAccess.h
      - в подкаталог include/CosQueryFacade
   4. библиотека UAKGQueryClient.lib (для Windows NT) либо libUAKGQueryClient.a (для UNIX)
      - в подкаталог lib

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

Запуск сервера

При запуске серера ему необходимо указать порт приема запросов.

Эту опцию можно установить либо при помощи командной строки, либо в свойствах ORB, проконсультируйтесь с документацией по вашему CORBA брокеру.

Что касается командной строки, то:

• для ORBacus это опция -OAport <port> либо свойство ooc.iiop.port в свойствах конфигурации.
• для OmniORB это опция -ORBpoa_iiop_port <port>
• для TAO-1.1 это опция -ORBport <port>
• для TAO-1.2 это опция -ORBEndPoint iiop://:<port>

Обязательным для успешного запуска сервера является наличие инсталлированных соответствующих клиентов СУБД в работающем окружении.

Вывод сообщений об ошибках

На UNIX платформах UAKGQuery использует стандартный syslog интерфейс для записи сообщений об ошибках. Для настройки вывода syslog проконсультируйтесь с документацией на вашу операционную систему (man syslog), следуйщий алгоритм будет работать для большинства поддерживаемых UNIX систем:

• Добавьте в файл /etc/syslog.conf строчки:

  !UAKGQueryService
  *.*			/var/log/UAKGQuery.log
  # in addition, call admin on fatal errors
  *.fatal			|mail -s "UAKGQuery fatal" admin@his.cell.phone.kiev.ua
  

• Создайте пустой файл /var/log/UAKGQuery.log

В дополнение к этому вы можете продублировать вывод лог-вывод в файл средствами UAKGQueryService (см. опции командной строки)

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

• ORB параметры (как указанно в документации к вашей ORB)
• --ORACLE_XA <xa_string> - использовать XA транзакции Oracle. Эта опция доступна только под UNIX в том случае, если сервер был откомпилирован с поддержкой XA транзакций.
• --ior-file-UAKGQueryService <fname> - записать ior QueryService в файл с именем fname.
• --ior-stdout - вывести ior QueryService на стандартный вывод.
• --with-naming - зарегестрировать UAKGQueryService в CORBA Naming Service (переменные Naming должны быть установлены).
• --config <fname> - прочитать конфигурацию из файла с именем fname.
• --log-to-file <fname> - записывать лог-вывод в файл fname.
• --log-to-stderr - выводить лог-вывод в стандартный поток ошибок программы.
• --log-sql - генерировать info-лог с текстом обрабатываемых SQL предложений. Эта опция полезна при отладке вашего приложения.
• --no-syslog - не генерировать syslog сообщения. (UNIX).

Запуск клиента UAKGQueryService

При запуске клиента, передайте ORB следующие параметры

-ORBInitRef UAKGQueryService=\
            corbaloc::srv-host-name:port/DefaultConnectionManager

где:

• srv-host-name - IP адрес машины, на которой запущен сервер.
• port - порт, по которому принимает запросы UAKGQueryService

Запись изменений

1. 24.01.2002 -
   1. описание порядка инсталляции пакета под Windows NT приведено в соответствие с реальностью
   2. указано, что транзакции под Windows NT не поддерживаются
2. 18.01.2002 - коррекция требуемых версий необходимого ПО для UAKGQuery 1.1.0
3. 05.07.2001 - отражено требование о версии GradSoft C++ ToolBox, добавлен раздел о журналировании.
4. 26.04.2001 - коррекция описания установки на Windows NT.
5. 31.01.2001 - коррекция незначительных ошибок.
6. 03.11.2000 - уточнения
7. 31.10.2000 - добавление информации о транзакциях.
8. 19.09.2000 - создание.