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

[SinglWolf]

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

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

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

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

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

Подтверждение выбора интерфейса

3.png (18.4 КБ) 5634 просмотра

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

Подтверждение.

5.png (18.5 КБ) 5634 просмотра

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

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

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

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

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

Подтверждение выбора.

11.png (13.41 КБ) 5634 просмотра

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

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

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

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

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

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

Подтверждаем пароль.

18.png (22.43 КБ) 5634 просмотра

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

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

Установка Webmin тормознутая, а вот RoundcubeMail PhpMyAdmin устанавливаются за 3 сек, даже не успел скрины сделать...

21.png (14.23 КБ) 5634 просмотра

Смена стандартных портов. Стоит защита от ввода неверных данных. Проверяется занятость портов.
Сменить порты можно сколько угодно раз. Просто после установки запустите скрипт ещё раз.

22.png (23.19 КБ) 5634 просмотра

Подтверждаем (Если появилось это окно, то введённые значения корректны. Зелёный цвет просто для красоты )

23.png (16.19 КБ) 5634 просмотра

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

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

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

[SinglWolf]

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

В корневом каталоге скрипта присутствуют два исполняемых файла. Скрипт знает какой ему нужен для нормальной работы

wrong_run.png (15.06 КБ) 5614 просмотров

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

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

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

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

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

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

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

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

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

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

previous_error.png (25.31 КБ) 5607 просмотров

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

[SinglWolf]

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

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

info_installXX.log

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

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

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

error_installXX.log

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

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

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

autoinstallXX.log

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

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

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

cat autoinstallXX.log

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

И покрутить колесом мышки в фокусе окна клиента Иногда только так удаётся отловить неуловимые баги

Для удобства просмотра логов любое выполнение какого либо файла скрипта предваряется заголовком в 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
Вот этот-то архив и нужно отправлять мне на почту для разбора полётов, если Вы отчаялись что-либо понять почему не работает скрипт.