Diva distro
https://github.com/diva/d2/wiki/Installation
Инструкция по установке и конфигурации Diva Distribution
[править]УСТАНОВКА
[править]Diva Distro достаточно простой для установки бинарный дистрибутив. В отличии от «обычного» OpenSim’а нет необходимости в ручной правке конфигурационных файлов и не требуется дополнительной установки или компиляции чего-либо из исходного кода (например git, nant и т. п.).
Следуйте этим 5 шагам для установки OpenSim дистрибутива:
0. Установка Mono для OpenSim
[править][Только под linux/Unix, у пользователей Windows нет необходимости в mono]
Нет исчерпывающего набора инструкций по установке mono на Linux/Unix. Всё зависит от конкретного дистрибутива linux и под многие из них есть уже готовые инсталяторы mono которые можно найти здесь:
или обратившись в Гугл для поиска необходимых пакетов и информации от сообщества разработчиков и пользователей mono.
При этом важно иметь в виду несколько вещей:
- Для работы OpenSim необходима версия mono 2.4.3 или выше. Более старые версии mono просто не запустят OpenSim. Учитывая это положение, а также используемую операционную систему, возможно потребуется установить mono из исходного кода.
- Некоторые из наиболее свежих версий mono могут не запустить OpenSim корректно. Подобные ситуации можно исследовать в сети или проконсультироваться у других пользователей OpenSim и mono.
- Полный набор mono содержит как сам framework, так и несколько других компонентов — monodevelop, monodoc, etc., и если mono будет использоваться только для запуска OpenSim, то в них нет прямой необходимости.
Чтобы убедиться в правильности установленной версии mono следует набрать:
$ mono --version
1. Конфигурация MySQL и MySQLAdmin
[править]Скачать и установить MySQL.
Если вы в linux, то MySQL скорее всего уже установлен:
$ mysql --version
Установка и конфигурация MySQL может быть крайне лёгким или довольно тяжёлым делом, в зависимости от операционной системы и ваших навыков системного администрирования. Установка MySQL в современных версиях Windows не приносит много хлопот, а современные дистрибутивы Linux уже имеют в наличии MySQL. В сети можно найти множество документации, how-to по конфигурации и запуске демона в конкретной версии Linux. Сложности возникают при использовании старых операционных систем с устаревшим выпуском MySQL (рекомендуется использовать версию 5 или выше).
После установки, запустите MySQL сервер, и используйте командную строку для входа в mysql как пользователь root.
$ mysql -u root -p -h localhost
Если это не сработало, следует зайти через su или sudо
$ sudo mysql
Дальше,
— создаём БД с названием «opensim»:
mysql> create database opensim;
— учётную запись opensim c любым стойким паролем:
mysql> create user opensim identified by 'мой_пароль'; mysql> create user 'opensim'@'localhost' identified by 'мой_пароль';
— даём привилегии доступа к БД opensim:
mysql> grant all on opensim.* to opensim; mysql> grant all on opensim.* to 'opensim'@'localhost';
— перезагружаем все пользовательские данные для вступления в силу:
mysql> FLUSH PRIVILEGES;
ПРИМЕЧАНИЕ: 2 команды изменения привилегий доступны только для MySQL 5.
Если ваша версия ниже или они не сработали, следует ввести значения так:
mysql> use mysql; mysql> insert into user (Host, User, Password, Select_priv, Insert_priv,Update_priv,Delete_priv,Create_priv,Drop_priv, Reload_priv,Process_priv,File_priv,References_priv,Index_priv, Alter_priv) VALUES ('localhost','opensim', PASSWORD('your_password_here'), 'Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y'); mysql> FLUSH PRIVILEGES;
Решение проблем
В последующих запусках OpenSim, можно столкнуться со следующей MySQL ошибкой:
23:10:13 - =============================================================== 23:10:13 - STARTING OPENSIM 23:10:13 - =============================================================== 23:10:13 - [OPENSIM MAIN]: Running in sandbox mode 23:10:13 - [DATASTORE]: Attempting to load OpenSim.Data.MySQL.dll 23:10:13 - [REGION DB]: MySql - connecting: Data Source=localhost;Database=opensim; User ID=opensim;Password=***; 23:10:13 - [APPLICATION]: APPLICATION EXCEPTION DETECTED: System.UnhandledExceptionEventArgs Exception: MySql.Data.MySqlClient.MySqlException: Access denied for user 'opensim'@'localhost' (using password: YES)
Подобные ошибки указывают на неточность в локальных установках MySQL и это легко проверить:
$ mysql -u opensim -p -h localhost
Если не удаётся залогиниться к серверу этим способом, OpenSim тоже не получит доступ. Зайдите в mysql под root и убедитесь что учётная запись opensim активна для localhost.
mysql> use mysql; mysql> select Host, User from user;
Создайте ещё необходимые учётные записи 'opensim_аккаунт' @ 'имя_хоста'.
2. Конфигурация DNS
[править]Эта инструкция критична для тех, кто будет запускать вьюверы в той же приватной сети где работает OpenSim, — например своей домашней сети. Если же это не ваш случай вы можете просто принять её к сведению, убедившись что все значимые порты открыты для доступа.
Межсетевой экран и перенаправление портов
Первое что нужно сделать это открыть порты на рабочей станции с OpenSim:
TCP port 9000 UDP ports 9000, 9001, 9002, 9003
Дальше, установить перенаправление c портов на свой маршрутизатор так, чтобы весь трафик TCP 9000 и UDP 9000-9003 направить на машину с OpenSim. Если вы не знаете как это сделать, рекомендуется обратиться в Гугл
или на этот сайт http://portforward.com/.
Доменное имя
Для работы в OpenSim, рекомендуется использовать доменные имена вместо IP адресов. Это даёт необходимый уровень абстракции изолирующий от многих ошибок и заморочек с маршрутизатором. Особенно с новым Hypergrid 1.5 и его политикой безопасности, использование IP адресов в конкретной домашней сети может помешать вам использовать Hypergird.
Доменные имена крайне легко приобрести и сконфигурировать. Вы можете купить своё собственное через поставщиков или получить бесплатно на http://dyndns.com
NAT
Многие домашние маршрутизаторы не способны направить трафик изнутри сети к внешнему доменному имени или IP адресу маршрутизатора. Если это ваш случай сделайте следующее:
На каждом компьютере вашей приватной сети где работают вьюверы, нужно предоставить передачу DNS напрямую. Для этого следует добавить необходимые записи в hosts файл, который есть во всех операционных системах.
см. http://ru.wikipedia.org/wiki/Hosts чтобы узнать где он находиться и как его править (привилегия root).
Добавить запись в hosts которая выглядит примерно так:
OpenSim_local_IP your_domain_name
Под OpenSim_local_IP понимается местный сетевой IP адрес компьютера где выполняется OpenSim.
Его всегда можно узнать набрав в консоли 'ipconfig' (Windows) или 'ifconfig' (*ix).
К примеру, для автора этого мануала он выглядел следующим образом на одном из ноутбуков:
192.168.1.105 divacanto.dyndns.org
Этот IP выдал домашний маршрутизатор для настольного компьютера где работает OpenSim. На этом же десктопе выполняется вьювер и адрес 192.168.1.105 также сработал бы, однако в этом конкретном случае он установлен так:
127.0.0.1 divacanto.dyndns.org
И если у вас запущен OpenSim и вьювер на одной машине, рекомендуется использовать последний вариант (127.0.0.1), так как не имеет особого смысла его менять.
ВАЖНО
Если машине где работает OpenSim будет присвоен новый внутренний IP адрес, следует обновить содержимое hosts файла; текущие настройки DNS (dyndns или другое) и перезапустить OpenSim.
3. Настройка и кастомизация Wifi
[править]Wifi это свободное к установке Web приложение разработанное под дистрибутив Diva. Следуйте этой иструкции для его конфигурации.
Особенности:
- создание учетной записи контролируемой администратором
- конфигурируемый начальный аватар для новых аккаунтов
- обновления профилей у пользователей и администратора
- удаление аккаунта администратором
- восстановление пароля по электронной почте
- управление инвентарём пользователя
В дистрибутиве Diva, Wifi помещён непосредственно в сам симулятор и запускается совместно с ним по URL:
http://ваше_доменное_имя:9000/wifi
Процесс конфигурации проходит через несколько простых вопросов по Wifi, указания имени, пароля и email администратора, будет ли аккаунт контролироваться вами или нет, и параметров Gmail почты для отправки уведомлений пользователям.
Контролируемые и неконтролируемые учетные записи
Wifi может создавать новые аккаунты в двумя способами — контролируемым и не контролируемым.
Если выбраны контролируемые учётные записи, каждый раз когда кто-либо создаёт аккаунт, администратор Wifi получает письмо (указан корректный email адрес) уведомляющее об этом событии. В этом случае следует зайти в Wifi как администратор и выбрать раздел «USER MANAGEMENT». Этот раздел управления пользователями представлен списком аккаунтов ожидающих подтверждения или удаления.
В случае с неконтролируемым созданием аккаунтов любой пользователь имеет возможность зарегистрироваться в мире без вашего подтверждения.
Аватары по умолчанию
При регистрации пользователей у них имеется возможность выбора между 3 аватарами: мужской, женский и нейтральный. Отредактировать эту опцию и внешний вид аватаров можно следующим образом:
Когда OpenSim настроен и запущен, создать используя Wifi, 3 аккаунта с именами:
Male Avatar Female Avatar Neutral Avatar
После зайти в мир под каждым из этих аккаунтов, и отредактировать их внешность на ваше усмотрение с учетом возможности прикрепления примов. С этого момента все аватары новых регистрируемых аккаунтов получат копии содержимого внешнего вида.
SMTP
По умолчанию Wifi отправляет письма через защищенный сервер SMTP Gmail’а. Если вы хотите придерживаться этой установки, получите отдельный Gmail аккаунт перед запуском приложения конфигурации. Установки SMTP и почтового адреса всегда можно изменить в конфигурационном файле
config-include/MyWorld.ini
SSL под Mono
[Только для пользователей *ix, если используется Windows игнорируйте этот раздел]
SSL сертификаты нужны для отправки писем через Gmail. К сожалению, для некоторых версий Mono возможны дополнительные трудности относительно SSL.
Перед запуском OpenSim необходимо импортировать сертификаты SSL следующим образом:
$ mozroots --import --ask-remove $ certmgr -ssl smtps://smtp.gmail.com:465 (ответить 'Yes' на все вопросы)
Если окажется что Wifi не посылает письма — не защищенный email на 25 порту не требует SSL и будет работать в любом случае.
Редактирование Wifi
Вы можете спокойно править следующие html файлы в директории WifiPages:
- splash.html
- header.html
- footer.html
- welcome.html
- links.html
и добавить новые изображения в папку images. Изменения в других файлах могут вызвать неработоспособность Wifi.
Дополнительная конфигурация аватаров
Wifi может поддерживать более чем 3 типа аватаров по умолчанию (Male, Female, Neutral) и вы можете создать любое число начальных аватаров и их типов. Чтобы сделать это измените файл MyWorld.ini, добавляя в секцию [WifiService] необходимые типы:
AvatarAccount_ = " "
Пользователи увидят эту опцию на странице регистрации. Дальше будет необходимо создать специальный аккаунт под этот новый тип и отредактировать его внешность.
Локализация
см. https://github.com/diva/d2/wiki/Wifi (Localization)
html страницы русской локализации Wifi находятся в папке WifiPages/ru/ каталога дистрибутива.
4. Configure.exe
[править]Перейти в директорию bin и запустить приложение Configure.exe
команда в Linux:
$ mono Configure.exe
После чего ответить на несколько вопросов программы.
— для изменения ответов запустить её заново.
— Configure.exe правит bin/config-incude/MyWorld.ini который всегда можно отредактировать и вручную.
5. OpenSim.exe
[править]Запустить OpenSim.exe из директории bin.
— для 64-bit открыть соответственно OpenSim.32BitLaunch.exe.
в linux:
$ mono OpenSim.exe
Ответить на вопросы первого пуска opensim сервера.
см. примеры ответов: https://github.com/diva/d2/wiki/OpenSim-Questions
Набор консольных команд и их описание можно посмотреть набрав «help» или c сайта OpenSim’а.
Например, для создания плоской поверхности земли следует ввести:
# terrain fill 21
для завершения работы OpenSim:
# shutdown
ОБНОВЛЕНИЕ
[править]Для того, чтобы обновить ваш виртуальный мир до новейшей версии Diva Distro достаточно запустить Update.exe, после чего вырубить старый OpenSim.exe и запустить OpenSim.exe из нового выпуска.
Примечания
[править]Для расширенных вариантов конфигурации,
см. https://github.com/diva/d2/wiki/Advanced
и https://github.com/diva/d2/wiki/Troubleshooting для решения возможных проблем.
Copyleft (l) Rodion Rotaru
[править]Copyleft (l) Rodion Rotaru
Текст может свободно распространяться с сохранением авторства. Данная версия является промежуточной и будет изменяться в дальнейшем.