Руководство по установке и эксплуатации
Credit Registry
Москва
2006г.
Содержание
О программе Credit Registry 3
Требования для установки программы 3
Пользователи системы. Права пользователей 3
Инсталляция системы 4
Типичные ошибки при установке и обновлении программы. 6
Запуск программы. Интерфейс 7
Описание директорий импорта. 7
Рекомендации по эксплуатации. 7
О программе Credit Registry
Программа предназначена для сбора, хранения и передачи данных о кредитных историях в Национальное Бюро Кредитных Историй (НБКИ). Данные, вручную или автоматически введенные в Credit Registry, экспортируются в виде файла формата TUTDF (являющегося стандартом НБКИ для передачи данных о кредитных историях) за период и в сроки, определенные правилами НБКИ.
Программа позволяет хранить неограниченное количество кредитных историй по одному субъекту и поддерживает многопользовательский режим.
Credit Registry может также использоваться для проверки самостоятельно созданных файлов на соответствие формату TUTDF перед их отправкой в НБКИ.
Требования для установки программы
На сервере программы должны быть установлены:
MS Windows 2000 или XP;
Java Runtime Environment 1.5 (бесплатно, входит в установочный комплект);
TomCat 5.9.9 (бесплатно, входит в установочный комплект);
-
База данных: MSDE 2000 (бесплатно, входит в установочный комплект), можно использовать MS SQL Server 2000 или более поздняя версия MS SQL.
CryptoPro CSP 3.0 – программный продукт необходимый для использования https-соединения с НБКИ, для передачи запросов и получения отчетов о кредитных историях (приобретается у компании КриптоПро).
Технические требования к оборудованию сервера:
Процессор P 3 – 1 ГГц, RAM от 512 Мб , HDD в зависимости от размера базы данных
На компьютере пользователя должны быть установлены:
Любой современный веб-браузер;
-
Доступ к серверу по http-протоколу.
База данных MS SQL и TomCat 5.9.9 могут быть разнесены и находиться на разных компьютерах. TomCat 5.9.9 по сути является web-сервером, приложение которого будет взаимодействовать с MS SQL.
Пользователи системы. Права пользователей
К пользователям системы относятся:
Администратор («Администратор»);
Служащий банка («Пользователь»).
Термины:
Субъекты - физические и юридические лица, являющиеся субъектами кредитной истории.
Участник НБКИ – организация, передающая НБКИ кредитные истории своих клиентов.
Код участника НБКИ - идентификатор, полученный участником в НБКИ.
Функции и права Администратора:
Ввод, редактирование и удаление данных Кода участника НБКИ;
Добавление нового Пользователя в систему:
назначение Пользователю имени и пароля для входа в программу;
назначение Пользователю Кода участника НБКИ для фиксации принадлежности Пользователя к организации-участнику НБКИ (или его подразделению).
Просмотр, редактирование и удаление данных Пользователя;
Лицензирование программы: ввод файла-лицензии для разрешения работы с программой.
Функции и права Пользователя:
Добавление новых субъектов в базу данных программы;
Ввод данных о кредитной истории субъекта, их просмотр, редактирование и удаление;
Поиск субъекта;
Экспорт данных в формате TUTDF;
Проверка файлов на соответствие формату TUTDF перед их отправкой в НБКИ.
Инсталляция системы
Установка JRE
Для установки JRE запустите jre-1_5_0_04-windows-i586-p.exe. Подтвердите значения параметров, предложенных по умолчанию. JRE должен быть установлен на тот же компьютер, куда будет устанавливаться Tomcat. Следует быть внимательным к ранее установленным версиям java. Если на ПК установлена более ранняя версия java, то рекомендуется ее удалить перед установкой jre-1_5_0_04-windows-i586-p.exe. После установки JRE требуется перезагрузить компьютер, несмотря на то, что в некоторых ОС предупреждение о необходимости перезагрузки не отображается.
Установка Базы данных
Распаковать MSDN-Setup.zip.
Запустить setup.bat (параметры инсталляции можно задать в файле setup-tutdf.ini, обычно это не требуется).
Запустить файл msde_1433.reg из папки MSDE дистрибутива и согласиться с изменениями (настраивает MSDE на порт 1433; если порт уже используется, то будет необходимо настроить create_db и приложение на новый порт).
Запустить сервис MSSQL$TUTDF.
Распаковать create_db.zip. Запустить файл create_db.bat (параметры можно настроить в файле db.properties, обычно это не требуется).
При использовании существующего SQL Server необходимо:
Разрешить доступ к БД по протоколу TCP/IP.
Распаковать create_db.zip. Запустить файл create_db.bat из дистрибутива, задав адрес, порт, имя/пароль администратора в файле db.properties
Установка Tomcat
Для установки Tomcat запустить jakarta-tomcat-5.5.9.exe и примите предложенные параметры установки .
Убедиться в том, что заведен администратор для Tomcat – в файл C:\Program Files\Apache Software Foundation\Tomcat 5.5\conf\tomcat-users.xml в конце раздела
(перед строкой ) должна быть строка:
Установка Credit Registry
Запустить Tomcat.
Зайти на корневую страницу Tomcat (например – http://localhost:8080/).
Перейти по ссылке Tomcat Manager используя имя и пароль администратора Tomcat.
В форме “WAR file to deploy” указать путь к файлу credit_registry.war из дистрибутива, нажать кнопку “Deploy”, после установки в списке web-приложений появится “Credit Registry”.
-
Если база данных размещается на другом сервере или используется нестандартное имя базы или имя, то следует отредактировать файл C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps\credit_registry\WEB-INF\classes\hibernate.cfg.xml:
соединение с базой данных ( jdbc:jtds:sqlserver://address:port/database )
jdbc:jtds:sqlserver://127.0.0.1:1433/TUTDF
имя и пароль пользователя базы данных
tutdf
tutdf
размер пула соединений с базой, рекомендуется не более 5 для MSDE, в остальных случаях можно по необходимости увеличить число соединений в пуле 5
Зайти в приложение Credit Registry (http://localhost:8080/credit_registry), первый вход в приложение может длиться некоторое время, так как будут заполняться справочники системы и будет заведена учетная запись администратора Credit Registry ( admin:admin ).
Установка и настройка шлюза поддержки SSL для CreditRegistry
1. Войти в систему с правами администратора.
2. Установить на компьютер CryptoPro CSP 3.0 или CryptoPro CSP + TLS версии 2.х (не в ходит в дистрибутив, приобретается отдельно).
3. Установить в системное (машинное) хранилище сертификатов в "Trusted Root CA"
сертификат «УЦ KPИПTO-ПPO»
4. Для запуска SSLGate как сервиса - установить в системное (машинное)
хранилище сертификатов в "Trusted People" сертификат веб сервера НБКИ "icrs.nbki.ru".
Для запуска SSLGate под учетной записью пользователя необходимо установить
эти сертификаты в хранилища для данного пользователя
5. <�Открыть> на компьютере TCP порт 10443
6. Зарегистрировать SSLGate как сервис, из командной строки выполнить
"SSLGate.exe -install", далее запускать и останавливать этот сервис можно как и
любой другой сервис Windows. SSLGate сервис будет зарегистрирован как "CreditRegistry SSLGate".
Для удаления SSLGate из списка сервисов необходимо остановить
сервис и выполнить команду "SSLGate.exe -remove".
7. Для запуска SSLGate под учетной записью пользователя можно использовать команду "SSLGate.exe -debug"
Если при установке программы возникают ошибки см. раздел Типичные ошибки при установке и обновлении программы.
Установка лицензии
Запустить приложение Credit Registry (см. Типичные ошибки при установке и обновлении программы.) и войти с административными правами (логин admin, пароль admin).
Выбрать пункт меню Лицензия (сверху справа на странице).
Нажать на кнопку Обзор и выбрать в окне «Выбор файла» имя файла с лицензией.
Нажать на кнопку Установить.
Установка обновлений и новых версий программы
Чтобы установить новую версию credit_registry.war зайдите в Tomcat Manager, выполните Undeploy приложения credit_registry, затем Deploy, как при обычной установке. Если менялись настройки в hibernate.cfg.xml, то их нужно произвести ещё раз. После изменения настроек в hibernate.cfg.xml, необходимо выполнить Stop/Start приложения credit_registry в Tomcat Manager.
Возможные проблемы при установке:
Иногда Tomcat не может полностью удалить приложение, тогда нужно остановить Tomcat и вручную стереть папку C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps\credit_registry и там же файл credit_registry.war (если Tomcat установлен под Windows на диск C:\).
Если не очищается кэш страниц, следует удалить папку C:\Program Files\Apache Software Foundation\Tomcat 5.5\work\Catalina\localhost\credit_registry. Для проверки посмотрите, соответствует ли версия программы на странице «Лицензия» установленной версии.
Если после обновления версии появляется окно с указанием обновить Базу данных, то следует запустить свежую версию утилиты create_db (с теми же настройками в файле db.properties, что и при установке; обычно менять настройки не требуется). При этом существующая База будет обновлена до текущей версии программы. При отсутствии Базы утилита создает новую. После обновления следует выполнить Stop/Start приложения в Tomcat Manager. Начиная с 5ой версии программы Credit Registry, обновления базы данных происходит из web – интерфейса (без использования утилиты create_db). После установки credit_registry.war, пройдите по ссылке credit_registry из списка Applications. Вам будет предложено ввести пароль администратора и нажать «OK», для обновления базы данных.
Типичные ошибки при установке и обновлении программы.
1. При запуске утилиты create_db возникает сообщение об ошибке “connection refused” (см. Рис.1). Нет соединения с MS SQL. Причины: Не запущен SQL сервер. В файле db_properties (находиться в той же папке где и create_db) введены не верные параметры соединения с MS SQL (ip-адрес, порт SQL сервера). Программа типа firewall блокирует соединение.
Рис. 1
2. При попытке зайти в программу Credit Registry из браузера или из TomCat Manager возникает сообщение об ошибке “connection refused” (см. Рис.2). Нет соединения с MS SQL. Причины: Не запущен SQL сервер. В файле C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps\credit_registry\WEB-INF\classes\hibernate.cfg.xml введены не верные параметры соединения с MS SQL, а именно: ip-адрес, порт SQL сервера. Программа типа firewall блокирует соединение. Необходимо помнить, что при изменении параметров в файле hibernate.cfg.xml, необходимо выполнить Stop/Start приложения Credit_Registry в списке приложений в TomCat Manager.
Рис. 2
3. При попытке запустить create_db возникает ошибка: “java.lang.UnsupportedClassVersionError: ” (см. рис.3). Причины: на компьютере установлена старая версия java (Необходимо удалить старую версию и поставить новую из дистрибутива). На ряду с новой установленной версией из дистрибутива на компьютере установлена другая версия java, которую нельзя удалять (Прописать в файле create_db вместо последней строки: @java -jar create_db.jar %1 строку следующего содержания: "C:\Program Files\Java\jre1.5.0_06\bin\java" -jar create_db.jar %1 ). В случае обновления базы данных из web – интерфейса Credit Registry следует убедиться, что путь к нужной версии java (пример: C:\Program Files\Java\jre1.5.0_06\bin\client\jvm.dll) прописан на закладке java в Configure TomCat в Program Files.
Рис. 3
Запуск программы. Интерфейс
Наберите в строке браузера адрес сайта:
В общем случае
http://<�адрес_машины сервера_Credit_Registry>:8080/credit_registry
Если программа используется на компьютере, где установлен сервер, то адрес сайта http://localhost:8080/credit_registry
На первой странице сайта для авторизации введите имя и пароль, который ранее установил для Пользователя Администратор программы. Администратор может войти в систему под именем и паролем, заданными во время инсталляции системы (по умолчанию admin:admin).
Все страницы сайта в первой строке содержат меню (см. Рис. 4).
Рис. 4
Для работы Администратора предназначены пункты меню: Администрирование, Лицензия и Журналы.
Для работы Пользователя программы пункты меню: Субъекты, Экспорт, Проверка, Журналы. При выборе пункта меню Лицензия, Пользователь получает возможность видеть: до какого срока действительна лицензия, какая версия программы и Базы данных установлена, какие функции программы доступны.
Название окон программы отражается в названии окон браузера.
Описание директорий импорта.
1. Путь к директориям импорта XML данных можно указать на странице Администрирование в разделе “Редактирование параметров”, нажав кнопку “Редактировать” напротив названия раздела. В строке ввода папка импорта укажите путь к директории (списку директорий), из которой будет производиться импорт XML файлов. В случае указания списка директорий следует учесть, что для Windows разделителем является символ ";", а для Unix ":". Загрузка всех файлов из директории осуществляется за один проход
(в алфавитном порядке по именам файлов).
2. Папка импорта reject фалов должна содержать файлы - ticket , полученные из НБКИ. В случае если к файлу- ticket прилагался reject-файл, то в данную папку должны быть помещены оба файла. Если файл-ticket успешно обработан, то файлу присваивается расширение .processed. В случае неудачной обработки, файлу будет присвоено расширение .interupted.
Рекомендации по эксплуатации.
1. Apache TomCat сохраняет логии ошибок своих приложений в папку C:\Program Files\Apache Software Foundation\Tomcat 5.5\logs. При длительной работе TomCat следует следить за размером этой папки во избежание уменьшения объема свободного места на жестком диске. В случае наступления ошибок, путь решения которых не может быть определен, следует заархивировать логии с текущей датой и выслать их на электронный адрес support@mbtc.ru с подробным описанием возникшей ошибки.
2. Для обеспечения отказоустойчивости рекомендуется регулярно производить бэкап базы данных TUTDF. Так же перед обновлением базы данных (в случае установки новых версий БД), несмотря на то, что данные в базе сохраняются, настоятельно рекомендуется производить бэкап базы данных TUTDF. При этом можно использовать средства MSSQL (Enterprise manager). Бэкап следует производить в момент, когда не осуществляется импорт или экспорт данных в базу данных.
3. Программный комплекс Credit Registry может функционировать в беспрерывном режиме. Но для проведения работ, связанных с обновлением Credit Registry и (или) произведения резервного копирования БД, следует учесть, что некоторые необходимые для работы Credit Registry службы, требуют перезапуска. При перезапуске служб, отвечающих за работу Credit Registry, доступ пользователей к функциональным меню программы невозможен.
4. Для проверки работоспособности системы следует осуществлять мониторинг следующих служб:
- Apache Tomcat
- MSSQL$TUTDF или соответствующую службу MSSQL, при использовании в качестве SQL сервера MSSQL.
- В TomCat manager, в списке applications приложение credit_registry должно иметь статус Running – true.
|