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

Текст может свободно распространяться с сохранением авторства. Данная версия является промежуточной и будет изменяться в дальнейшем.