Установка p2p-сервера verlihub

[Мандрагора]

Сейчас у меня FreeBSD 6.3 BETA2, но и на 6.2 хаб вставал и работал без проблем.

Ставим сервер из портов:

cd /usr/ports/net-p2p/verlihub/
make install clean
Устанавливается без ошибок и прочих проблем.
Для работы хаба нужен запущенный сервер баз данных MySQL. Как его поставить и настроить уже много написано. Ставим, запускаем и проверяем

//> /usr/local/etc/rc.d/mysql-server status
mysql is running as pid 48383.
или вот так:

/usr/MY/> ps -aux | grep mysql
mysql 22262 0,0 0,2 5180 4696 p1- IN 18:38 0:00,10 /usr/local/libexec/
mysql 48349 0,0 0,1 1748 1272 p1- I 17:22 0:00,01 /bin/sh /usr/local/
mysql 48381 0,0 0,2 5180 4696 p1- SN 17:22 0:00,01 /usr/local/libexec/
mysql 48382 0,0 0,2 5180 4696 p1- SN 17:22 0:00,04 /usr/local/libexec/
mysql 48383 0,0 0,2 5180 4696 p1- IN 17:22 0:00,00 /usr/local/libexec/
Сервер БД работает - можно запускать хаб.
Сначала даем команду

vh-install
и отвечаем на несколько вопросов (в большинстве случаев достаточно нажать enter).

--------------------------------
Your name ? (root)

Hello root,
let's start with configuration of database access..

--------------------------------
mysql database for verlihub will be called? (verlihub)
mysql user to access verlihub gonna be? (verlihub)
password to access verlihub be? (1195486071)
mysql server will run where? (localhost)
--------------------------------
user = verlihub
password = 1195486071
host = localhost
database = verlihub
--------------------------------
This database account cannot be accessed
--------------------------------
Is this info correct ? (Y/N)y
Do you want to create database now? (Y/N)

--------------------------------

root, you need to choos a place for the configuration files
--------------------------------
The order of folder that verlihub is looking for is following:

1 - variable $VERLIHUB_CFG - -inexisting-
2 - ./.verlihub - /root/.verlihub -inexisting-
3 - /root/.verlihub - /root/.verlihub -inexisting-
4 - /usr/local/etc/verlihub - /usr/local/etc/verlihub -inexisting-
5 - /etc/verlihub - /etc/verlihub -inexisting-
if two or more of these exist, lower number has priority
--------------------------------

--------------------------------
what is will be the configuration folder ? (/etc/verlihub)
The config folder /etc/verlihub does not exist and would be created
--------------------------------
Do you want to continue with these settings
(if not then select another folder) ? (Y/N)y
--------------------------------
Written: /etc/verlihub/dbconfig

--------------------------------

ERROR: Your installation is NOT complete
Either you were unable to create database or config folder
Without both valid I cannot continue
Come back with necessary info, permissions and running mysql server and run me again
Странно, но нарисовало ошибку Пробуем снова

/root/> vh_install
--------------------------------
Your name ? (root)

Hello root,
let's start with configuration of database access..

--------------------------------
mysql database for verlihub will be called? (verlihub)
mysql user to access verlihub gonna be? (verlihub)
password to access verlihub be? (1195486071)
mysql server will run where? (localhost)
--------------------------------
user = verlihub
password = 1195486071
host = localhost
database = verlihub
--------------------------------
This database account cannot be accessed
--------------------------------
Is this info correct ? (Y/N)y
Do you want to create database now? (Y/N)y
--------------------------------
Ok preparing mysql..
You probably need administrator access to mysql database
mysql administrator username? (root) root

--------------------------------

You'll be now promted by mysql client for password of root@localhost
Enter password:
--------------------------------
This database account exists
--------------------------------

--------------------------------

root, you need to choos a place for the configuration files
--------------------------------
The order of folder that verlihub is looking for is following:

1 - variable $VERLIHUB_CFG - -inexisting-
2 - ./.verlihub - /root/.verlihub -inexisting-
3 - /root/.verlihub - /root/.verlihub -inexisting-
4 - /usr/local/etc/verlihub - /usr/local/etc/verlihub -inexisting-
5 - /etc/verlihub - /etc/verlihub drwxrwxrwx
if two or more of these exist, lower number has priority
--------------------------------

--------------------------------
what is will be the configuration folder ? (/etc/verlihub)
This config folder already exists and may be overwitten (with a backup)
--------------------------------
Do you want to continue with these settings
(if not then select another folder) ? (Y/N)y
Do you want to overwrite the existing configuration ? (Y/N)y
--------------------------------
FYI: original configuration has been moved to /etc/verlihub/_backup
Written: /etc/verlihub/dbconfig

--------------------------------

Wait few seconds..
/usr/local/bin/vh_install: line 65: 22060 Killed: 9 $bindir/verlihub 22 >&/dev/null
--------------------------------
root, now I will ask you few more questions about your future hub, if you permit..

