Структура каталогів встановлення
Описано прийняті позначення та структуру каталогів встановлення BAS Framework у ОС Linux і Windows. Наведено розташування каталогів версій, common, conf і srvinfo та значення змінних середовища.. Прийняті позначення. Структура каталогів встановлення
Структура каталогів встановлення
Прийняті позначення
Для кращого розуміння матеріалу в цьому Посібнику прийнято загальні способи виділення окремих елементів тексту. Їх опис наведено нижче.
Позначення клавіш. Клавіші, наприклад Enter, Esc, Del, виділяються в тексті, як показано вище.
Для посилання на клавіші керування курсором (клавіші зі стрілками) використовується фраза клавіші керування курсором. Якщо потрібно вказати ці клавіші окремо, використовуються словосполучення Стрілка вгору, Стрілка вниз, Стрілка праворуч та Стрілка ліворуч.
Комбінації клавіш. Якщо для виконання певної дії потрібно натиснути комбінацію клавіш, у тексті це позначається, наприклад, як Ctrl + F3.
Позначення кнопок. Найменування кнопок у формі відображаються їхніми назвами без лапок, наприклад OK, Відмінити, Вилучити тощо.
Ключові слова вбудованої мови. Ключові слова вбудованої мови виділяються шрифтом і наводяться разом з англомовним синонімом (через «/»): WorkingDate/РабочаяДата (у програмних модулях можна використовувати один із варіантів). У тексті також траплятимуться посилання на описи розділів або елементів вбудованої мови (властивості, методи тощо). З цими описами можна ознайомитися в довідці (гілка Вбудована мова).
Опис дії за допомогою меню. Для опису вибору пункту меню використовується така конструкція: Меню – Підменю – Підменю – ... – Пункт. Наприклад: «Для вибору масштабу зображення використовується пункт Таблиця – Вид – Масштаб», що еквівалентно тексту: «Для вибору масштабу зображення використовується пункт Масштаб підменю Вид меню Таблиця головного меню програми». Якщо вибір здійснюється не з головного меню програми, це зазначається додатково.
Режими роботи системи. Система працює у двох режимах: налаштування та перевірки конфігурації (далі в Посібнику — режим Конфігуратор або конфігуратор, коли описується робота зі створення або зміни конфігурації) і виконання конфігурації (далі в Посібнику — користувацький режим).
У цьому Посібнику «користувачем» називається спеціаліст, який виконує розробку або супровід конфігурації.
Вираз A.B.C.D у контексті версії системи означає, що має використовуватися повний номер версії виду 8.3.19.1669.
Вираз %SYSTEMROOT% означає змінну середовища ОС Windows, яка містить шлях до каталогу встановлення операційної системи. Під час стандартного встановлення та налаштування ОС цей шлях має такий вигляд:
C:\Windows
Вираз %USERPROFILE% означає змінну середовища ОС Windows, яка містить шлях до каталогу профілю поточного користувача. У разі стандартного встановлення (для користувача Ivanov) цей шлях має такий вигляд:
C:\Documents and Settings\Ivanov
Для ОС Windows Vista і новіших цей шлях має такий вигляд:
C:\Users\Ivanov
Вираз %APPDATA% означає змінну середовища ОС Windows, яка містить шлях до каталогу в профілі користувача, де програми зберігають свої дані. У разі стандартного встановлення (для користувача Ivanov) цей шлях має такий вигляд:
C:\Documents and Settings\Ivanov\Application Data
Для ОС Windows Vista і новіших цей шлях має такий вигляд:
C:\Users\Ivanov\AppData\Roaming
Вираз %LOCALAPPDATA% означає змінну середовища ОС Windows Vista і новіших, яка містить шлях до каталогу в профілі користувача, де зберігаються специфічні для користувача дані програми. У разі стандартного встановлення (для користувача Ivanov) цей шлях має такий вигляд:
C:\Users\Ivanov\AppData\Local
Вираз %ALLUSERSPROFILE% означає змінну середовища ОС Windows, яка містить шлях до каталогу, доступного всім користувачам системи. У разі стандартного встановлення цей шлях має такий вигляд:
C:\Documents and Settings\All Users
Для ОС Windows Vista і новіших цей шлях має такий вигляд:
C:\ProgramData
Вираз %PROGRAMFILES% означає змінну середовища Windows, що вказує на каталог розташування програмних файлів для програм, розрядність яких збігається з розрядністю операційної системи. Під час стандартного встановлення та налаштування ОС цей шлях має такий вигляд:
C:\Program Files
Вираз %PROGRAMFILES(x86)% означає змінну середовища Windows, що вказує на каталог розташування програмних файлів для програм, розрядність яких не збігається з розрядністю операційної системи. Інакше кажучи, ця змінна середовища містить посилання на каталог розташування програмних файлів 32-розрядних програм під керуванням 64-розрядної операційної системи. Під час стандартного встановлення та налаштування ОС цей шлях має такий вигляд:
C:\Program Files (x86)
Вираз $HOME означає змінну середовища ОС Linux, яка містить шлях до каталогу профілю поточного користувача. Синонімом цієї змінної середовища є вираз ~/, вказаний у шляху до будь-чого.
Усі однойменні файли, що одночасно використовуються в ОС Windows і Linux, називаються однаково незалежно від використовуваної ОС. Так, конфігураційний файл 1cestart.cfg у Посібнику зазначатиметься саме так, але в ОС Windows він називатиметься 1CEStart.cfg, а в ОС Linux — 1cestart.cfg.
Для програмних файлів додатково не зазначається розширення, якщо воно є. Так, програмний файл 1cv8.exe згадуватиметься як 1cv8. При цьому для ОС Windows потрібно додати розширення .exe (регістр файлів не має значення), а для ОС Linux нічого додавати не потрібно.
Також слід пам’ятати, що регістр символів важливий в ОС Linux і не має значення в ОС Windows.
Структура каталогів встановлення
Загальна інформація
Після встановлення на диску буде створено певну структуру каталогів, у яких розташовані програмні файли системи. У цьому розділі описано структуру каталогів встановлення залежно від операційної системи. В іменах каталогів може використовуватися скорочення A.B.C.D, яке означає повний номер версії BAS Framework (BAF).
Для ОС Linux
Систему буде встановлено в каталог /opt/BAF (далі цей каталог називатиметься кореневим каталогом установки). У кореневому каталозі установки створюються інші каталоги та файли конфігурації:
- common – каталог містить спільні файли системи. До них належать програма встановлення драйвера ключа захисту та конфігураційний файл 1cescmn.cfg.
- conf – каталог містить конфігураційні файли, необхідні для роботи системи.
- i386 – каталог встановлення 32-розрядної версії BAF. У цьому каталозі розміщено каталоги версії, описані далі.
- x86_64 – каталог встановлення 64-розрядної версії BAF. У цьому каталозі розміщено каталоги версії, описані далі.
- У каталозі конкретної архітектури розміщено каталог виду A.B.C.D. Цей каталог містить файли конкретної версії BAF. Надалі цей каталог називатиметься каталогом версії. Повний шлях до каталогу 32-розрядної версії має такий вигляд: /opt/BAF/i386/A.B.C.D, а для 64-розрядної версії — /opt/BAF/x86_64/A.B.C.D.
Слід зазначити, що програма встановлення дозволяє одночасно встановлювати кілька версій системи. У такому разі в каталозі відповідної архітектури буде розміщено кілька каталогів версій. Так, у разі встановлення версій 8.3.18.100 та 8.3.18.150 (номери версій умовні) будуть наявні два каталоги версії з іменами 8.3.18.100 та 8.3.18.150. Кожен каталог версії містить усі файли, що входять до дистрибутиву конкретної версії, крім файлу 1cestart, а саме: програмні файли, супровідні файли, ліцензії до використовуваних програмних продуктів тощо. Каталог версії має таку структуру:
- conf – містить файли конфігурації конкретної версії або файл conf.cfg.
- distr – каталог розміщення дистрибутивів клієнтських програм.
- licenses – містить ліцензійні угоди на використовувані програмні компоненти сторонніх виробників (цей список може змінюватися від версії до версії).
- readme – цей каталог містить файли readme українською, англійською та російською мовами.
- ExtDst – містить додаткові утиліти, призначені для використання разом із системою.
Слід зазначити, що попередні версії системи, до версії 8.3.18, можна вручну розмістити у вищеописаній структурі каталогів. Для цього потрібно правильно вказати каталоги конкретних версій. Після такого розміщення програми запуску почнуть використовувати попередні версії для автоматичного підбору клієнтських програм.
Для ОС Windows
Каталог встановлення системи, що використовується за замовчуванням, залежить від вибраного режиму встановлення. Цей каталог називатиметься кореневим каталогом установки:
Установка «для комп'ютера»:
- 32-розрядна система в 64-розрядній ОС: %PROGRAMFILES(x86)%\BAF;
- в інших випадках: %PROGRAMFILES%\BAF.
Установка для користувача:
- 32-розрядна система в 32-розрядній ОС: %LOCALAPPDATA%\Programs\BAF.
- 32-розрядна система в 64-розрядній ОС: %LOCALAPPDATA%\Programs\BAF_x86.
- 64-розрядна система в 64-розрядній ОС: %LOCALAPPDATA%\Programs\BAF_x64.
У кореневому каталозі установки створюються інші каталоги та конфігураційні файли:
- common – цей каталог містить спільні файли системи. До них належать програма запуску 1cestart, програма встановлення драйвера ключа захисту, оснастка консолі керування для адміністрування кластера серверів системи (BAF Servers.msc), бібліотека піктограм файлів програм системи BAS для потреб операційної системи.
- conf – цей каталог містить конфігураційні файли, необхідні для роботи системи.
- srvinfo – робочий каталог центрального сервера. Містить дані кластера серверів у разі встановлення сервера BAF як сервісу Windows.
8.3.X.YYY – цей каталог містить файли конкретної версії BAF. Надалі цей каталог називатиметься каталогом версії. Слід зазначити, що програма встановлення дозволяє одночасно встановлювати кілька версій системи. У цьому разі в кореневому каталозі установки буде розташовано кілька каталогів версій. Так, у разі встановлення версій 8.3.3.100 і 8.3.3.150 (номери версій умовні) будуть наявні два каталоги з іменами 8.3.3.100 і 8.3.3.150. Кожен каталог версії містить усі файли, що входять до дистрибутиву конкретної версії, крім файлу 1cestart, а саме: програмні файли, супровідні файли, ліцензії до використовуваних програмних продуктів тощо. Структура каталогу версії така:
- bin – містить програмні файли версії (каталог файлів).
- bin\conf – містить конфігураційні файли конкретної версії або файл conf.cfg, який містить шлях до спільного каталогу конфігураційних файлів (за замовчуванням — каталог conf кореневого каталогу установки).
- distr – каталог розміщення дистрибутивів клієнтських програм.
- bin\dmf – містить файли, необхідні для функціонування оптимізованого механізму оновлення конфігурації бази даних.
- licenses – містить користувацькі угоди на використовувані програмні компоненти сторонніх виробників (цей список може змінюватися від версії до версії).
- readme – цей каталог містить файли readme українською, англійською та російською мовами.
Деякі каталоги під час встановлення завжди розміщуються у фіксованому місці файлової системи, незалежно від вибраного каталогу встановлення системи:
Каталоги common і conf завжди розміщуються в таких каталогах:
Установка «для комп'ютера»:
- 32-розрядна система в 64-розрядній ОС: %PROGRAMFILES(x86)%\BAF;
- в інших випадках: %PROGRAMFILES%\BAF.
Установка для «користувача»:
- 32-розрядна система в 32-розрядній ОС: %LOCALAPPDATA%\Programs\BAF.
- 32-розрядна система в 64-розрядній ОС: %LOCALAPPDATA%\Programs\BAF_x86.
- 64-розрядна система в 64-розрядній ОС: %LOCALAPPDATA%\Programs\BAF_x64.
Каталог srvinfo створюється програмою встановлення лише в разі вибору режиму запуску кластера серверів системи як сервісу ОС Windows, що можливо тільки під час установки «для комп'ютера». Тоді каталог srvinfo створюється:
- у разі однакової розрядності BAF та операційної системи – у каталозі %PROGRAMFILES%\BAF.
- у разі встановлення 32-розрядної версії BAF на 64-розрядній версії операційної системи – у каталозі %PROGRAMFILES(x86)%\BAF.