НАЗВАНИЕ

swat [-s <smb config file>] [-a] [-P]

ОПИСАНИЕ

Эта утилита является частью пакета samba(7).

swat позволяет администратору Samba комплексно конфигурировать файл smb.conf через веб браузер. Как следствие страница конфигурации swat содержит ссылки помощи ко всем конфигурационным опциям файла smb.conf позволяя администратору изменять настройки Samba быстро и просто.

swat запускается из inetd.

ПАРАМЕТРЫ

-s <smb configuration file>

Местонахождение конфигурационного файла по умолчанию задается во время компиляции. Этот файл содержит настройки конфигурации для сервера smbd(8). swat может изменять этот файл. Информация в этом файле содержит параметры конфигурации сервера, такие как использование файла printcap, а также описание всех сервисов предоставляемых сервером. Более подробно смотрите файл smb.conf. Указанный файл должен содержать конфигурационные данные, необходимые серверу. Информация из этого файла включает специфическую информацию о сервере, такую, как например определение используемого для printcap файла, также как и описания всех служб, предоставляемых этим сервером. Смотрите smb.conf для получения дополнительной информации. Стандартное имя конфигурационного файла определяется во время компиляции.

-a

Этот параметр отключит авторизацию и переведет swat в демо режим. В этом режиме любой пользователь сможет изменить файл smb.conf.

Внимание: НЕ включайте этот режим на работающем сервере.

-P

Этот параметр ограничит пользователям доступ к странице настройка паролей доступом только на чтение. swat может использоваться для смены паролей пользователей без просмотра пользователями кнопок меню "View" и "Status".

-d | --debuglevel=level

level – целое число от 0 до 10. Если ничего не задано, то значение по умолчанию равно 0.

Чем больше значение level, тем более подробным будет лог-файл. При значении, равном нулю, будут записаны только критические ошибки и серьезные предупреждения. Уровень 1 достаточен для ежедневного запуска – при нем записывается маленький объем информации о проведенных операциях.

Уровни выше 1 будут генерировать сравнительно много записей в логе и их следует использовать при столкновении с какой-либо проблемой. Уровни выше 3 введены для использования разработчиками и генерируют ОГРОМНОЕ количество данных лога, большая часть которых чрезвычайно сложно читаема.

Заметьте, что при определении этого параметра будет игнорироваться параметр log level из файла smb.conf.

-V

Напечатает номер версии программы.

-l | --log-basename=logdirectory

Имя главной директории для log/debug файлов. Будет добавлено расширение .progname (например, log.smbclient, log.smbd, и т.д.). Клиент не сможет удалить лог файл.

-h | --help

Напечатает информацию об опциях командной строки.

УСТАНОВКА

Swat включен в качестве бинарных пакетов в большинство дистрибутивов. В этом случае менеджер пакетов сам произведет настройку и установку программы. Этот раздел справки нужен если вы хотите собрать swat самостоятельно.

После компиляции SWAT вы должны запустить make install установки бинарных пакетов swat, а также страниц справки и изображений. По умолчанию установка выполнится в следующие каталоги:

/usr/local/samba/sbin/swat

/usr/local/samba/swat/images/*

/usr/local/samba/swat/help/*

Установка Inetd

Вам понадобится исправить /etc/inetd.conf и /etc/services для возможности запуска SWAT через inetd.

В /etc/services нужно добавить строку вроде:

swat 901/tcp

Заметка для пользователей NIS/YP и LDAP – вместо изменения /etc/services вам понадобится изменить настройки служб NIS.

При выборе порта для сервиса необходимо учесть что использование портов выше 1024 может привести к поблемам с безопастность сервера inetd.

В /etc/inetd.conf необходимо добавитьстроку вида:

swat stream tcp nowait.400 root /usr/local/samba/sbin/swat swat

После редактирования /etc/services и /etc/inetd.conf необходимо перезапустить вервис inetd, послав ему сигнал HUP. Чтобы сделать это выполните команду kill -1 PID, где PID это ID процесса сервиса inetd.

ЗАПУСК

Для запуска SWAT достаточно отрыть веб-браузер и указать в качестве адреса http://localhost:901/.

Обратите внимание, что вы можете подключить SWAT с любого IP сети, однако при подключении с удаленной машины соединение будет незащищенным, т. к. все пароли будут пересылаться в явном виде.

ФАЙЛЫ

/etc/inetd.conf

Этот файл должен содержать начальную информацию для мета-демона.

/etc/services

Этот файл должен содержать соответствия между именами служб (напр. swat) и их портами (напр. 901), а также тип протокола (напр. tcp).

/usr/local/samba/lib/smb.conf

файл smb.conf(5), редактируемый swat по умолчанию. Также он может находиться в /usr/samba/lib/ или в /etc/. Этот файл описывает все службы, которые сервер предоставляет клиентам.

ПРЕДУПРЕЖДЕНИЯ

swat перепишет ваш файл smb.conf(5). Записи в нем будут перегруппированы, а все комментарии удалены. Также будут удалены параметры include= и copy=. Если вы используете сложный smb.conf, то сделайте его резервную копию перед использованием swat.

ВЕРСИЯ

Эта страница мануала верна для пакета Samba версии 3.

СМ. ТАКЖЕ

inetd(8), smbd(8), smb.conf(5).

АВТОР

Изначально Samba и сопутствующие утилиты были разработаны Эндрю Тридгеллом (Andrew Tridgell). Сейчас Samba разрабатывается Samba Team в качестве Open Source проекта – напоминает то, как разрабатывается ядро Linux.

Изначально страницы man поддерживал Karl Auer. Исходные коды страниц man конвертировались в формат YODL (доступно здесь yodl.sourceforge.net) и обновлялись для релизов Samba 2.0 Jeremy Allison. Переведено в формат DocBook для Samba 2.2 Джерардом Картером (Gerald Carter). Переведено в формат XML 4.2 для Samba 3.0 Александром Боковым.

Перевод на русский язык Айзятуллен Рамиль, Айзятуллен Ренат.

Обсудить данный перевод можно в соответствующей ветке форума.