FAQ GameAP: различия между версиями

Материал из HLDM Wiki
Перейти к навигации Перейти к поиску
 
(не показана 21 промежуточная версия этого же участника)
Строка 1: Строка 1:
 
[[Категория:АдминПанель]]
 
[[Категория:АдминПанель]]
 +
[[Категория:Документация_GameAP]]
  
== Как установить панель управления?  ==
+
== Информация ==
 +
 
 +
=== Умеет ли панель поднимать упавшие и зависшие серверы? ===
 +
Да. Только для этого необходимо настроить выполнение cron задания раз в 5-10 минут.
 +
*/5 * * * * php -f /path/to/adminpanel/index.php cron
 +
 
 +
== Установка и конфигурация ==
 +
 
 +
=== Как установить панель управления?  ===
 
* Для установки панели нужно скопировать содержимое папки upload из архива с панелью в директорию на сервере.
 
* Для установки панели нужно скопировать содержимое папки upload из архива с панелью в директорию на сервере.
 
* Запустить установку панели, для этого перейти по адресу site.ru/install
 
* Запустить установку панели, для этого перейти по адресу site.ru/install
 +
 +
Примечание. При отключенном .htaccess и mod_rewrite, для установки панели нужно перейти по адресу site.ru/index.php?install, или site.ru/?install
 +
 
[[АдминПанель:Установка|Подробнее об установке панели GameAP]]
 
[[АдминПанель:Установка|Подробнее об установке панели GameAP]]
  
== После установки при переходе на страницу auth/in появляется 404 ошибка  ==
+
=== Как отключить .htaccess и mod_rewrite в панели?  ===
 +
Открываем файл "application/config/config.php"
 +
 
 +
Устанавливаем следующие значения параметрам:
 +
$config['index_page'] = 'index.php';
 +
$config['uri_protocol'] = 'QUERY_STRING';
 +
$config['enable_query_strings'] = TRUE;
 +
 
 +
=== Для чего нужны SSH модули? ===
 +
Для управления удаленными игровыми серверами. Т.е. серверами, которые расположены не на том-же компьютере, что и панель.
 +
Требуется модуль php_ssh2 и настроенный ssh server на удаленной машине.
 +
 
 +
Установка php_ssh2:
 +
pecl install -f ssh2
 +
 
 +
Установка ssh:
 +
sudo apt-get install ssh
 +
 
 +
=== Обязательно ли настраивать выполнение cron заданий? ===
 +
Нет. Но без них не будут работать следующие функции админпанели:
 +
* Задания для серверов;
 +
* Автоматическая смена ркон пароля, в случае смены его злоумышленником;
 +
* Установка игровых серверов;
 +
* Перезапуск серверов в случае зависания или падения.
 +
 
 +
=== Я потерял секретный ключ, и доступ к серверам теперь невозможен. Можно ли как-то восстановить пароли? ===
 +
Для шифрования паролей используется один из самых криптостойких алгоритмов - AES 256. Без секретного ключа этого сделать практически невозможно.
 +
 
 +
=== Как включить режим отладки ===
 +
 
 +
Для этого откройте файл index.php в корневой директории с GameAP и измените
 +
define('ENVIRONMENT', 'production');
 +
на
 +
define('ENVIRONMENT', 'development');
 +
 
 +
== Баги и ошибки ==
 +
 
 +
=== При запуске сервера говорит, что директория не найдена, хотя она существует ===
 +
 
 +
* Проверьте путь более внимательнее. Нужно указывать абсолютный серверный путь, а не относительно различных домашних директорий (FTP и т.п.)
 +
* Если сервер локальный, то возможно включен open_basedir и он не включает в себя путь с содержимым серверов. Добавьте путь в open_basedir, либо отключите его.
 +
Для отключения open_basedir в apache2 откройте файл с виртуальным хостом, например 000-default
 +
sudo nano /etc/apache2/sites-enabled/000-default
 +
и добавьте следующий параметр, либо измените существующий.
 +
php_admin_value open_basedir none
 +
 
 +
=== Появилась ошибка 'Failed to set the tmp directory' ===
 +
 
 +
Есть несколько вариантов решения этой проблемы.
 +
Добавьте временную директорию (/tmp для Linux, C:\Windows\Temp для Windows) в open_basedir.
 +
 
 +
Кроме того, панель будет пробовать использовать в качестве временной директории '''application/cache''' и '''tmp''' директорию относительно своей корневой директории.
 +
Установите права 777 на '''application/cache''' либо создайте '''tmp''' директорию и установите на нее 777 права.
 +
 
 +
=== После установки при переходе на страницу auth/in появляется 404 ошибка  ===
 
Подобная ошибка появляется при выключенном mod_rewrite либо .htaccess
 
Подобная ошибка появляется при выключенном mod_rewrite либо .htaccess
  
