• Версия для печати

Скрипт: автоматическая установка ISPConfig 3 [Мануал в картинках]

Описание: Здесь размещены проекты серверных сборок и панелей управления вебхостингом
Правила раздела: Условием использования нашего форума, является соблюдение настоящих Правил форума.

Ваш вопрос может быть удален без объяснения причин, если на него есть ответы по приведённым ссылкам, а вы рискуете получить предупреждение.
Модераторы: rewuxiin, kulia

Автор
Сообщение
SinglWolf M
Автор темы
Аватара
SinglWolf M
Автор темы
Возраст: 46
Репутация: 190
Лояльность: 71
Сообщения: 1258
С нами: 5 лет 5 месяцев
Откуда: Башкирия
ICQ

#1 SinglWolf » Ср, 23 марта 2016, 13:35

Иллюстрация хода установки ISPConfig 3 скриптом autoinstall-full-4.x на примере Ubuntu 14.04


Дана иллюстрация нормального хода установки. Какие могут быть ошибки и как с ними бороться смотрите в Ошибки, связанные с запуском скрипта.
До конца установки скрипт можно запускать сколько угодно раз. Шаги, которые были успешно пройдены, в том числе приветственное окно, будут пропущены (о пропущенных шагах будет выведено на экран). Весь ход установки хорошо документирован. На экран выводится только успешное выполнение тех или иных действий. Остальное пишется в логи. Подробнее в Как мне правильно смотреть логи и что отправлять для разбора полётов, если не смог разобраться самостоятельно? И так, запуск скрипта. Описание основных шагов установки:

Приветственное окно.
Выдана всякая инфа, ну и отказ от ответственности, естественно :-D
1.png

Вариант окна приветствия, если у Вас сборка только с одной ОС
for_only_one_OS.png

Если интерфейсов несколько, будет такое окно. После выбора будет проверка на статический адрес, ну и вообще, настроен ли интерфейс.
Если интерфейс один и не настроен, дальше приветственного окна не пройдёте, предупреждаю.
2.png

Подтверждение выбора интерфейса
3.png
3.png (18.4 КБ) 1540 просмотров

В этом окне думаю всё понятно написано.
Хм, кнопка <ОСТАВИТЬ> пропала на картинке. В действительности она есть. :-)
4.png

Подтверждение.
5.png
5.png (18.5 КБ) 1540 просмотров

Как устанавливать выбор за вами. При ручном методе можно настроить мультисерверность.
6.png

Выбор WEB-сервера. Не выбирайте связку, если не знаете как с ней будет трудно работать :-D
7.png

Окно выбора плюшек, которые можно включить-отключить :-)
8.png

Подтверждение. Если что-то забыли или отметили лишнее, можно вернуться.
9.png

Если выбрали MariaDB, будет предложен выбор версии. Количество версий зависит от ОС.
Если Вы засомневались в своём выборе, предоставлена возможность установить MySQL.
10.png

Подтверждение выбора.
11.png
11.png (13.41 КБ) 1540 просмотров

Этап настройки репозиториев и обновление пакетов. Если обновилось ядро системы, скрипт автоматически перезагрузит сервер, не пугайтесь, если отлучившись увидите разрыв коннекта. Просто запустите скрипт ещё раз. :-)
12.png

Если квоты выбраны...
13.png

Окно этапов установки пакетов. Всего их 8.
14.png

Заполняем сертификат для сервера. При выборе автоматической установки панели эти данные будут использованы для создания сертификатов для панели.
15.png

Традиционное уже подтверждение.
16.png

Придумываем пароль. Пустой пароль не прокатит. :-)
17.png

Подтверждаем пароль.
18.png
18.png (22.43 КБ) 1540 просмотров

Если выбрана автоматическая установка ISPConfig 3
19.png

Запоминаем путь, указанный стрелкой, он нам будет нужен при дальнейшей настройки. Подробнее в [How To] Устанавливаем DKIM-подпись
20.png

Установка Webmin тормознутая, а вот RoundcubeMail PhpMyAdmin устанавливаются за 3 сек, даже не успел скрины сделать... :-D
21.png
21.png (14.23 КБ) 1540 просмотров

Смена стандартных портов. Стоит защита от ввода неверных данных. Проверяется занятость портов.
Сменить порты можно сколько угодно раз. Просто после установки запустите скрипт ещё раз. :-)
22.png
22.png (23.19 КБ) 1540 просмотров

Подтверждаем (Если появилось это окно, то введённые значения корректны. Зелёный цвет просто для красоты :-D )
23.png
23.png (16.19 КБ) 1540 просмотров

Нормальное завершение работы скрипта.
24.png

Всё готово! Пользуйтесь. Удачной установки! *DRINK*

Вариант окна повторного запуска скрипта после завершения установки.
Окно выбора динамическое. То есть количество пунктов зависит от некоторых факторов. Например, если у Вас уже установлен Webmin, естественно, нет смысла предлагать устанавливать его ещё раз :-D . Или у Вас сборка, например, без MultiPHP. Этой строки в меню не будет. (В разработке!)
tools.png

SinglWolf M
Автор темы
Аватара
SinglWolf M
Автор темы
Возраст: 46
Репутация: 190
Лояльность: 71
Сообщения: 1258
С нами: 5 лет 5 месяцев
Откуда: Башкирия
ICQ

Ошибки, связанные с запуском скрипта

#2 SinglWolf » Чт, 24 марта 2016, 9:51

Программу необходимо запускать через sudo или от суперпользователя root, иначе скрипт не сможет ничего установить
need_root.png