--------------------------------
Try to not put many special characters, you'll be able to put some laer

Give me your DC hub master nickname.. ([SU]root) Catdog
Choose your password.. (1195486402) 12345
Which will be default ONE hub port number? (411)
What will be your hub hostname? (catdog.sampo.ru)
Give me the name of your hub (hub of root) MyHub
--------------------------------
Hub: 'MyHub'
url: 'dchub://catdog.sampo.ru:411'
Master user: 'Catdog'
Master's password: '12345'
--------------------------------
Is this info correct ? (Y/N)y
FYI: settings are going to be created or updated
/etc/verlihub
/etc/verlihub
/etc/verlihub
will invoke the command
class is 10
nick is Catdog
password is 12345
done
На этот раз успешно Пришло время запустить наконец сервер (не забудь добавить в /etc/rc.conf строку verlihub_enable="YES"):

/root/> /usr/local/etc/rc.d/verlihub start
Starting verlihub.
/root/>
Теперь нужно выбрать клиента, и законнектиться с хабом. Я выбрал linuxdc (на старых версиях у него были проблемы при скачке с кодировками, сейчас все ОК)

cd /usr/ports/net-p2p/linuxdcpp/
make install clean
Теперь заходим на хаб из linuxdc под главной учеткой (у меня Catdog) с паролем (у меня 12345). В приват придут поздравления
Рулить хабом очень просто.
Чтобы получить текущие настройки, дай команду

!getconfig
Список настроек упадет в приват. Чтобы изменить настройку, скажи

!set "что меняешь" "на что меняешь"
, например,

!set hub_name NewName
Это изменит текущее имя хаба на NewName. После смены настроек дай команду

!reload
Я обычно изменяю следующие настройки: переименовываю ботов, ставлю минимальную шару (1гб), ограничиваю длину ников и сообщений юзеров. Остально по желанию .
Сообщение дня (motd) - выводится когда входишь на хаб, правила, фак - обычные текстовые файлы, находящиеся в папке с конфигом хаба (помните: what is will be the configuration folder ? (/etc/verlihub)). Там можно понаписать (или нарисовать в ASCII) чего угодно (возможно так же сделать разные сообщения для разных юзеров типа админов, простых смертных, операторов и т. д.)
Кикать юзера (без кавычек)

!kick "ip" "причина"
банить не сложнее

!ban_2w "ip" "причина"
время задается цифрой с буквой: Second - s; Minute - m; Hour - h; Day - d; Week - w; Month - M; Year - y.
Разбанить

unban "ip" "причина"
Послать широковещательный спам можно командой

!broadcast Хаб отправляется в ребут. Заходи через минуту или пошел ты нафек )
Осталось зарегать соседа в качестве админа, чтобы самому не делать грязную работу и готово (5 - это группа админов)

!regnewuser user 5
Ну вот и все.
P.S. Полный мануал по хабу инсталлится сюда
/usr/local/share/doc/verlihub/verlihub_manual.html

[Мандрагора]

Настройка Verlihub

Все настройки хаба хранятся в базе данных. Всё администрирование осуществляется на хабе его хозяином. Чтобы получить текущие настройки, введите:

!getconfig

Для изменения значения переменной, используйте команду !set:

!set <переменная> <значение>

После изменений, необходимо перезагрузить значения переменных (однако, некоторые изменения требуют перезагрузки хаба). Для этого используйте:

!reload

Если Ваши изменения не вступят в силу, перезапустите хаб.

Добавлено через 1 минуту
Базовая конфигурация

Существует несколько компонентов базовой конфигурации хаба. Есть некоторые параметры, которые нужно менять в базе данных, а также есть некоторые файлы, которые необходимо добавить (такие как MOTD(Сообщение Дня), FAQ, и др.) в конфигурационную директорию.

Добавлено через 1 минуту
Переменные хаба

