Просмотр профиля
Ссылка на Сообщение
#1
18.10.2008, 19:14
18.10.2008, 19:14
Вступление
Существует несколько путей по установке PsychoStats и выбор правильного процесса зависит от нескольких факторов, например, где находяться ваш игровой и веб сервера. Наиболее распространен случай когда игровой сервер запускается на одном компьютере (у провайдера игрового сервера), а веб-сервер на другом компьютере дистанционно удаленном (например у другого провайдера). Не смотря на то, что это наиболее распространенный случай, он вызывает наибольшие трудности для новых пользователей. Этот тип установки будет объяснен очень подробно в следующих главах, после обзора наиболее важных предметов и понятий, необходимых для лучшего понимания.
Это руководство было разработано как пошаговая инструкция. Начните с самого первого раздела и начните постепенно выполнять инструкции, постепенно до самого конца. Если какой-либо раздел описывает какую-либо информацию, которая вам не нужна, просто пропустите его и двигайтесь дальше, к следующему разделу.
Оригинал документа на английском языке вы можете найти по этой ссылке ]]>PsychoStats Installation]]>
Минимальные требования
Перед тем как пытаться установить PsychoStats вам необходимо убедиться, что ваша система удовлетворяет минимальным требованиям, перечисленным здесь. Любая программа или сервер, которые не выше версии указанной здесь - не поддерживаются. Как установить данное программное обеспечение будет объяснено в следующих нескольких главах.
Необходимое серверное программное обеспечение
Системы Windows
]]>ActivePerl v5.8 ]]>
Системы Linux
]]>Perl v5.8 ]]>
Необходимые модули Perl
DBI (v1.4 или выше)
DBD::mysql (v3.0002 или выше)
Дополнительные модули Perl
Net::FTP - Этот модуль необходим только тогда, когда требуется загружать журнал событий (логи) с удаленного FTP сервера (возможно этот модуль уже установлен с вашей версией Perl).
Net::SFTP - Этот модуль необходим только тогда, когда требуется загружать журнал событий (логи) с удаленного SFTP сервера (по защищенному протоколу передачи файлов SSH).
Данные требования - это абсолютный минимум для того, чтобы PsychoStats правильно работала в вашей системе. Если вы попытаетесь использовать более старые версии, то вы рискуете получить неправильную статистику из-за неполадок в обновлении и записи статистики. Пользователи с такого рода проблемами поддерживаться не будут.
Установка Perl в системе Windows
Perl необходим для работы PsychoStats. Если вы попытаетесь запустить ]]>stats.pl]]> при неустановленном Perl, то всё что вы увидете - это открывшееся окно Блокнота с исходным кодом данного файла. Который полностью для вас бесполезен. Поэтому читайте дальше, мои бесстрашные читатели!
Эта глава для тех пользователей, которые хотят запускать PsychoStats на своих компьютерах в системе Windows. Если вы планируете запуск из под Linux сервера, то можете пропустить эту главу и перейти к следующей, тем не менее, если на ваш Linux сервер не установлен Perl, то ваш сервер не будет работать правильно и вам придёться взять кувалду и 'подрихтовать' его.
Для тех пользователей, у кого игровой и веб сервера на разных машинах, более подробная инструкция по установке и настройке будет приведена позже. А сейчас, будут даны основы о том, как загрузить и установить ActivePerl.
Загрузка ActivePerl
Сперва наперво, вам нужно загрузить копию ]]>ActivePerl]]> (подсказка! кликните по ссылке!).
На этой странице загрузки вы увидете разные варианты выбора, что может слегка смутить. Загрузка для Windows ближе к самому низу страницы. Картинка слева показывает вам как это может выглядеть. Выделенная желтым строчка - это то что вам надо скачать если вы используете стандартную версию Windows. Если вы работаете с 64-битной версией Windows, то соответственно загружайте 64-битную версию ActivePerl.
Вам необходимо загрузить пакет установки 'MSI' а не AS package, потому что Windows AS package не содержит функции деинсталяции, и рекомендуется только в том случае, если вы не можете установить ActivePerl используя установщик MSI.
Установка ActivePerl
Двойной щелчок по файлу, который вы только что загрузили, запустит процесс установки для ActivePerl. Установка проста, просто принимайте все настройки по умолчанию, нажимая кнопку 'Далее'(Next), тем более мало что можно настроить в процессе установки ActiveState. После завершения процесса установки рекомендуется перезагрузить ваш компьютер. Не волнуйтесь, я вас подожду.
И так, после того как вы установили Perl, вам необходимо убедиться, что также установлены необходимые модули Perl. К счастью для вас - это очень просто. Читаем об этом в следующей главе!
Установка модулей Perl через PPM GUI
ActivePerl (начиная с v5.8) идет с графическим интерфейсом пользователя (GUI), который позволяет вам легко и просто искать и устанавливать модули, как показано на картинке слева. Щелкните по картинке, чтобы открыть ее в полном размере. Снимок снабжен цифрами, определяющими последовательность действий по установке модулей. Если GUI - не ваш стиль, то смотрите следующую главу, которая описывает подробную установку при помощи строки ввода команд ppm, которая идет с ActivePerl.
Последовательность шагов выполнения на снимке
Установка модулей при помощи командной строки
Даже графический интерфейс PPM GUI может немного смутить некоторых пользователей, поэтому ActivePerl имеет альтернативный метод установки модулей из командной строки DOS, котовый возможно будет проще, чем использование графического интерфейса. Все что для этого требуется - это отдельная команда для каждого модуля.
Нажмите на кнопку "Пуск" в панеле задач вашего компьютера, затем нажмите "Выполнить" и в открывшемся окне напечатайте "cmd". Это откроет пустое DOS окно. Теперь напечатайте следующие команды по порядку:
Пример вывода:
C:\Documents and Settings\Timmy>ppm install DBD-mysql
Downloading DBD-mysql-3.0002...done
Unpacking DBD-mysql-3.0002...done
Generating HTML for DBD-mysql-3.0002...done
Updating files in site area...done
14 files installed
Ваш веб-сервер
Для того чтобы игрокам можно было просматривать статистику PsychoStats на веб-сайте, вам нужен веб-сервер, способный отображать страницы. Почти любой сервер удовлетворяет этому условию, но также должна быть поддержка ]]>PHP v4.3+]]> (с активным ]]>MySQL]]> расширением). Данный документ не будет вдаваться в подробности как включить это расширение, так как PHP документация очень подробна, поэтому посетите указанные ссылки.
Если у вас уже есть веб-хост, то вы молодец и возможно, что ваш сайт уже поддерживает PHP и MySQL. Если вы не уверены в этом, то уточните этот вопрос у провайдера вашего хостинга.
Если, тем не менее, вы планируете запуск веб-сайта не на вашей машине, или у вас есть другой сервер, но на нем не установлен и не запущен веб-сервер, то это вам придеться сделать. Не зависимо от того, что у вас, Windows или Linux, я настоятельно рекомендую установить ]]>Apache]]>. Использование IIS в Windows имеет ряд особенностей, которые могут быть причиной проблем для правильной работы PsychoStats в тех же системах (главным образом права доступа пользователей, могут вызвать затруднения).
Если кто-то желает внести вклад в описание с подробными инструкциями по правильной установке и настройке IIS, пожалуйста, не стесняйтесь, заполняйте эту часть документации с указанием необходимых шагов. Но просьба сохранить форматирование для синхронизации с остальной частью документа.
Перед тем как углубиться в изучение по установке Apache на ваш сервер, советуем вам дочитать эту часть до конца. Есть более простой путь получить Apache, MySQL и PHP все установленные при помощи всего одного нажатия кнопки (ну хорошо, может быть нескольких нажатий кнопки). Выполненный для системы Windows сервер запустит Apache, MySQL и PHP и назвается он ]]>WAMP]]> (Windows Apache MySQL PHP). Специально для вас, замечательная группа людей с сайта ]]>wampserver.com]]> (на французском) и веб-сайта (]]>на английском]]>) предварительно упаковали и настроили все последние версии программ в один пакет, который снабдили всего лишь одним Мастером Установки.
Он даже включает в себя удобную маленькую утилитку "systray", которая позволит вам управлять различными конфигурациями сервера, устанавливать расширения без непосредственного изменения каких-либо файлов конфигураций. В пакет сервера Wamp также входят ряд полезных утилит, такие как phpMyAdmin, которая позволит вам администрировать вашу базу данных MySQL через веб интерфейс. И не волнуйтесь, WAMP Сервер не содержит какие-либо шпионские модули или надоедливые всплывающие сообщения бесплатных программ :-).
Ваш сервер базы данных
Если вы установили ]]>Wamp]]> Сервер, который был описан в предыдущей главе, или ваш веб-хост уже обеспечивает вам доступ к MySQL серверу, то можете пропустить эту главу и перейти к следующей.
Если вы не установили ]]>Wamp]]> Сервер и у вас нет уже установленной и запущенной базы данных MySQL, то вам необходимо ее установить на ваш веб-сервер. Этот документ не будет вдаваться в подробности по установке MySQL, потому что уже существует ]]>Инструкция по установке]]> которую вы найдете по ссылке.
Установив и запустив MySQL вы можете перейти к следующей главе.
Создание пользователя MySQL
Эта глава нужна не всем. Это зависит от того как установлен ваш MySQL сервер. Если у вас имеется веб-хост, который обеспечивает доступ к MySQL, то это означает что для вас уже создан пользователь и база данных, в этом случае вы можете пропустить эту главу и перейти к следующей. Для тех, кто не уверен, лучше прочитать эту главу до конца.
Примечание: Эта глава хорошо рационализирована, большинство пользователей уже будут иметь MySQL пользователей и им не придеться создавать пользователя самим.
MySQL - это много-пользовательская база данных, которая позволяет виртуально бесконечное число пользователей, подключенных к ней одновременно. Каждый пользователь имеет свои собственные привелегии на сервере, некоторым пользователям разрешен доступ только к определенным базам данных или даже определенным таблицам базы данных, в то время как другие пользователи могут иметь полный доступ ко всем базам данных (доступ к корню "root"). В большинстве случаев пользователи виртуального хостинга имеют ограниченный доступ к одной единственной базе данных, предоставленной веб-хостингом.
Если у вас полный доступ к корню ('root'), предоставляющий возможность создания нового пользователя, то настоятельно рекомендую добавить нового пользователя специально для PsychoStats. Эта мера безопасности необходима для того чтобы, если пользователь PsychoStats окажется недобропорядочным и попытается получить доступ к другим базам данным на вашем компьтере, то это ему сделать не получиться.
Если у вас установлен phpMyAdmin, который шел с ]]>WampServer]]> или который можно загрузить с официального ]]>phpMyAdmin веб-сайта]]>, то следуйте шагам, указанным ниже, для добавления нового пользователя.
На следующей странице поставьте все галочки в элементах управления (вы только можете оставить пустыми флаговые переключатели в разделе 'Administration' (Администрирование)) и нажмите "Go" (Переход).
Создание пользователя MySQL вручную
Если у вас не установлен phpMyAdmin или какоой-либо другой инструмент с графической оболочкой для доступа к серверу, но у вас есть доступ к стандартной командной строке клиента 'mysql', то вы можете использовать следующие команды, чтобы добавить нового пользователя в систему. Перед тем как вводить команды, убедитесь, что вы заменили соответствующие <части> вашей персональной информацией.
CREATE USER '<username>'@'%' IDENTIFIED BY '<password>';
GRANT USAGE ON *.* TO '<username>'@'%';
GRANT ALL PRIVILEGES ON `<database name>`.* TO '<username>'@'%';
Если третья строка не сработает, попробуйте следующую:
GRANT ALL ON <database name>.* TO '<username>'@'%';
Установка PsychoStats (часть 1)
Установка програмного обеспечения PsychoStats очень проста, основана на сетевом "Мастере Установки", который поможет вам пройти все необходимые шаги для создания базы данных и первоначальной настройки. Но сперва, вам нужно разместить PsychoStats на вашем веб-сайте.
Когда вы разархивируете PsychoStats на ваш компьютер, вы получите папку похожую на эту: psychostats3.0.0 (где 3.0.0 это текущая версия, билд и ревизия). Внутри этой папке будет некоторое количество файлов и под-папок, структура которых будет похожа на следующую (некоторые дополнительные файлы и папки не были включены в список).
PsychoStats3.0.0
Все эти файлы - необходимый пакет файлов для работы PsychoStats. Теперь нас интересует папка upload. Папка upload - полностью готовая статистика PsychoStats, это файлы, которые помогут вам просматривать вашу статистику онлайн. Содержимое этой папки необходимо скопировать на ваш веб-сервер. В папку с общим доступом в под-папку названную stats, которая должна находиться в корневой папке вашего веб-сайта. Ниже приведены примеры для Windows и Linux того, как нужно скопировать эту дирректорию на ваш веб-сайт.
IIS на Windows
Если вы работаете с ]]>IIS веб-сервером]]> то обычно корневая папка выглядит следующим образом: c:\Inetpub\wwwroot. Это именно та папка куда нужно скопировать папку PsychoStats upload. Тем не менее, настоящая папка в вашей системе может слегка отличаться и может быть найдена открыв страничку Веб-сайт в вашей Консоле Администратора IIS и заглянув на страницу чвойст веб-сайта. Вкладка 'Home Directory' содержит путь к папке вашего веб-сайта.
Шаг-за-Шагом
Теперь у вас должна быть загруженная на ваш веб-сервер папка upload в корневом каталоге. Возможно вы не захотите, чтобы эта папка осталась с именем upload. Поэтому переименуйте ее во что-нибудь более понятное, и подходящее по смыслу, например stats. Это можно сделать если кликнуть правой кнопкой на папке и выбрать пункт "Переименовать".
В итоге вы должны получить папку вида: c:\Inetpub\wwwroot\stats и в этой папке должны быть все PHP файлы и под-папки, на которых построен веб-сайт PsychoStats.
Аппач на Линуксе
]]>Apache]]> - это основной веб-сервер при выборе пользователей операционной системы Linux. Корневая папка документов веб-сайта может находиться в любом месте в системе. Наиболее часто используемые это: /usr/local/apache/htdocs, /usr/www/htdocs, ~/public_html. Проконсультируйтесь со службой поддержки вашего веб-хостинга или изучите конфигурацию вашего веб-сервера, для того чтобы выяснить где именно расположена ваша корневая папка документов.
Чтобы скопировать файлы на ваш веб-сайт сделайте следующее:
Сперва измените вашу папку где архив PsychoStats был извлечен. Затем выполните команды указанные ниже. Убедитесь, что вы работаете с настоящими путями, теми куда вы хотите скопировать файлы, а не с путями указанными ниже.
mkdir /path/to/document/root/stats
cp -rf upload/* /path/to/document/root/stats
Измените имя папки stats на любое другое, какое вы захотите.
Отправка на удаленный сервер
Если ваш веб-сервер находится на каком-либо удаленном хостинге, то вам скорее всего потребуется отправлять содержимое папки upload при помощи обычного FTP клиента (или в некоторых случаях SFTP). Это стандартная процедура, поэтому не будем вдаваться в подробности. Если вы не знаете, что такое FTP или как им пользоваться, вы можете спросить у друзей или поискать информацию на форумах. Данный документ не место где стоит обсуждать вопросы связанные с FTP.
Запуск Мастера Установки
Как только вы загрузили файлы PsychoStats на ваш веб-сервер, вы готовы для запуска мастера установки, который полностью завершит вашу установку статистики PsychoStats (но для запуска вам еще понадобится установить ]]>stats.pl]]>, который описан в следующей главе).
Предположим вы скопировали или отправили файлы папки PsychoStats upload в корневую папку документов вашего веб-сервера, названную "stats". Теперь всё, что вам требуется сделать это открыть следующий гипер ссылку используя ваш браузер /stats/install/index.php. Мастер установки поможет вам пройти весь оставшийся процесс установки. Например, ссылка может выглядеть вот так: http://example.com/stats/install/index.php
или, если у вас собственный веб-сервер и вы устанавливаете статистику на нем, то так:
http://localhost/stats/install/index.php
Данная ссылка должна запустить мастер установки. С этого момента, просто следуйте указаниям и отвечайте на вопросы.
Разрешения для файлов в IIS и Windows
Если после установки вы открыли домашнюю страничку вашей PsychoStats и увидели только Остроумные Сообщения об ошибках, то выполните следующие действия:
Теперь вы можете обновить страничку с PsychoStats и наконец убедиться в том, что всё корректно отображается.
Начальная конфигурация
Как только закончилась установка у вас имеется полностью функционирующий на вашем сервере сайт PsychoStats. Хотя, есть один момент, статистика пустая и в ней нет ни одного игрока. Первую вещь, которую вы должны сделать - это открыть (]]>Панель Управления Администратора (Administrator Control Panel]]>) [или сокращенно - (]]>ACP]]>)] и взглянуть на открывшиеся параметры конфигурации, первое изменение, которое необходимо выполнить - это нужно указать правильный ]]>источник логов (logsource)]]>. ]]>Источник логов (logsource)]]> определяет точное место, где находятся файлы событий (логи) вашего сервера и как их читать (обрабатывать). Без этого, у вас не будет вестись какая-либо статистика.
За дополнительной информацией обратитесь к статье ]]>Настройка источника логов]]>.
Установка PsychoStats (часть 2)
На данном этапе установки на вашем веб-сервере вы должны уже иметь полностью работоспособный сайт со статистикой PsychoStats. Вы можете открывать и просматривать разные страницы статистики (но пока в ней нет игроков) и у вас также уже должен быть настроен ]]>источник логов]]> . И я надеюсь, что вы также просмотрели другие параметры конфигурации и настроили их на ваш личный вкус и цвет.
Теперь на ваш компьютер требуется установить ту часть статистики, которая относиться и связана с ]]>stats.pl]]>. ]]>Stats.pl]]> (и связанные с ним файлы) составляют часть серверного приложения PsychoStats. Именно эта часть выполняет всю обработку файлов событий (логов игры) и заносит все значения статистики в базу данных. Эти файлы могут быть размещены почти где угодно, на вашем веб-сервере, на вашем игровом сервере, на вашем домашнем компьютере, или на любом другом удаленном сервере в любой половине земного шара. Некоторых пользователей данная часть установки вводит в затруднение. Поэтому, чтобы попытаться вам помочь, ниже приведен список вопросов и ответов на них, попытайтесь найти ответ, касаемый вашего случая.
Пользователи говорят...
Настройка файла stats.cfg
Файл stats.cfg - очень маленький конфигурационный файл, который просто содержит ряд основных параметров для подключения в вашей базе данных. Все остальные параметры для PsychoStats хранятся в самой базе данных и могут быть изменены через ACP (]]>Панель Управления Администратора]]>).
Убедитесь, что вы правильно отредактировали файл stats.cfg и указали правильные параметры для вашей базы данных. В приведенной ниже таблице указаны доступные параметры. Помните, вы настраиваете эти параметры основываясь на том, где расположен ваш сервер базы данных по отношению к файлу ]]>stats.pl]]>. Так если ваша база данных находится на другом удаленном компьютере, то вам необходимо задать параметр 'dbhost' указав имя удаленного хоста и его IP адрес.
Основные проблемы возникающие при работе с удаленной базой данных - это неправильные права доступа для пользователя, при которых не разрешается подключение к базе данных. Другая часто встречающаяся проблема состоит в том, что большинство провайдеров бесплатных хостингов блокируют удаленные подключения к базе данных на их серверах, что делает невозможным запуск файла stats.pl на другой машине.
Параметр По умолчанию Назначение
dbtype mysql Указывает используемый тип базы данных
dbhost localhost Название хостинга (Hostname) или IP адрес сервера базы данных (localhost - если база данных находится на вашем компьютере)
dbport Порт для подключения к серверу базы данных. Оставьте пустым чтобы использовать назначенный по умолчанию
dbname psychostats Используемое и мя базы данных
dbuser Имя пользователя для подключения. Оставьте пустым если пользователь не указан.
dbpass Пароль для идентификации пользователя. Оставьте пустым если пароль не указан.
dbtblprefix ps_ Префикс (приставка), которая используется во всех таблицах PsychoStats. ps_ назначен по умолчанию и лучше его не менять.
Запуск PsychoStats
На данном этапе вы уже запускали 'Мастера Установки' через ваш браузер, а также у вас должна быть полностью установлена база данных и вы можете просматривать онлайн пока еще пустую статистику. Наконец то настало время заполнить нашу статистику!
Как запускать ]]>stats.pl]]> зависит от того, какой у вас тип системы. Ниже мы рассмотрим различные варианты.
Оболочка Linux SSH
Если ваш хост имеет возможность подключения через SSH, просто залогиньтесь и измените папку psychostats куда вы до этого скопировали файлы, затем просто запустите файл ]]>stats.pl ]]>из командной строки:
./stats.pl -v
Знайте, что можно добавить в командной строке ключ '-v'. Это включит подробный ('verbose') режим и вы получите более детальный отчет о процессе обработки. Это рекомендуется сделать когда вы впервые запускаете обработку и так же вы увидите что именно происходит в процессе.
Сервер Windows
Если вы запускаете PsychoStats на вашем домашнем компьютере или на удаленном хостинге с возможностью доступа к удаленному рабочему столу, то просто откройте папку где установлен PsychoStats. Если в этой папке присутствует под-папка 'scripts', то зайдите в нее и двойным кликом мыши запустите файл 'psychostats.bat'. Это действие запустит файл stats.pl в подробном ('verbose') режиме и оставит открытым окно консоли. Это даст вам возможность увидеть ошибки, если они произошли.
Альтернативный вариант, это просто двойной клик мыши непосредственно по иконке самого файла stats.pl, но тогда вы не увидите результат и окно закроется автоматически в конце обработки файла ]]>stats.pl.]]> Поэтому будет трудно увидеть сообщения о произошедших ошибка. Тем не менее, если вы полагаете что произошла ошибка, то можете посмотреть файл stats.log в соответствующей папке (если такого файла нет, то никаких критических ошибок в процессе обработки не было).
Автоматическое планирование PsychoStats
Ну теперь, после того как вы запустили stats.pl и убедившись в том, что в вашей статистике появились игроки, вам скорее всего захочется запускать PsychoStats в автоматическом режиме. PsychoStats не имеет встроенного средства для запуска самой себя. Для этой цели нам потребуется Планировщик задач Windows (Windows Task Scheduler), или Linux CRON в зависимости от того под какой системой вы работаете.
Планировщик задач Windows
Планировщик Windows - очень функционально ограничен, но он по крайней мере позволяет запускать PsychoStats хотябы раз в день. Это означает, что с помощью него вы не добьетесь обновлений каждый час. Существуют другие программные продукты под Windows которые позволяют выполнять задания с нужной периодичностью.
Планировщик задач вы найдете в меню Пуск по следующему пути: Все программы -> Стандартные -> Служебные -> Назначенные задания
Скриншот будет добавлен позже... Ну а теперь, включите ваше воображение. Добавьте 'perl.exe' как приложение для запуска, с основным параметром 'ежедневно'. При завершении Мастера Планирования Заданий поставьте галку в чекбоксе 'Установить дополнительные параметры после нажатия кнопки "Готово" '. Когда откроется это окно, добавьте путь к вашему файлу stats.pl к концу уже существующего perl.exe. Затем сохраните задание. Если хотите запускать обновление чаще чем один раз в день, то перейдите на вкладку 'Расписание' и нажмите на кнопку 'Дополнительно...', поставьте галку 'повторять задание' и выберите нужный интервал времени.
Linux CRON
CRON - очень легок в установке, но существует несколько вариантов в зависимости от используемого вами провайдера хостинга. Например, cPanel имеет встроенный графический интерфейсa (GUI), который позволяет создавать задание непосредмтвенно через веб-браузер, но другие системы могут делать это через их оболочку. Оба варианта мы рассмотрим ниже.
Установка CRON через сPanel
cPanel имеет графический интерфейс пользователя (GUI) для установки CRON как показано на снимке слева. Это самый простой способ запланировать автоматический запуск PsychoStats. Просто внимательно посмотрите на скриншот и установите нужное время и день когда вы хотите запускать файл stats.pl. Большинство пользователей желают запускать stats.pl каждый час и здесь приведены основные рекомендации как это сделать. Продолжительность игры на одной карте в основном составляет 30-60 минут, поэтому каждый час будет обработана одна или две карты при каждом обновлении. Ваше личное дело, как часто обновлять статистику, но я не рекоммендую обновлять чаще чем 15 минут и меньше. Если вы все-таки решили обновлять статистику слишком часто, то может получится такой случай, когда первый процесс обработки еще не завершен, но уже запущен второй, которые попытаются обрабатывать одни и те же файлы, что может повредить правильной работе статистики.
Установка CRON вручную
Установка CRON вручную также проста, но требуется чтобы у вас был доступ к оболочке сервера. Это означает, что сперва вы должны установить SSH на сервер. С помощью которого вы сможете использовать 'crontab' команды, чтобы добавить автоматический запуск. Если вы запустите команду 'crontab -e' то это откроет ваш редактор, назначенный по умолчанию (для большинства случаев это будет 'vi' или 'nano'). Вы должны просто ввести строку текста указанную в примере ниже, сохраните а затем закройте файл. В указанном ниже примере приведено задание, которое будет запускать обновление статистики каждый час в самом его начале. Убедитесь, что вы указали правильный путь к файлу stats.pl, именно там, где он у вас сейчас находится.
0 * * * * /home/xxxxxxxx/psychostats/stats.pl
Каждое число или звездочка (*) представляет собой время. Существует 5 разных способов настроить время, когда задание будет запущено, они приведены ниже. Большинство более подробных деталей били опущены, чтобы не загромождать пример. Если вам нужны более подробные детали и пояснения, то обратитесь к поисковым системам интернета. Из всего того, что вы видете при входе в задание, вы в основном будете использовать первый 2 поля.
И так , если мы взглянем на наш предыдущий пример, то мы сказали программе запускаться в НОЛЬ минут, каждый час, каждый день, каждый месяц, в каждый день недели. Таким образом она будет запускаться ЕДИНОЖДЫ каждый час (как только этот час начнется).
Если мы хотим запускать stats.pl каждые 30 минут, то мы можем использовать слегка расширенную запись:
*/30 * * * * /home/xxxxxxxx/psychostats/stats.pl
или (что в принципе тоже самое):
0,30 * * * * /home/xxxxxxxx/psychostats/stats.pl
Всё готово
Поздравляю, вы все сделали правильно. Теперь вы имеете полностью функциональную статистику PsychoStats, которая автоматически обновляется.
Автор перевода: Snake60
Существует несколько путей по установке PsychoStats и выбор правильного процесса зависит от нескольких факторов, например, где находяться ваш игровой и веб сервера. Наиболее распространен случай когда игровой сервер запускается на одном компьютере (у провайдера игрового сервера), а веб-сервер на другом компьютере дистанционно удаленном (например у другого провайдера). Не смотря на то, что это наиболее распространенный случай, он вызывает наибольшие трудности для новых пользователей. Этот тип установки будет объяснен очень подробно в следующих главах, после обзора наиболее важных предметов и понятий, необходимых для лучшего понимания.
Это руководство было разработано как пошаговая инструкция. Начните с самого первого раздела и начните постепенно выполнять инструкции, постепенно до самого конца. Если какой-либо раздел описывает какую-либо информацию, которая вам не нужна, просто пропустите его и двигайтесь дальше, к следующему разделу.
Оригинал документа на английском языке вы можете найти по этой ссылке ]]>PsychoStats Installation]]>
Минимальные требования
Перед тем как пытаться установить PsychoStats вам необходимо убедиться, что ваша система удовлетворяет минимальным требованиям, перечисленным здесь. Любая программа или сервер, которые не выше версии указанной здесь - не поддерживаются. Как установить данное программное обеспечение будет объяснено в следующих нескольких главах.
Необходимое серверное программное обеспечение
Веб-сервер (обычно ]]>Apache]]> или ]]>IIS]]>)
]]>PHP]]> v4.3 или более поздней версии.
]]>MySQL]]> v4.1.11 или более поздней версии..
Системы Windows
]]>ActivePerl v5.8 ]]>
Системы Linux
]]>Perl v5.8 ]]>
Необходимые модули Perl
DBI (v1.4 или выше)
DBD::mysql (v3.0002 или выше)
Дополнительные модули Perl
Net::FTP - Этот модуль необходим только тогда, когда требуется загружать журнал событий (логи) с удаленного FTP сервера (возможно этот модуль уже установлен с вашей версией Perl).
Net::SFTP - Этот модуль необходим только тогда, когда требуется загружать журнал событий (логи) с удаленного SFTP сервера (по защищенному протоколу передачи файлов SSH).
Данные требования - это абсолютный минимум для того, чтобы PsychoStats правильно работала в вашей системе. Если вы попытаетесь использовать более старые версии, то вы рискуете получить неправильную статистику из-за неполадок в обновлении и записи статистики. Пользователи с такого рода проблемами поддерживаться не будут.
Установка Perl в системе Windows
Perl необходим для работы PsychoStats. Если вы попытаетесь запустить ]]>stats.pl]]> при неустановленном Perl, то всё что вы увидете - это открывшееся окно Блокнота с исходным кодом данного файла. Который полностью для вас бесполезен. Поэтому читайте дальше, мои бесстрашные читатели!
Эта глава для тех пользователей, которые хотят запускать PsychoStats на своих компьютерах в системе Windows. Если вы планируете запуск из под Linux сервера, то можете пропустить эту главу и перейти к следующей, тем не менее, если на ваш Linux сервер не установлен Perl, то ваш сервер не будет работать правильно и вам придёться взять кувалду и 'подрихтовать' его.
Для тех пользователей, у кого игровой и веб сервера на разных машинах, более подробная инструкция по установке и настройке будет приведена позже. А сейчас, будут даны основы о том, как загрузить и установить ActivePerl.
Загрузка ActivePerl
Сперва наперво, вам нужно загрузить копию ]]>ActivePerl]]> (подсказка! кликните по ссылке!).
На этой странице загрузки вы увидете разные варианты выбора, что может слегка смутить. Загрузка для Windows ближе к самому низу страницы. Картинка слева показывает вам как это может выглядеть. Выделенная желтым строчка - это то что вам надо скачать если вы используете стандартную версию Windows. Если вы работаете с 64-битной версией Windows, то соответственно загружайте 64-битную версию ActivePerl. Вам необходимо загрузить пакет установки 'MSI' а не AS package, потому что Windows AS package не содержит функции деинсталяции, и рекомендуется только в том случае, если вы не можете установить ActivePerl используя установщик MSI.
Установка ActivePerl
Двойной щелчок по файлу, который вы только что загрузили, запустит процесс установки для ActivePerl. Установка проста, просто принимайте все настройки по умолчанию, нажимая кнопку 'Далее'(Next), тем более мало что можно настроить в процессе установки ActiveState. После завершения процесса установки рекомендуется перезагрузить ваш компьютер. Не волнуйтесь, я вас подожду.
И так, после того как вы установили Perl, вам необходимо убедиться, что также установлены необходимые модули Perl. К счастью для вас - это очень просто. Читаем об этом в следующей главе!
Установка модулей Perl через PPM GUI
ActivePerl (начиная с v5.8) идет с графическим интерфейсом пользователя (GUI), который позволяет вам легко и просто искать и устанавливать модули, как показано на картинке слева. Щелкните по картинке, чтобы открыть ее в полном размере. Снимок снабжен цифрами, определяющими последовательность действий по установке модулей. Если GUI - не ваш стиль, то смотрите следующую главу, которая описывает подробную установку при помощи строки ввода команд ppm, которая идет с ActivePerl.Последовательность шагов выполнения на снимке
1. Выбрать кнопку 'uninstalled modules' (неустановленные модули)
2. Напечатать имя модуля
3. Выделить модуль для установки
4. Выбрать кнопку 'add to install' (добавить к установке)
5. И наконец, нажать кнопку 'run' (запуск) чтобы установить модуль.
Установка модулей при помощи командной строки
Даже графический интерфейс PPM GUI может немного смутить некоторых пользователей, поэтому ActivePerl имеет альтернативный метод установки модулей из командной строки DOS, котовый возможно будет проще, чем использование графического интерфейса. Все что для этого требуется - это отдельная команда для каждого модуля.
Нажмите на кнопку "Пуск" в панеле задач вашего компьютера, затем нажмите "Выполнить" и в открывшемся окне напечатайте "cmd". Это откроет пустое DOS окно. Теперь напечатайте следующие команды по порядку:
ppm install DBI
ppm install DBD-mysql
Пример вывода:
C:\Documents and Settings\Timmy>ppm install DBD-mysql
Downloading DBD-mysql-3.0002...done
Unpacking DBD-mysql-3.0002...done
Generating HTML for DBD-mysql-3.0002...done
Updating files in site area...done
14 files installed
Ваш веб-сервер
Для того чтобы игрокам можно было просматривать статистику PsychoStats на веб-сайте, вам нужен веб-сервер, способный отображать страницы. Почти любой сервер удовлетворяет этому условию, но также должна быть поддержка ]]>PHP v4.3+]]> (с активным ]]>MySQL]]> расширением). Данный документ не будет вдаваться в подробности как включить это расширение, так как PHP документация очень подробна, поэтому посетите указанные ссылки.
Если у вас уже есть веб-хост, то вы молодец и возможно, что ваш сайт уже поддерживает PHP и MySQL. Если вы не уверены в этом, то уточните этот вопрос у провайдера вашего хостинга.
Если, тем не менее, вы планируете запуск веб-сайта не на вашей машине, или у вас есть другой сервер, но на нем не установлен и не запущен веб-сервер, то это вам придеться сделать. Не зависимо от того, что у вас, Windows или Linux, я настоятельно рекомендую установить ]]>Apache]]>. Использование IIS в Windows имеет ряд особенностей, которые могут быть причиной проблем для правильной работы PsychoStats в тех же системах (главным образом права доступа пользователей, могут вызвать затруднения).
Если кто-то желает внести вклад в описание с подробными инструкциями по правильной установке и настройке IIS, пожалуйста, не стесняйтесь, заполняйте эту часть документации с указанием необходимых шагов. Но просьба сохранить форматирование для синхронизации с остальной частью документа.
Перед тем как углубиться в изучение по установке Apache на ваш сервер, советуем вам дочитать эту часть до конца. Есть более простой путь получить Apache, MySQL и PHP все установленные при помощи всего одного нажатия кнопки (ну хорошо, может быть нескольких нажатий кнопки). Выполненный для системы Windows сервер запустит Apache, MySQL и PHP и назвается он ]]>WAMP]]> (Windows Apache MySQL PHP). Специально для вас, замечательная группа людей с сайта ]]>wampserver.com]]> (на французском) и веб-сайта (]]>на английском]]>) предварительно упаковали и настроили все последние версии программ в один пакет, который снабдили всего лишь одним Мастером Установки.Он даже включает в себя удобную маленькую утилитку "systray", которая позволит вам управлять различными конфигурациями сервера, устанавливать расширения без непосредственного изменения каких-либо файлов конфигураций. В пакет сервера Wamp также входят ряд полезных утилит, такие как phpMyAdmin, которая позволит вам администрировать вашу базу данных MySQL через веб интерфейс. И не волнуйтесь, WAMP Сервер не содержит какие-либо шпионские модули или надоедливые всплывающие сообщения бесплатных программ :-). Ваш сервер базы данных
Если вы установили ]]>Wamp]]> Сервер, который был описан в предыдущей главе, или ваш веб-хост уже обеспечивает вам доступ к MySQL серверу, то можете пропустить эту главу и перейти к следующей.
Если вы не установили ]]>Wamp]]> Сервер и у вас нет уже установленной и запущенной базы данных MySQL, то вам необходимо ее установить на ваш веб-сервер. Этот документ не будет вдаваться в подробности по установке MySQL, потому что уже существует ]]>Инструкция по установке]]> которую вы найдете по ссылке.
Установив и запустив MySQL вы можете перейти к следующей главе.
Создание пользователя MySQL
Эта глава нужна не всем. Это зависит от того как установлен ваш MySQL сервер. Если у вас имеется веб-хост, который обеспечивает доступ к MySQL, то это означает что для вас уже создан пользователь и база данных, в этом случае вы можете пропустить эту главу и перейти к следующей. Для тех, кто не уверен, лучше прочитать эту главу до конца.
Примечание: Эта глава хорошо рационализирована, большинство пользователей уже будут иметь MySQL пользователей и им не придеться создавать пользователя самим.
MySQL - это много-пользовательская база данных, которая позволяет виртуально бесконечное число пользователей, подключенных к ней одновременно. Каждый пользователь имеет свои собственные привелегии на сервере, некоторым пользователям разрешен доступ только к определенным базам данных или даже определенным таблицам базы данных, в то время как другие пользователи могут иметь полный доступ ко всем базам данных (доступ к корню "root"). В большинстве случаев пользователи виртуального хостинга имеют ограниченный доступ к одной единственной базе данных, предоставленной веб-хостингом.
Если у вас полный доступ к корню ('root'), предоставляющий возможность создания нового пользователя, то настоятельно рекомендую добавить нового пользователя специально для PsychoStats. Эта мера безопасности необходима для того чтобы, если пользователь PsychoStats окажется недобропорядочным и попытается получить доступ к другим базам данным на вашем компьтере, то это ему сделать не получиться.
Если у вас установлен phpMyAdmin, который шел с ]]>WampServer]]> или который можно загрузить с официального ]]>phpMyAdmin веб-сайта]]>, то следуйте шагам, указанным ниже, для добавления нового пользователя.
Загрузите phpMyAdmin и на главной странице, ближе к низу, нажмите "Privileges" (Привелегии). Это покажет список текущих пользователей базы данных.
Внизу списка пользователей нажмите на "Add a new User" (Добавить нового пользователя).
На следующем эране, в поле "Login Information" (Информация входящего), вы должны указать имя пользователя (User name) и пароль (password). Также, вам будет предложено заполнить поле "Host". Для среднего пользователя можно указать значение 'Any host' (Любой хост). Это даст возможность любому человеку во всем мире подключиться к базе данных PsychoStats. Если этот параметр выставить в значение "Local" (Локальный), то к базе данных смогут подключаться только те пользователи для которых соединение организовано на самом сервере (таким образом, с вашего игрового сервера, который может быть следующей дверью, или половина людей со всего мира, не смогут подключиться к базе данных).
Остальные настройки на этой странице можно оставить так как они есть и нажмите на кнопку "Go" (Переход) внизу страницы. Данное действие добавит пользователя и обновит страницу. Но теперь внизу у нас появились дополнительные опции внизу для пользователя.
В разделе "Database-specific privileges" (где-то посередине страницы) возможно вы захотите указать имя базы данных, которую вы будите использовать для вашей установки PsychoStats. Или если у вас уже есть установленная база данных, просто выберите ее из выпадающего списка, затем нажмите кнопку "Go" (Переход).
На следующей странице поставьте все галочки в элементах управления (вы только можете оставить пустыми флаговые переключатели в разделе 'Administration' (Администрирование)) и нажмите "Go" (Переход).
Создание пользователя MySQL вручную
Если у вас не установлен phpMyAdmin или какоой-либо другой инструмент с графической оболочкой для доступа к серверу, но у вас есть доступ к стандартной командной строке клиента 'mysql', то вы можете использовать следующие команды, чтобы добавить нового пользователя в систему. Перед тем как вводить команды, убедитесь, что вы заменили соответствующие <части> вашей персональной информацией.
CREATE USER '<username>'@'%' IDENTIFIED BY '<password>';
GRANT USAGE ON *.* TO '<username>'@'%';
GRANT ALL PRIVILEGES ON `<database name>`.* TO '<username>'@'%';
Если третья строка не сработает, попробуйте следующую:
GRANT ALL ON <database name>.* TO '<username>'@'%';
Установка PsychoStats (часть 1)
Установка програмного обеспечения PsychoStats очень проста, основана на сетевом "Мастере Установки", который поможет вам пройти все необходимые шаги для создания базы данных и первоначальной настройки. Но сперва, вам нужно разместить PsychoStats на вашем веб-сайте.
Когда вы разархивируете PsychoStats на ваш компьютер, вы получите папку похожую на эту: psychostats3.0.0 (где 3.0.0 это текущая версия, билд и ревизия). Внутри этой папке будет некоторое количество файлов и под-папок, структура которых будет похожа на следующую (некоторые дополнительные файлы и папки не были включены в список).
PsychoStats3.0.0
\lib
\upload
stats.pl
stats.cfg
Все эти файлы - необходимый пакет файлов для работы PsychoStats. Теперь нас интересует папка upload. Папка upload - полностью готовая статистика PsychoStats, это файлы, которые помогут вам просматривать вашу статистику онлайн. Содержимое этой папки необходимо скопировать на ваш веб-сервер. В папку с общим доступом в под-папку названную stats, которая должна находиться в корневой папке вашего веб-сайта. Ниже приведены примеры для Windows и Linux того, как нужно скопировать эту дирректорию на ваш веб-сайт.
IIS на Windows
Если вы работаете с ]]>IIS веб-сервером]]> то обычно корневая папка выглядит следующим образом: c:\Inetpub\wwwroot. Это именно та папка куда нужно скопировать папку PsychoStats upload. Тем не менее, настоящая папка в вашей системе может слегка отличаться и может быть найдена открыв страничку Веб-сайт в вашей Консоле Администратора IIS и заглянув на страницу чвойст веб-сайта. Вкладка 'Home Directory' содержит путь к папке вашего веб-сайта.
Шаг-за-Шагом
Откройте папку, куда вы разархивировали PsychoStats.
Правый клик мыши на папке upload и выбираем "Копировать".
Открываем корневую папку вашего веб-сайта (например: c:\Inetpub\wwwroot или где она у вас находиться в системе).
Правый клик мыши на свободном пространстве открытого окна этой папки и выбираем "Вставить". Для копирования файлов потребуется всего несколько секунд.
Теперь у вас должна быть загруженная на ваш веб-сервер папка upload в корневом каталоге. Возможно вы не захотите, чтобы эта папка осталась с именем upload. Поэтому переименуйте ее во что-нибудь более понятное, и подходящее по смыслу, например stats. Это можно сделать если кликнуть правой кнопкой на папке и выбрать пункт "Переименовать".
В итоге вы должны получить папку вида: c:\Inetpub\wwwroot\stats и в этой папке должны быть все PHP файлы и под-папки, на которых построен веб-сайт PsychoStats.
Аппач на Линуксе
]]>Apache]]> - это основной веб-сервер при выборе пользователей операционной системы Linux. Корневая папка документов веб-сайта может находиться в любом месте в системе. Наиболее часто используемые это: /usr/local/apache/htdocs, /usr/www/htdocs, ~/public_html. Проконсультируйтесь со службой поддержки вашего веб-хостинга или изучите конфигурацию вашего веб-сервера, для того чтобы выяснить где именно расположена ваша корневая папка документов.
Чтобы скопировать файлы на ваш веб-сайт сделайте следующее:
Сперва измените вашу папку где архив PsychoStats был извлечен. Затем выполните команды указанные ниже. Убедитесь, что вы работаете с настоящими путями, теми куда вы хотите скопировать файлы, а не с путями указанными ниже.
mkdir /path/to/document/root/stats
cp -rf upload/* /path/to/document/root/stats
Измените имя папки stats на любое другое, какое вы захотите.
Отправка на удаленный сервер
Если ваш веб-сервер находится на каком-либо удаленном хостинге, то вам скорее всего потребуется отправлять содержимое папки upload при помощи обычного FTP клиента (или в некоторых случаях SFTP). Это стандартная процедура, поэтому не будем вдаваться в подробности. Если вы не знаете, что такое FTP или как им пользоваться, вы можете спросить у друзей или поискать информацию на форумах. Данный документ не место где стоит обсуждать вопросы связанные с FTP.
Запуск Мастера Установки
Как только вы загрузили файлы PsychoStats на ваш веб-сервер, вы готовы для запуска мастера установки, который полностью завершит вашу установку статистики PsychoStats (но для запуска вам еще понадобится установить ]]>stats.pl]]>, который описан в следующей главе).
Предположим вы скопировали или отправили файлы папки PsychoStats upload в корневую папку документов вашего веб-сервера, названную "stats". Теперь всё, что вам требуется сделать это открыть следующий гипер ссылку используя ваш браузер /stats/install/index.php. Мастер установки поможет вам пройти весь оставшийся процесс установки. Например, ссылка может выглядеть вот так: http://example.com/stats/install/index.php
или, если у вас собственный веб-сервер и вы устанавливаете статистику на нем, то так:
http://localhost/stats/install/index.php
Данная ссылка должна запустить мастер установки. С этого момента, просто следуйте указаниям и отвечайте на вопросы.
Разрешения для файлов в IIS и Windows
Если после установки вы открыли домашнюю страничку вашей PsychoStats и увидели только Остроумные Сообщения об ошибках, то выполните следующие действия:
Откройте папку, где PsychoStats хранит свои скомпилированные шаблоны (По умолчанию: ps_themes_compiled)
Правый клик мыши на этой папке и выбираем Свойства (Properties)
Переходим на вкладку Безопасность (Security)
Выбираем пользователя "Гостевой Интернет Аккаунт" ("Internet Guest Account") (Примечание: Имя пользователя может отличаться если вы изменяете ваши IIS установки)
Поставьте галку в чекбоксе "Разрешить: Полный доступ" ("Allow: Full Control"), чтобы назначить все необходимые разрешения к этой папке для IIS.
Нажмите Применить (Apply) и затем OK
Теперь вы можете обновить страничку с PsychoStats и наконец убедиться в том, что всё корректно отображается.
Начальная конфигурация
Как только закончилась установка у вас имеется полностью функционирующий на вашем сервере сайт PsychoStats. Хотя, есть один момент, статистика пустая и в ней нет ни одного игрока. Первую вещь, которую вы должны сделать - это открыть (]]>Панель Управления Администратора (Administrator Control Panel]]>) [или сокращенно - (]]>ACP]]>)] и взглянуть на открывшиеся параметры конфигурации, первое изменение, которое необходимо выполнить - это нужно указать правильный ]]>источник логов (logsource)]]>. ]]>Источник логов (logsource)]]> определяет точное место, где находятся файлы событий (логи) вашего сервера и как их читать (обрабатывать). Без этого, у вас не будет вестись какая-либо статистика.
За дополнительной информацией обратитесь к статье ]]>Настройка источника логов]]>.
Установка PsychoStats (часть 2)
На данном этапе установки на вашем веб-сервере вы должны уже иметь полностью работоспособный сайт со статистикой PsychoStats. Вы можете открывать и просматривать разные страницы статистики (но пока в ней нет игроков) и у вас также уже должен быть настроен ]]>источник логов]]> . И я надеюсь, что вы также просмотрели другие параметры конфигурации и настроили их на ваш личный вкус и цвет.
Теперь на ваш компьютер требуется установить ту часть статистики, которая относиться и связана с ]]>stats.pl]]>. ]]>Stats.pl]]> (и связанные с ним файлы) составляют часть серверного приложения PsychoStats. Именно эта часть выполняет всю обработку файлов событий (логов игры) и заносит все значения статистики в базу данных. Эти файлы могут быть размещены почти где угодно, на вашем веб-сервере, на вашем игровом сервере, на вашем домашнем компьютере, или на любом другом удаленном сервере в любой половине земного шара. Некоторых пользователей данная часть установки вводит в затруднение. Поэтому, чтобы попытаться вам помочь, ниже приведен список вопросов и ответов на них, попытайтесь найти ответ, касаемый вашего случая.
Пользователи говорят...
"Мой игровой и веб сервера находятся на одном и том же компьютере и это не мой домашний комп"Ответ: Отправьте ]]>stats.pl]]>, stats.cfg и папку библиотек на игровой сервер.
"Мой игровой сервер и веб-сервер на удаленном компьютере, но я хочу запускать PsychoStats на своем домашнем компе."Ответ: Сделайте копию ]]>stats.pl]]>, stats.cfg и папки библиотек на вашем домашнем компьютере. Разместите эти файлы в каталоге PsychoStats (не важно в каком именно месте). Я советую что-то типа этого "c:\psychostats".
"Мой игровой сервер на удаленном компьютере и я хочу запускать stats.pl на игровом сервере."Ответ: Отправьте stats.pl, stats.cfg и папку библиотек на игровой сервер. Вы должны иметь папку на домашнем компьютере, только для отправки из нее файлов в каталог psychostats. Не помещайте файлы в корневую папку вашего веб-сайта (то есть: public_html, или cgi-bin).
Настройка файла stats.cfg
Файл stats.cfg - очень маленький конфигурационный файл, который просто содержит ряд основных параметров для подключения в вашей базе данных. Все остальные параметры для PsychoStats хранятся в самой базе данных и могут быть изменены через ACP (]]>Панель Управления Администратора]]>).
Убедитесь, что вы правильно отредактировали файл stats.cfg и указали правильные параметры для вашей базы данных. В приведенной ниже таблице указаны доступные параметры. Помните, вы настраиваете эти параметры основываясь на том, где расположен ваш сервер базы данных по отношению к файлу ]]>stats.pl]]>. Так если ваша база данных находится на другом удаленном компьютере, то вам необходимо задать параметр 'dbhost' указав имя удаленного хоста и его IP адрес.
Основные проблемы возникающие при работе с удаленной базой данных - это неправильные права доступа для пользователя, при которых не разрешается подключение к базе данных. Другая часто встречающаяся проблема состоит в том, что большинство провайдеров бесплатных хостингов блокируют удаленные подключения к базе данных на их серверах, что делает невозможным запуск файла stats.pl на другой машине.
Параметр По умолчанию Назначение
dbtype mysql Указывает используемый тип базы данных
dbhost localhost Название хостинга (Hostname) или IP адрес сервера базы данных (localhost - если база данных находится на вашем компьютере)
dbport Порт для подключения к серверу базы данных. Оставьте пустым чтобы использовать назначенный по умолчанию
dbname psychostats Используемое и мя базы данных
dbuser Имя пользователя для подключения. Оставьте пустым если пользователь не указан.
dbpass Пароль для идентификации пользователя. Оставьте пустым если пароль не указан.
dbtblprefix ps_ Префикс (приставка), которая используется во всех таблицах PsychoStats. ps_ назначен по умолчанию и лучше его не менять.
Запуск PsychoStats
На данном этапе вы уже запускали 'Мастера Установки' через ваш браузер, а также у вас должна быть полностью установлена база данных и вы можете просматривать онлайн пока еще пустую статистику. Наконец то настало время заполнить нашу статистику!
Как запускать ]]>stats.pl]]> зависит от того, какой у вас тип системы. Ниже мы рассмотрим различные варианты.
Оболочка Linux SSH
Если ваш хост имеет возможность подключения через SSH, просто залогиньтесь и измените папку psychostats куда вы до этого скопировали файлы, затем просто запустите файл ]]>stats.pl ]]>из командной строки:
./stats.pl -v
Знайте, что можно добавить в командной строке ключ '-v'. Это включит подробный ('verbose') режим и вы получите более детальный отчет о процессе обработки. Это рекомендуется сделать когда вы впервые запускаете обработку и так же вы увидите что именно происходит в процессе.
Сервер Windows
Если вы запускаете PsychoStats на вашем домашнем компьютере или на удаленном хостинге с возможностью доступа к удаленному рабочему столу, то просто откройте папку где установлен PsychoStats. Если в этой папке присутствует под-папка 'scripts', то зайдите в нее и двойным кликом мыши запустите файл 'psychostats.bat'. Это действие запустит файл stats.pl в подробном ('verbose') режиме и оставит открытым окно консоли. Это даст вам возможность увидеть ошибки, если они произошли.
Альтернативный вариант, это просто двойной клик мыши непосредственно по иконке самого файла stats.pl, но тогда вы не увидите результат и окно закроется автоматически в конце обработки файла ]]>stats.pl.]]> Поэтому будет трудно увидеть сообщения о произошедших ошибка. Тем не менее, если вы полагаете что произошла ошибка, то можете посмотреть файл stats.log в соответствующей папке (если такого файла нет, то никаких критических ошибок в процессе обработки не было).
Автоматическое планирование PsychoStats
Ну теперь, после того как вы запустили stats.pl и убедившись в том, что в вашей статистике появились игроки, вам скорее всего захочется запускать PsychoStats в автоматическом режиме. PsychoStats не имеет встроенного средства для запуска самой себя. Для этой цели нам потребуется Планировщик задач Windows (Windows Task Scheduler), или Linux CRON в зависимости от того под какой системой вы работаете.
Планировщик задач Windows
Планировщик Windows - очень функционально ограничен, но он по крайней мере позволяет запускать PsychoStats хотябы раз в день. Это означает, что с помощью него вы не добьетесь обновлений каждый час. Существуют другие программные продукты под Windows которые позволяют выполнять задания с нужной периодичностью.
Планировщик задач вы найдете в меню Пуск по следующему пути: Все программы -> Стандартные -> Служебные -> Назначенные задания
Скриншот будет добавлен позже... Ну а теперь, включите ваше воображение. Добавьте 'perl.exe' как приложение для запуска, с основным параметром 'ежедневно'. При завершении Мастера Планирования Заданий поставьте галку в чекбоксе 'Установить дополнительные параметры после нажатия кнопки "Готово" '. Когда откроется это окно, добавьте путь к вашему файлу stats.pl к концу уже существующего perl.exe. Затем сохраните задание. Если хотите запускать обновление чаще чем один раз в день, то перейдите на вкладку 'Расписание' и нажмите на кнопку 'Дополнительно...', поставьте галку 'повторять задание' и выберите нужный интервал времени.
Linux CRON
CRON - очень легок в установке, но существует несколько вариантов в зависимости от используемого вами провайдера хостинга. Например, cPanel имеет встроенный графический интерфейсa (GUI), который позволяет создавать задание непосредмтвенно через веб-браузер, но другие системы могут делать это через их оболочку. Оба варианта мы рассмотрим ниже.
Установка CRON через сPanel
cPanel имеет графический интерфейс пользователя (GUI) для установки CRON как показано на снимке слева. Это самый простой способ запланировать автоматический запуск PsychoStats. Просто внимательно посмотрите на скриншот и установите нужное время и день когда вы хотите запускать файл stats.pl. Большинство пользователей желают запускать stats.pl каждый час и здесь приведены основные рекомендации как это сделать. Продолжительность игры на одной карте в основном составляет 30-60 минут, поэтому каждый час будет обработана одна или две карты при каждом обновлении. Ваше личное дело, как часто обновлять статистику, но я не рекоммендую обновлять чаще чем 15 минут и меньше. Если вы все-таки решили обновлять статистику слишком часто, то может получится такой случай, когда первый процесс обработки еще не завершен, но уже запущен второй, которые попытаются обрабатывать одни и те же файлы, что может повредить правильной работе статистики.Установка CRON вручную
Установка CRON вручную также проста, но требуется чтобы у вас был доступ к оболочке сервера. Это означает, что сперва вы должны установить SSH на сервер. С помощью которого вы сможете использовать 'crontab' команды, чтобы добавить автоматический запуск. Если вы запустите команду 'crontab -e' то это откроет ваш редактор, назначенный по умолчанию (для большинства случаев это будет 'vi' или 'nano'). Вы должны просто ввести строку текста указанную в примере ниже, сохраните а затем закройте файл. В указанном ниже примере приведено задание, которое будет запускать обновление статистики каждый час в самом его начале. Убедитесь, что вы указали правильный путь к файлу stats.pl, именно там, где он у вас сейчас находится.
0 * * * * /home/xxxxxxxx/psychostats/stats.pl
Каждое число или звездочка (*) представляет собой время. Существует 5 разных способов настроить время, когда задание будет запущено, они приведены ниже. Большинство более подробных деталей били опущены, чтобы не загромождать пример. Если вам нужны более подробные детали и пояснения, то обратитесь к поисковым системам интернета. Из всего того, что вы видете при входе в задание, вы в основном будете использовать первый 2 поля.
Первое число представляет собой МИНУТЫ когда задание будет запущено. Символ * означает каждую минуту. В интервале 0 .. 59
Второй знак * представляет собой ЧАС когда задание будет запущено. Символ * означает каждый час. В интервале 0 .. 23.
Третий знак * представляет собой ДНИ МЕСЯЦА когда задание будет запущено. Символ * означает каждый день. В интервале 1 .. 31.
Четвертый знак * представляет собой МЕСЯЦ когда задание будет запущено. Символ * означает каждый месяц. В интервале 1 .. 12
Пятый знак * представляет собой ДЕНЬ НЕДЕЛИ когда задание будет запущено. Символ * означает каждый день. В интервале 0 .. 7
И так , если мы взглянем на наш предыдущий пример, то мы сказали программе запускаться в НОЛЬ минут, каждый час, каждый день, каждый месяц, в каждый день недели. Таким образом она будет запускаться ЕДИНОЖДЫ каждый час (как только этот час начнется).
Если мы хотим запускать stats.pl каждые 30 минут, то мы можем использовать слегка расширенную запись:
*/30 * * * * /home/xxxxxxxx/psychostats/stats.pl
или (что в принципе тоже самое):
0,30 * * * * /home/xxxxxxxx/psychostats/stats.pl
Всё готово
Поздравляю, вы все сделали правильно. Теперь вы имеете полностью функциональную статистику PsychoStats, которая автоматически обновляется.
Автор перевода: Snake60