В корневом каталоге скрипта присутствуют два исполняемых файла. Скрипт знает какой ему нужен для нормальной работы :-D
wrong_run.png
wrong_run.png (15.06 КБ) 1520 просмотров

Так же скрипт не позволит Вам запустить себя более одного раза одновременно.
double_run.png

Скрипт не застрахован от случайных сбоев, о чём и сообщает
break_exit.png

Если сетевой интерфейс один и не настроен на статический адрес или поднят вручную,
Вы не продвинетесь дальше этого сообщения до тех пор пока не будет правильно настроена сеть.

network_wrong.png

Если Вы запустили скрипт на ОС, которая определяется программой, но уже или ещё не поддерживается
not_support.png

Если Вы запустили скрипт на ОС, которая отсутствует в заказанной вами сборке
not_order_OS.png

Если Вы запустили скрипт на ОС, поддержка которой не предусмотрена даже в перспективе :-)
OS_not_detect.png

Фатальные ошибки, возникающие по ходу установки ISPConfig 3 и как с ними бороться

Для начала отделим мух от котлет. :-) Разъясню какие бывают ошибки по ходу работы скрипта Autoinstall-full-4.x. Их можно разделить на несколько категорий.
1. Явная ошибка в сценарии текста скрипта. Большинство ошибок отлавливается на тестовом прогоне.
Но, бывает, что и проскочит. Посыпаю голову пеплом, не углядел *PARDON* ... Стучитесь в ЛС, аську, скайп, пишите мне на почту - решим всё на месте.
shell_break.png

2. Ошибка при установке пакетов, скачивании сторонних архивов, выполнении какой-либо системной процедуры или отсутствии библиотек на предустановленной из образа системы (грешат некоторые провайдеры VDS). К сожалению, скрипт не умеет бороться с такими ошибками и прерывает свою работу. (Хотя архивы скрипт честно пытается скачать 5 раз :-) ). Надо смотреть логи и принимать решения в зависимости от ситуации.
exit_from_error.png

Если скрипт прервёт свою ошибку по классификации 2, второй запуск остановится на таком сообщении.
Кнопка "ЛОГИ" пока не работает, ещё не решил как сделать удобнее.
previous_error.png
previous_error.png (25.31 КБ) 1513 просмотров

3. Ошибки пользователя. Я как мог старался защитить скрипт от ввода неверных данных или несанкционированных нажатий на опасные кнопки, типа Ctrl+C или Esc. При нажатии на них будут появляться предупреждающие сообщения, но скрипт не прервёт установку или предоставит Вам выбор действий. Если Вы обнаружили в какой-то ситуации, что скрипт остановил свою работу, а был не должен, напишите в тему вопросов.
4. Неявные ошибки. Самая трудноуловимая категория. Отлов занимает уйму времени, но вполне решаемы. Стучитесь в ЛС, аську, скайп, пишите мне на почту - решим.

SinglWolf M
Автор темы
Аватара
SinglWolf M
Автор темы
Возраст: 46
Репутация: 190
Лояльность: 71
Сообщения: 1258
С нами: 5 лет 5 месяцев
Откуда: Башкирия
ICQ

Как мне правильно смотреть логи и что отправлять для разбора полётов, если не смог разобраться самостоятельно?

#3 SinglWolf » Чт, 24 марта 2016, 12:47

Весь ход установки хорошо документирован. На экран выводится только успешное выполнение тех или иных действий. Остальное пишется в логи в каталог log корня скрипта. Логи разделены. Простая установочная информация пишется в файл

Код: Выделить всё

info_installXX.log
XX в имени лога счётчик запусков скрипта.

Вывод информации об ошибках (интересно, что wget пишет нормальную инфу в ошибки) сохраняется в файл

Код: Выделить всё

error_installXX.log
XX в имени лога счётчик запусков скрипта.

Вся выводимая на экран информация дублируется в лог

Код: Выделить всё

autoinstallXX.log
XX в имени лога счётчик запусков скрипта.

Некоторые спрашивают: зачем пишется этот лог? Откроешь его в текстовом файле, а там одни закорючки и нечитаемые символы... :(
Ответ простой. Не нужно его открывать в текстовом редакторе. Если вы подключаетесь к серверу удалённо каким-либо способом, то надо просто выполнить команду

Код: Выделить всё

cat autoinstallXX.log
XX в имени лога счётчик запусков скрипта.

И покрутить колесом мышки в фокусе окна клиента :-) Иногда только так удаётся отловить неуловимые баги :-[
scroll.png

Для удобства просмотра логов любое выполнение какого либо файла скрипта предваряется заголовком в info_installXX.log и error_installXX.log, пример

Код: Выделить всё

---------------------------- Секция логов для welcome.sh ----------------------------
---------------------------- Секция логов для check_network.sh ----------------------------
---------------------------- Секция логов для check_hosthame.sh ----------------------------
---------------------------- Секция логов для add.sh ----------------------------
---------------------------- Секция логов для check_repo.sh ----------------------------
---------------------------- Секция логов для get_all.sh ----------------------------

Логи info_installXX.log, error_installXX.log и autoinstallXX.log автоматически пакуются в архив log_installXX.zip
Вот этот-то архив и нужно отправлять мне на почту для разбора полётов, если Вы отчаялись что-либо понять почему не работает скрипт. :-D


Вернуться в «Проекты»

Кто сейчас на форуме (по активности за 5 минут)

Сейчас этот раздел просматривают: 1 гость