Строка 22: Строка 88:
 
После проделанного не забудьте перезагрузить Apache сервер
 
После проделанного не забудьте перезагрузить Apache сервер
 
  sudo service apache2 restart
 
  sudo service apache2 restart
 +
 +
Если не помогло, то откройте файл '''application/config/config.php''', и параметру '''$config['uri_protocol']''' установите значение AUTO, либо один из следующих значений - AUTO, PATH_INFO, REQUEST_URI, ORIG_PATH_INFO.
  
 
Если ничего не помогает, то попробуйте установить права 755 либо 777 для директории с панелью.
 
Если ничего не помогает, то попробуйте установить права 755 либо 777 для директории с панелью.
 
  
== Для чего нужны SSH модули? ==
+
Есть возможность обойтись без .htaccess и mod_rewrite, об этом читайте здесь.
Для управления удаленными игровыми серверами. Т.е. серверами, которые расположены не на том-же компьютере, что и панель.
+
 
Требуется модуль php_ssh2 и настроенный ssh server на удаленной машине.
+
=== Игровой сервер не запускается, что делать? ===
 +
Есть множество причин, из-за чего может не запуститься игровой сервер, более подробно об этом написано в разделе [[АдминПанель:Решение_проблем_с_запуском_серверов]]
 +
 
 +
=== Форма входа не имеет стиля, а при входе отображается 404 ошибка ===
 +
Если при переходе на главную страницу отображается что-то вроде этого:
 +
[[Файл:Gameap_nostyle.png|center|Нет стиля]]
 +
а после ввода данных, появляется ошибка 404
 +
[[Файл:Gameap_404.png|center|GameAP 404 ошибка]]
 +
 
 +
В этом случае проверьте адрес сайта, указанных в конфигурации - файл '''application/config/config.php''', параметр '''$config['base_url']''', сайт должен содержать http:// и слеш в конце, например http://hldm.org/, http://demo.gameap.ru/, http://localhost/game_panels/gameap/
  