В следующей таблице представлен список "базовых" опций хаба, которые нужно сконфигурировать.
Конфигурируются установочным скриптом
Переменная Описание
listen_port Порт, который слушает хаб. Другие хабы используют 411-й порт, но, чтобы сделать так, Вам надо запускать verlihub от рута. По умолчанию: 4111.
hub_host Хост, который люди будут использовать чтобы попасть на хаб (например: myhub.no-ip.com).
hub_name Имя хаба.
Не конфигурируются установочным скриптом, возможно, Вам понадобиться изменить данные настройки
Переменная Описание
listen_ip Если Вы имеете несколько сетевых интерфейсов, введите IP адрес, который хаб должен слушать. Если у Вас один сетевой интерфейс, то изменять данную опцию е требуется. По умолчанию: нет значения(пусто).
hub_desc Описание Вашего хаба.
hub_category Данная переменная - вводящееся расширение протокола хаблистов, позволяющее указать специфику хаба, например movies (фильмы).
hub_owner Хозяин хаба.
min_nick Минимальная длина ника. По умолчанию: 3.
max_nick Максимальная длина ника. По умолчанию: 32.
max_users Максимальное число пользователей на хабе. По умолчанию: 6000.
min_share Минимальная величина шары у юзеров в мегабайтах. Пользователи с меньше шарой не смогут войти на хаб. По умолчанию: 2 GB (2048).
tban_kick Время в секундах, в течение которого юзер не сможет зайти на хаб после кика. По умолчанию: 300 секунд (5 минут).
send_user_info Когда приходит юзер, он получит некоторую информацию о себе от хаба. 0 - выключить, 1 - включить. По умолчанию: 1.
send_user_ip Когда приходит юзер, хаб отправит ему, сообщаемый им (юзером) IP адрес. 0 - выключить, 1 - включить. По умолчанию: 0.
hub_security Имя основного бота (Security) на хабе.
hub_security_desc Описание основного бота (Security) на хабе.
opchat_name Имя ОпЧата (чата для операторов).
opchat_desc Описание ОпЧата.



Например, для того чтобы установить имя хаба в 'My Hub', используйте следующую команду:

!set hub_name My Hub

Добавлено через 2 минуты
Топик хаба

Чтобы установить топик хаба, используйте команду:

!topic This is a useless topic

Эта команда изменить топик на “This is a useless topic”. По умолчанию, только администраторы могут устанавливать топик хаба. Возможность изменять топик классам ниже админа (уровеь 5), можно дать в настройках хаба.

Добавлено через 15 минут
Сообщение дня (MOTD)

Сообщение дня показывается каждому подключившемуся к хабу юзеру. Всё что нужно, это сохранить содержимое сообщения в текстовый файл 'motd' в кофигурационной директории (в этом мануале /etc/verlihub/motd) и verlihub автоматически будет его использовать. Verlihub позволяет показывать своё сообщения дня каждого класса пользователей. Список используемых файлов:
Файл Описание
motd Все пользователи полчат это сообщение
motd_reg Зарегистрированные пользователи получат это сообщение в добавок к motd.
motd_vip ВИП пользователи получат это сообщение вдобавок к motd_reg и motd.
motd_op Операторы полчат данное сообщение вдобавок к motd_vip, motd_reg и motd.
motd_cheef Шефы получат это сообщение вдобавок к motd_op, motd_vip, motd_reg и motd.
motd_admin Админы получат это сообщение вдобавок к motd_cheef, motd_op, motd_vip, motd_reg и motd.
motd_master Хозяины хаба видят все сообщения motd.

Добавлено через 1 минуту
FAQ (часто задавемые вопросы)

FAQ доступен пользователям по команде +faq в чате хаба. Снова, всё что нужно сделать, это сохранить содержимое FAQ в текстовый файл 'faq' в кофигурационной директории (в этом мануале /etc/verlihub/faq) и verlihub автоматически будет его использовать.

Добавлено через 9 минут
Правила хаба

Когда пользователи набирают +rules в чате хаба, они получат содержимое файла 'rules', находящегося в конфигурационно директории (в этом мануале /etc/verlihub/rules).

Добавлено через 2 минуты
Помощь по хабу

Чтобы сделать юзерам достуаной помощь по хабу, Вам необходимо создать 7 различных хелп-файлов (если они ещё не созданы). Каждый класс пользователей имеет свой собственный хелп-файл. Например, обычный пользователь увидет справку для класса 0, после ввода команды +help, оператор увидет хелп для классов 3, 2, 1 и 0. Далее идёт таблица с перечнем файлов для работы системы помощи.
Класс Значение Хелп-файл
0 Обычные пользователи /etc/verlihub/help_usr
1 Зарегистрированные пользователи /etc/verlihub/help_reg
2 ВИП пользователи /etc/verlihub/help_vip
3 Операторы /etc/verlihub/help_op
4 Шефы /etc/verlihub/help_cheef
5 Админы /etc/verlihub/help_admin
10 Хозяин хаба /etc/verlihub/help_master

Добавлено через 1 минуту
Кодировка FAQ/Rules/Help/MOTD/и других командных файлов

Все ткстовые файлы, используемы verlihub'ом, должны быть в DOS-кодировке. Если Вы используете кодировку UNIX, все windows-клиенты будут интерпретировать текстовые файлы неправильно, и отображать их содержимое в одной строке. Существуют инструменты конвертирования в обе стороны: unix2dos и dos2unix, однако, они могут быть не включены в Ваш дистрибутив. Пользователи Gentoo могут использовать команду для установки обоих программ:

emerge dos2unix unix2dos

Эти инструменты также доступны во многих дистрибутивах. Если Вы используете редактор vim, то он может сохранять и изменять файлы в DOS-кодировке напрямую. Для этого запустите vim, и введите следующую команду перед сохрнением файлов:

>set fileencoding=dos