Установка php_ssh2:
+
=== Отображается пустой лист при переходе на определенную страницу ===
pecl install -f ssh2
+
Скорее всего это ошибка связана с веб-сервером и php. Чтобы отобразить ошибку, необходимо [[АдминПанель:FAQ#Как_включить_режим_отладки|включить режим отладки]]
  
Установка ssh:
+
=== Игровой сервер не устанавливается ===
sudo apt-get install ssh
 
  
== Умеет ли панель поднимать упавшие и зависшие серверы? ==
+
* Проверьте, запущен и выполняется cron. Подробнее о настройке cron - [[АдминПанель:Установка#Настройка_cron]];
Да. Только для этого необходимо настроить выполнение cron задания раз в 5-10 минут.
+
* Проверьте указанные пути к [[SteamCMD]], если установка выполняется через него;
*/5 * * * * php -f /path/to/adminpanel/index.php cron
+
* Проверьте права на выполнение файла steamcmd.sh;
 +
* Посмотрите логи установки, они должны быть на странице управления сервером. В логах обычно имеется команда, которая была отправлена на выделенный сервер, введите эту команду вручную и посмотрите результат.
  
== Обязательно ли настраивать выполнение cron заданий? ==
+
В некоторых случаях при установке может отобразиться ошибка
Нет. Но без них не будут работать следующие функции админпанели:
+
Unable to determine CPU Frequency. Try defining CPU_MHZ
* Задания для серверов;
+
Чтобы ошибка не появлялась, выполните
* Автоматическая смена ркон пароля, в случае смены его злоумышленником;
+
export CPU_MHZ=2000
* Установка игровых серверов;
+
- где 2000 - частота процессора
* Перезапуск серверов в случае зависания или падения.
 
  
== Игровой сервер не запускается, то делать? ==
+
{{Категория:Документация_GameAP}}
Есть множество причин, из-за чего может не запуститься игровой сервер, более подробно об этом написано в разделе [[Решение проблем с запуском серверов]]
 

Текущая версия на 12:29, 15 мая 2014


Информация

Умеет ли панель поднимать упавшие и зависшие серверы?

Да. Только для этого необходимо настроить выполнение cron задания раз в 5-10 минут.

*/5 * * * * php -f /path/to/adminpanel/index.php cron

Установка и конфигурация

Как установить панель управления?

  • Для установки панели нужно скопировать содержимое папки upload из архива с панелью в директорию на сервере.
  • Запустить установку панели, для этого перейти по адресу site.ru/install

Примечание. При отключенном .htaccess и mod_rewrite, для установки панели нужно перейти по адресу site.ru/index.php?install, или site.ru/?install

Подробнее об установке панели GameAP

Как отключить .htaccess и mod_rewrite в панели?

Открываем файл "application/config/config.php"

Устанавливаем следующие значения параметрам:

$config['index_page'] = 'index.php';
$config['uri_protocol']	= 'QUERY_STRING';
$config['enable_query_strings'] = TRUE;

Для чего нужны SSH модули?

Для управления удаленными игровыми серверами. Т.е. серверами, которые расположены не на том-же компьютере, что и панель. Требуется модуль php_ssh2 и настроенный ssh server на удаленной машине.

Установка php_ssh2:

pecl install -f ssh2

Установка ssh:

sudo apt-get install ssh

Обязательно ли настраивать выполнение cron заданий?

Нет. Но без них не будут работать следующие функции админпанели:

  • Задания для серверов;
  • Автоматическая смена ркон пароля, в случае смены его злоумышленником;
  • Установка игровых серверов;
  • Перезапуск серверов в случае зависания или падения.

Я потерял секретный ключ, и доступ к серверам теперь невозможен. Можно ли как-то восстановить пароли?

Для шифрования паролей используется один из самых криптостойких алгоритмов - AES 256. Без секретного ключа этого сделать практически невозможно.

Как включить режим отладки

Для этого откройте файл index.php в корневой директории с GameAP и измените

define('ENVIRONMENT', 'production');

на

define('ENVIRONMENT', 'development');

Баги и ошибки

При запуске сервера говорит, что директория не найдена, хотя она существует

  • Проверьте путь более внимательнее. Нужно указывать абсолютный серверный путь, а не относительно различных домашних директорий (FTP и т.п.)
  • Если сервер локальный, то возможно включен open_basedir и он не включает в себя путь с содержимым серверов. Добавьте путь в open_basedir, либо отключите его.

Для отключения open_basedir в apache2 откройте файл с виртуальным хостом, например 000-default

sudo nano /etc/apache2/sites-enabled/000-default

и добавьте следующий параметр, либо измените существующий.

php_admin_value open_basedir none

Появилась ошибка 'Failed to set the tmp directory'

Есть несколько вариантов решения этой проблемы. Добавьте временную директорию (/tmp для Linux, C:\Windows\Temp для Windows) в open_basedir.

Кроме того, панель будет пробовать использовать в качестве временной директории application/cache и tmp директорию относительно своей корневой директории. Установите права 777 на application/cache либо создайте tmp директорию и установите на нее 777 права.

После установки при переходе на страницу auth/in появляется 404 ошибка

Подобная ошибка появляется при выключенном mod_rewrite либо .htaccess

Для включения mod_rewrite выполните следующее:

sudo a2enmod rewrite
sudo gedit /etc/apache2/sites-enabled/000-default

После этого нужно заменить значение

AllowOverride None

на

AllowOverride All

Для включение .htaccess откройте файл /etc/apache2/sites-available и для директории установите значение:

AllowOverride All

После проделанного не забудьте перезагрузить Apache сервер

sudo service apache2 restart

Если не помогло, то откройте файл application/config/config.php, и параметру $config['uri_protocol'] установите значение AUTO, либо один из следующих значений - AUTO, PATH_INFO, REQUEST_URI, ORIG_PATH_INFO.

Если ничего не помогает, то попробуйте установить права 755 либо 777 для директории с панелью.

Есть возможность обойтись без .htaccess и mod_rewrite, об этом читайте здесь.

Игровой сервер не запускается, что делать?

Есть множество причин, из-за чего может не запуститься игровой сервер, более подробно об этом написано в разделе АдминПанель:Решение_проблем_с_запуском_серверов

Форма входа не имеет стиля, а при входе отображается 404 ошибка

Если при переходе на главную страницу отображается что-то вроде этого:

Нет стиля

а после ввода данных, появляется ошибка 404

GameAP 404 ошибка

В этом случае проверьте адрес сайта, указанных в конфигурации - файл application/config/config.php, параметр $config['base_url'], сайт должен содержать http:// и слеш в конце, например http://hldm.org/, http://demo.gameap.ru/, http://localhost/game_panels/gameap/

Отображается пустой лист при переходе на определенную страницу

Скорее всего это ошибка связана с веб-сервером и php. Чтобы отобразить ошибку, необходимо включить режим отладки

Игровой сервер не устанавливается

  • Проверьте, запущен и выполняется cron. Подробнее о настройке cron - АдминПанель:Установка#Настройка_cron;
  • Проверьте указанные пути к SteamCMD, если установка выполняется через него;
  • Проверьте права на выполнение файла steamcmd.sh;
  • Посмотрите логи установки, они должны быть на странице управления сервером. В логах обычно имеется команда, которая была отправлена на выделенный сервер, введите эту команду вручную и посмотрите результат.

В некоторых случаях при установке может отобразиться ошибка

Unable to determine CPU Frequency. Try defining CPU_MHZ

Чтобы ошибка не появлялась, выполните

export CPU_MHZ=2000 

- где 2000 - частота процессора