Официальный блог EasyCoding

Введение

В данном HOWTO будет подробно рассказано как работать с самым популярным SVN-клиентом под Windows: скачивать и обновлять репозитарии, создавать теги и ветки проекта, коммитить (публиковать) свою рабочую копию, откатывать сделанные изменения и многое другое.

Где можно скачать программу

Скачать программу можно на её официальном сайте на странице Downloads: http://tortoisesvn.net/downloads. Там же можно скачать пакет локализации, содержащий помимо перевода интерфейса программы, ещё и словарь проверки орфографии (применяется при коммите изменений (см. ниже)).

Программа TortoiseSVN интегрируется в Проводник Windows (Windows Explorer) и все действия с ней выполняются из контекстного меню каталогов (папок).

Начнём с самого простого – скачивания одного из репозитариев на свой компьютер.

Скачивание репозитария SVN (Checkout)

Если Вы хотите скачать репозитарий какого-нибудь проекта, то Вы должны знать его URL, а также логин и пароль для доступа (если не указаны, то для анонимного доступа (только чтение) используется логин и пароль anonsvn). URL’ы могут быть:

• стандартный svn:// – подключение напрямую к Subversion-серверу;
• http:// – подключение к Subversion-серверу через веб (так работает большинство серверов, т.к. позволяет просматривать проект не имея SVN-клиента напрямую через веб-браузер);
• https:// – то же, что и http://, но через SSL;
• svn+ssh:// – svn через SSH (редко используется в настоящее время).

Допустим, что URL нам известен, поэтому чтобы скачать репозитарий, мы должны сделать следующее:

1. Создаём папку, в которую будем скачивать репозитарии (для удобства лучше хранить все репозитарии в одной папке, например, C:\SVN).
2. Заходим в неё в проводнике Windows, нажимаем правой кнопкой мыши по свободному месту и выбираем “SVN Checkout…“.
3. В поле “URL of repository” пишем полный URL до репозитория SVN, который нам нужно скачать, а в поле “Checkout directory” корректируем путь, в которой будет помещена локальная копия. Внимание! Вам нужно делать checkout только каталога /trunk/ svn-репозитария, либо корневого, если /trunk/ не существует (очень редко, т.к. в 99% репозитариев trunk существует и содержит всегда самую последнюю версию файлов).
4. В списке “Checkout Depth” укажите “Fully recursive“, что означает, что будет скачан весь репозитарий от указанного пути. Если установить флажок “Omit externals“, то внешние файлы, на которые есть ссылки в репозитарии (например, из других репозитариев, либо репозитариев третьих лиц), скачаны не будут, поэтому ставить флажок здесь не рекомендуется.
5. В блоке “Revision” Вы можете запросить выдать Вам последнюю версию репозитария: “HEAD revision” (рекомендуется именно этот вариант), либо указанную Вам в поле ревизию: “Revision ###” (не рекомендуется).
6. Кнопка “Show log” покажет Вам список изменений в репозитарии с информацией об авторах каждого изменения, описании изменений (если авторы их вводили при коммите изменений), а также списке добавленных, изменённых и удалённых файлов. Здесь же можно просмотреть чем файл одной ревизии (версии) отличается от файла другой, а также запросить показать унифицированный diff-файл изменений либо нескольких файлов, либо нескольких ревизий (отображается только для текстовых файлов). Более подробную информацию о Log Viewer читайте ниже.
7. Нажимаем кнопку “OK” и ждём скачивания репозитария с Subversion-сервера (зависит от скорости Вашего Интернет-соединения, а также от загруженности svn-сервера). Внимание! Некоторые svn-серверы могут запросить пароль. Если Вы не знаете пароля, то вводите anonsvn как логин и пароль. Это стандартный логин/пароль для анонимного доступа. Если Вы хотите в дальнейшем публиковать свои изменения в этот репозитарий и у Вас есть на это право, то введите здесь свой логин и пароль.
8. Готово. В каталоге, который Вы указали на третьем шаге в поле “Checkout directory” теперь находится локальная версия репозитария (рабочая копия).

Обновление скачанного репозитария (Update)

SVN и создавался для удобного управления проектам, а также поддержания их в актуальном состоянии, поэтому вторая по значимости операция – обновления скачанной рабочей копии. Рекомендуется как можно чаще обновлять свои рабочие копии. При обновлении скачиваются только изменённые файлы, добавляются новые и удаляются удалённые из репозитария файлы. Итак, чтобы обновить рабочую копию, нужно:

1. Заходим в папку, в которой находятся файлы скачанной рабочей копии в Проводнике Windows.
2. Нажимаем правой кнопкой по свободному месту в папке, выбираем “SVN Update“.
3. В открывшемся окне наблюдаем за процессом обновления: списком добавленных, изменённых и/или удалённых файлов, текущим номером версии. Здесь же можно нажать кнопку “Show log…” чтобы просмотреть список, прочитать описание изменений (если указано), сравнить текущую версию с предыдущей и т.д.
4. Нажмите “OK” чтобы закрыть это окно. Репозитарий обновлён до последней версии.

Сохранение своих изменений в репозитарий (Commit)

Если Вы хотите внести свои изменения в скачанный репозитарий и у Вас есть на это право (право коммита в репозитарий), то просто начинайте работать с локальной рабочей копией как с обычной папкой: создавайте, редактируйте, удаляйте файлы и/или папки. Теперь чтобы внести изменения в репозитарий, нужно:

1. Заходим в папку, в которой находятся файлы скачанной рабочей копии в Проводнике Windows. Внимание! Рабочая копия должна быть скачана от логина пользователя, у которого есть право на коммит изменений (коммит-флаг).
2. Нажимаем правой кнопкой по свободному месту в папке, выбираем “SVN Commit…“.
3. В открывшемся окне “Commit” в секции “Message” вводим краткое описание своих изменений (это рекомендуется делать всегда, особенно если не Вы один работаете над проектом), но описание можно и оставить пустым (не рекомендуется, т.к. другие разработчики или пользователи не смогут понять что именно было изменено). В этом поле разрешено использовать буквы национальных алфавитов (присутствует полная поддержка юникода), но, к сожалению, некоторые веб-клиенты svn (отображающие в браузере список изменений) вместо русских букв отображают кракозябры. TortoiseSVN лишён этого недостатка.
4. В секции “Changes made (double-click on file for diff)” Вы увидите список всех изменённых, добавленных и удалённых Вами файлов локальной рабочей копии. У изменённых файлов будут автоматически стоять флажки, у остальных – нет. Установите флажки у тех файлов, изменения которых должны быть загружены на svn-сервер (есть флажок – файл обновляется, добавляется, удаляется; нет флажка – остаётся без изменений). Двойной щелчок по файлу запустит утилиту Tortoise Merge (предназначена для сравнения версий файлов), которая покажет последнюю версию файла из репозитария SVN в левом окне и текущую рабочую копию в правом. Изменения будут выделены: удалённые строки зачёркнуты, добавленные выделены.
5. После выделения нужных файлов или всех сразу (“Select / deselect all“), нажмите кнопку “OK” и дождитесь окончания загрузки изменений на сервер. Будет открыто окно со списком добавленных, изменённых и/или удалённых файлов, а также указан текущий номер ревизии.

Работа с репозитарием напрямую на сервере

Иногда требуется работать с svn-репозитарием напрямую на сервере не скачивая его на локальный компьютер. Для этих целей существует утилита “SVN Repo-browser“, также входящая в состав TortoiseSVN. Работать с ней очень просто:

1. Запускаем проводник Windows, заходим в любую папку, нажимаем правой кнопкой по свободному месту и выбираем “SVN Repo-browser“.
2. В открывшемся окне “URL” вводим полный URL нужного нам svn-репозитария и нажимаем “OK“.
3. Будет открыто главное окно утилиты: “%URL% – Repository Browser“, где %URL% – URL репозитария. Работать в этом окне можно так же, как в Проводнике Windows. Разрешено перетаскивание объектов (Drag and Drop). Через контекстное меню файла/папки можно:
   • удалять “Delete…“, переименовывать “Rename” файлы и каталоги (папки);
   • добавить файл (“Add file…“) или папку (“Add folder…“) в репозитарий;
   • создать пустую папку (“Create folder“) в репозитарии;
   • скачать (“Checkout…“) репозитарий (см. выше);
   • извлечь файл или папку из репозитария без служебных каталогов (“Export…“). Извлечённая папка отличается от рабочей копии тем, что её нельзя обновлять и она не содержит служебных скрытых каталогов .svn;
   • создать ветку или тег (“Copy to…“);
   • изменять свойства файла или папки (“Show properties“).
4. Любое изменение требует ввести текст комментария (разрешается не вводить и оставить поле пустым) и увеличивает номер ревизии на единицу. Изменения применяются немедленно.
5. Нажмите кнопку “OK” для выхода из Repository Browser.

Создание веток или меток внутри репозитария

Если Вы работаете над большим проектом, то желательно для каждой публичной стабильной версии (1.0, 1.1, 2.0 и т.д.) создавать отдельный тег, например, /tags/RELEASE-Mj.Mn, где Mj – Major-версия, а Mn – Minor-версия проекта. Пример: /tags/RELEASE-1.0 (для версии 1.0), /tags/RELEASE-2.63 (для версии 2.63) и т.д. Внимание! Теги создаются НЕ в каталоге /trunk/, а выше него на один уровень! Чтобы создать метку или ветвление, нужно (у Вас должно быть право коммита в репозитарий для создания меток или ветвлений):

1. Заходим в папку, в которой находятся файлы скачанной рабочей копии в Проводнике Windows.
2. Нажимаем правой кнопкой по свободному месту и выбираем “TortoiseSVN” – “Branch/tag…“.
3. В открывшемся окне в поле “To URL” введите полный URL с путём до нового тега. Пример: http://ваш_проект.svn.sourceforge.net/tags/RELEASE-1.0 (это только пример; пути должны указывать на Ваш проект).
4. В секции “Create copy in the repository from” укажите “HEAD revision in the repository” (последняя ревизия; рекомендуется), либо укажите номер ревизии вручную, выбрав “Specific revision in the repository ###“, либо создайте тег из текущей рабочей копии “Working copy” (не рекомендуется).
5. В секции “Log message” укажите комментарий к ревизии (например, %НАЗВАНИЕ_ПРОЕКТА% %ВЕРСИЯ_ПРОЕКТА% Released).
6. Нажмите “OK“. Флажок в строке “Switch working copy to new branch/tag” ставить не рекомендуется, т.к. это переключит Вашу текущую рабочую копию на новый путь, что может привести к различным ошибкам и проблемам.

Откат изменений в рабочей копии

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

1. Заходим в папку, в которой находятся файлы скачанной рабочей копии в Проводнике Windows.
2. Нажимаем правой кнопкой по свободному месту и выбираем “TortoiseSVN” – “Revert…“.
3. В открывшемся окне Вы увидите список всех изменённых файлов Вашей рабочей копии. Установите флажок у того файла, который Вы хотите откатить до версии из репозитария, либо выберите сразу все файлы (“Select / deselect all“). Двойной щелчок по файлу покажет его отличия от оригинального файла.
4. Нажмите “OK“. Выбранные файлы будут восстановлены, а изменённые будут отправлены в Корзину Windows.

Работа с утилитой Log Viewer

Утилита Log Viewer, запускаемая после нажатия на кнопку “Show log…“, либо при нажатии правой кнопкой по свободному месту в локальной рабочей копии – “TortoiseSVN” – “Show log“. По умолчанию утилита показывает последние 50 ревизий и их описаний (если во время коммита они были введены). Все основные действия выполняются из контекстного меню ревизии:

• “Compare with woking copy” – сравнить текущую (выделенную) ревизию с локальной рабочей копией. Список изменений будет показан в Tortoise Merge.
• “Show changes as unified diff” – показать изменения выделенных ревизий как унифицированный патч-файл (unified diff). Если выделена только одна ревизия, то она будет сравниваться с предыдущей (например, выделена ревизия 87, она будет сравниваться с 86).
• “Compare with previous revision” – показать изменения выделенной и предыдующей ревизии. Будет отображено окно с различающимися файлами, двойной щелчок по файлу откроет его в Tortoise Merge для просмотра изменений.
• “Compare and blame with previous revision” – то же, что и предыдущее, но здесь отображается кто и когда внёс какое-либо изменение в файл построчно.
• “Browse repository” – открывает описанный выше Repository Browser для прямой работы с репозитарием.
• “Create branch/tag from revision” – позволяет создать ветку или тег из выделенной ревизии (см. выше).
• “Update item to revision” – обновляет до выделенной ревизии.
• “Revert to this revision” – позволяет откатиться до выделенной ревизии.
• “Revert changes from this revision” – позволяет откатить все изменения, сделанные в выделенной ревизии.
• “Merge revisions to…” – позволяет объединить несколько ревизий в рабочую копию.
• “Checkout…” – скачать выделенную ревизию (см. выше).
• “Export…” – извлечь выделенную ревизию без служебных каталогов.
• “Edit author” – редактировать имя автора выделенной ревизии (нужны права администратора).
• “Edit log message” – позволяет редактировать текст описания выделенной ревизии (нужны права администратора).
• “Show revision properties” – показать свойства выделенной ревизии.
• “Copy to clipboard” – скопировать номер выделенной ревизии, автора, описание и список изменённых файлов в буфер обмена Windows.
• “Search log messages” – запустить поиск в описаниях ревизий.

Кнопка “Show all” покажет все ревизии, а “Show range…” позволит задать диапазон ревизий, которые будут отображаться в окне Log Viewer.

Кнопка “Statistics” отображает различную статистическую информацию: наиболее активный и наименее активный автор, количество изменений в репозитарии в неделю, общее количество изменений и т.д.

Вступление

По многочисленным просьбам я решил написать подробное HOWTO по установке и настройке слушающего сервера Garry’s Mod прямо из приложения. Что нам потребуется для работы:

1. Сам Garry’s Mod (лицензионная Steam-версия).
2. Набор для установки плагинов нашего производства (можете пропустить, если хотите устанавливать плагины вручную).
3. Любой текстовый редактор для редактирования конфигов.

В отличие от слушающих серверов других Source-приложений, слушающий сервер Garry’s Mod по функциональности практически ничем не отличается от Dedicated Server’а. Общие черты слушающего и выделенного сервера Garry’s Mod:

• позволяет устанавливать любые lua-модификации и плагины в каталог /addons/;
• позволяет установить плагины для администрирования сервера и права администраторов (Garry’s Mod – единственный слушающий сервер, в котором создатель может быть не администратором).

Различия между слушающим и выделенным сервером Garry’s Mod:

• при выходе из игры создателя, сервер автоматически отключается, а все играющие будут кикнуты с сообщением “Server is shutting down“;
• позволяет одновременно хостить сервер и находиться на нём;
• все настройки слушающего сервера хранятся в файле listenserver.cfg, а выделенного – server.cfg.

Преимущества слушающего сервера Garry’s Mod:

• слушающий сервер не требует особых усилий для его развёртывания и настройки: достаточно установить нужные плагины, админку, файл конфигурации и можно приглашать на него своих друзей;
• слушающий сервер идеален для работы/игры на нём нескольких человек (Вы и Ваши друзья например);
• позволяет быстро переконфигурировать, перезапустить, остановить и т.д. сервер;
• не нужно качать несколько гигабайт абсолютно ненужных данных выделенного сервера;
• обновляется полностью автоматически.

Техническая часть

1. Чтобы к Вам могли подключаться клиенты, Вы должны иметь “белый” IP-адрес, т.е. видимый из Интернета. Создание сервера с “серым” IP, либо с жёстким NAT’ом провайдера не имеет смысла, т.к. подключиться к такому серверу никто не сможет (кроме находящихся с вами в одной подсети).
2. Сервер запускается на порту 27015, поэтому если у Вас ADSL, вы должны пробросить этот порт по протоколу UDP в настройках своего роутера (модема). Обычно проброс портов настраивается в веб-интерфейсе роутера в разделе NAT – Port Forwarding или NAT – Virtual Servers.
3. На сервере главное – скорость отдачи от Вас клиентам, а также мощность процессора Вашего компьютера. На ADSL максимальная отдача может составлять около 780 Кбит/с – 1 МБит/с (на ADSL с модуляцией AnnexM (такая разновидность встречается крайне редко) – 3 Мбит/с). Если у Вас тариф на 256 КБит/с, то к Вам могут подключиться 6 клиентов. Если 512 – 10-12 клиентов, если 1 Мбит и более (ADSL) – 18 клиентов, кабель без NAT – 23 клиента (максимум для слушающего сервера). В соотвествие с этими параметрами Вы должны настроить значение переменной “Максимальное число игроков” во время создания сервера. Если Ваш канал или процессор не будут выдерживать такое количество подключившихся игроков, у всех появятся лаги.

Внимание! Не создавайте сервер на большое количество пользователей, т.к. современный компьютер вряд-ли потянет более 12-15 одновременно работающих пользователей, активно работающих с Wire, Stargate и т.п. из-за того, что Garry’s Mod до сих пор не поддерживает мультипоточность. Также в настройках сервера или файле конфигурации listenserver.cfg не забудьте указать максимальное количество объектов, элементов, NPC и т.д., которые может создать один пользователь. Если здесь будут стоять огромные числа (как по умолчанию в 200), то это может подвергнуть Ваш сервер серьёзным лагам. В нашем конфиге уже установлены оптимальные значения всех настроек, а NPC выключены вообще.

Настройка и запуск сервера

1. Устанавливаем Steam и Garry’s Mod (если ещё не установлены).
2. Запускам Garry’s Mod, ждём полной загрузки и выходим из неё (это нужно только если выполнялся шаг 1 для создания файлов базовой конфигурации).
3. Запускаем Garry’s Mod, нажимаем “Создать сервер” (“Create Server“), набираем команду status в консоли, записываем её вывод например в буфер обмена (выделяем выданный сервером текст, нажимаем правой кнопкой – “Копировать“), либо на бумагу и выходим из Garry’s Mod.
4. Устанавливаем джентльменский набор плагинов из svn для Garry’s Mod, так, как описано в этой статье. Всю информацию по установке и сами скрипты установки/обновления плагинов Вы найдёте по этой ссылке.
5. Делаем себя и, если нужно, своих друзей администраторами свежесозданного сервера (обязательно, иначе ULX-админка не даст Вам доступа). Чтобы сделать себя админом, нужно:
   • узнать Ваш личный SteamID и, если хотите сделать и друзей админами (не рекомендуется ), то и их SteamID. Как это сделать описано на 3 шаге;
   • в любом текстовом редакторе открываем файл %Steam%\steamapps\ВАШ_ЛОГИН\garrysmod\garrysmod\settings\users.txt, где %Steam% – путь к установленному клиенту Steam, а ВАШ_ЛОГИН – Ваш логин для входа в Steam. В этот файл и прописываются администраторы сервера по SteamID. Ищем в этом файле раздел “superadmin” и после строки //”garry” “STEAM_0:1:7099″ жмём Enter (начинаем новую строку) и пишем свою в виде “ВАШ_НИК” “STEAM_0:1:XXXXXXXXX”, где ВАШ_НИК – это ник админа, который будет в списке вывода админов сервера (здесь разрешено вводить только латинские буквы и цифры без пробелов; кавычки обязательны), а STEAM_0:1:XXXXXXXXX – это Ваш SteamID (замените на настоящий, естественно ), полученный на 3 шаге. Здесь же после этой строчки может добавить и своих друзей (но я бы не рекомендовал этого делать; одного админа вполне достаточно).
6. Качаем и распаковываем архив с файлами конфигурации в папку %Steam%\steamapps\ВАШ_ЛОГИН\garrysmod\garrysmod\cfg\, где %Steam% – путь к установленному клиенту Steam, а ВАШ_ЛОГИН – Ваш логин для входа в Steam. Заменяем имеющиеся файлы. Архив обновляется после выхода серьёзных изменений в Garry’s Mod, а также при обнаружении ошибок и для добавления новых функций.
7. Открываем распакованный файл listenserver.cfg в любом текстовом редакторе (например, в Блокноте Windows) и делаем нужные настройки (меняем имя сервера (переменная hostname), настройки и т.п.). В файле я всё подробно описал какая переменная чем управляет, что включает/выключает, поэтому на этом я останавливаться не буду здесь. Внимание! Первым делом задайте пароль вместо !!!CHANGEME!!!, иначе Ваш сервер могут взломать.
8. Запускаем Garry’s Mod, выбираем в главном меню пункт “Создать сервер” (“Create multiplayer“). В открывшемся окне на первой вкладке выбираем карту (рекомендуется gm_flatgrass или gm_construct), затем переходим на страницу “Options“. Здесь установите максимально число игроков, которые могут подключиться к Вашему серверу (“Max Players“) и обязательно уберите галочку из строки “Local network game” (иначе никто не сможет подключиться к Вам). Все остальные пункты изменять не нужно, т.к. они изменяются только в конфигурационном файле listenserver.cfg (этот файл имеет более высокий приоритет, чем графическое меню).
9. Жмём кнопку “Start game” внизу окна и ждём окончания запуска сервера.
10. Даём свой внешний IP-адрес всем, кто должен к Вам подключиться и они смогут это сделать, набрав у себя в консоли Garry’s Mod команду connect IP_вашего_сервера:27015 (например, connect 126.65.110.99:27015). Свой внешний адрес можно узнать тут: http://www.2ip.ru (он определится в строке “Ваш IP-адрес“).
11. Если к Вашему серверу кто-нибудь подключился, значит он успешно установлен и настроен. Чтобы отключить сервер, достаточно войти в меню Garry’s Mod клавишей Esc и выбрать пункт “Отключиться” (“Disconnect“). После этого сервер кикнет всех, кто на нём играл и закончит свою работу.

Мини-FAQ

Q: Как запретить выдавать игрокам оружие (давать только Physgun, грави-ган, тулган и скриншотган)?

A: Установите плагин U-Restrict (если Вы устанавливали с помощью наших скриптов, то он уже установлен и автоматически активирован).

Q: Как изменить сообщение, которое появляется при заходе на созданный сервер Garry’s Mod?

A: Отредактируйте файл %Steam%\steamapps\ВАШ_ЛОГИН\garrysmod\garrysmod\data\ulx\motd.txt, где %Steam% – путь к установленному клиенту Steam, а ВАШ_ЛОГИН – Ваш логин для входа в Steam. Это обычный HTML-файл.

Q: Куда пишутся сокращённые логи админки?

A: Логи админки ULX пишутся в %Steam%\steamapps\ВАШ_ЛОГИН\garrysmod\garrysmod\data\ulx_logs\ДАТА.txt, где %Steam% – путь к установленному клиенту Steam, ВАШ_ЛОГИН – Ваш логин для входа в Steam, а ДАТА – сегодняшняя дата в формате ММ-ДД-ГГ.

Q: Мне нужно выдавать игрокам при подключении к серверу определённое оружие. Как это сделать?

A: Как уже писалось выше, нужен плагин U-Restrict для админки (если Вы устанавливали набор плагинов с помощью наших скриптов, он уже установлен). Итак, чтобы выдать нужное оружие, откройте файл %Steam%\steamapps\ВАШ_ЛОГИН\garrysmod\garrysmod\data\URestrict\loadouts.txt в любом текстовом редакторе и в разделе loadout после gmod_tool введите полное имя нужного оружия, например weapon_smg. Это оружие будет автоматически выдано игроку после подключения к серверу, а также после его респауна.

Q: При подключении к серверу моего друга, его Garry’s Mod пытается скачать огромное количество файлов. Что делать?

A: Это значит, что у Вашего друга установлены не все плагины, которые установлены у Вас в каталоге /addons/ Garry’s Mod’а. Нужно, чтобы Ваш друг установил их и чтобы версии плагинов совпадали. Только тогда ему не придётся ничего качать. Рекомендуем пользоваться нашим набором скриптов по установке и обновлению плагинов.

Введение

Многие любят работать с Wire Mod, а также StarGate в Garry’s Mod, но эти плагины принципиально распространяются только через svn (Subversion), т.к. обновляются ежедневно, а иногда и несколько раз в день. К сожалению, операционная система Microsoft Windows “из коробки” не умеет работать с svn и для реализации работы нужно устанавливать сторонние программы. Можно использовать следующие программы:

• TortoiseSVN - мощный комбайн, позволяющий из контекстного меню Проводника Windows выполнять все операции. Многим не нравится за то, что прописывает сотни записей в системный реестр Windows, в контекстное меню Проводника, может вызывать синие экраны BSOD (Blue Screen Of Death).
• SVN – консольная версия оригинального клиента svn (Subversion). Работает только из командной строки Windows, что вызывает затруднения у большого количества пользователей.

В этом HOWTO я подробно распишу как скачать и установить самые популярные плагины для Garry’s Mod из svn и приведу работающие скрипты для автоматического скачивания, а также обновления: Wire (WireMod), StarGate, Advanced Duplicator и Wire Extra Plugins, а также всех из зависимостей.

Что такое SVN?

По данным из Википедии, Subversion — это свободная централизованная система управления версиями, созданная в 2000 г. компанией CollabNet Inc.

Официальный сайт: http://subversion.tigris.org/.

Где можно скачать svn-клиент?

1. Консольный svn (Subversion)-клиент можно скачать с официального сайта: http://www.collab.net/downloads/subversion/ (CollabNet Subversion Command-Line Client v1.6.5 (for Windows)). К сожалению, чтобы скачать программу, нужно пройти небольшую бесплатную регистрацию на этом сайте (нужно указать правильный адрес электронной почты, т.к. на него придёт ссылка для подтверждения регистрации). После скачивания установите программу в папку по умолчанию, которую предложит программа установки (это позволит Вам вручную не изменять пути в скриптах автоматической установки/обновления). Если Вы не хотите регистрироваться на официальном сайте, то можете скачать программу с нашего сайта по этой ссылке: http://www.easycoding.org/files/CollabNetSubversion-client-1.6.5-2.win32.exe (последняя версия на момент написания этого HOWTO).
2. Графический клиент TortoiseSVN, встраивающийся в контекстное меню Проводника Windows (Windows Explorer), можно скачать с официального сайта: http://tortoisesvn.net/downloads. На этой же странице можно скачать языковые пакеты для программы. Русский язык полностью поддерживается. Подробный HOWTO по работе с Tortoise SVN можно найти здесь.

Для нашего проекта нужен 1 вариант, но если Вы выберите второй, то Вам придётся делать CheckOut и обновлять получившиеся локальные каталоги вручную, что очень долго и неудобно при большом количестве установленных из svn-плагинов.

Плагины и ссылки для скачивания

Рекомендуемые для установки плагины Garry’s Mod:

1. Wire (Wire Mod) – https://wiremod.svn.sourceforge.net/svnroot/wiremod/trunk/wire/
2. Wire Model Pack – https://wiremod.svn.sourceforge.net/svnroot/wiremod/trunk/wire model pack 1/
3. Advanced Duplicator – https://wiremod.svn.sourceforge.net/svnroot/wiremod/trunk/Adv Duplicator/
4. Wire Extra Plugins – http://svn.dagamers.net/wiremodextras/trunk
5. PHX Model Pack – https://phoenix-storms.svn.sourceforge.net/svnroot/phoenix-storms
6. StarGate (содержит основной репозитарий и репозитарии зависимостей):
   1. http://svn.daggeringcats.com/stargate/addons/catdaemon_stargate/
   2. http://svn.daggeringcats.com/stargate/addons/gmdm_resources/
   3. http://svn.daggeringcats.com/stargate/addons/stargate/
   4. http://svn.daggeringcats.com/stargate/addons/stargate_resources/

Внимание! Многие плагины во время скачивания предложат принять их сертификат (это обязательно нужно сделать кнопкой “Accept always“), а также запросят логин/пароль. Логин/пароль для скачивания плагинов на всех сайтах установлен anonsvn/anonsvn (т.е. и логин, и пароль anonsvn).

Администрирование сервера Garry’s Mod:

1. ULX Admin Plugin (админка) – http://ulyssesmod.net/ulx/trunk/
2. U-Lib (необходимые файлы админки) – http://ulyssesmod.net/ulib/trunk/
3. U-Restrict (позволяет выбирать какое оружие будет у игрока) – http://ulyssesmod.net/URestrict/

Установка плагинов в Garry’s Mod

Чтобы установить плагин в Garry’s Mod, достаточно извлечь (“checkout”) его каталог в папку “C:\Program Files\Steam\steamapps\{ЛОГИН}\garrysmod\garrysmod\addons”, где “{ЛОГИН}” – это логин учётной записи Steam, а “C:\Program Files\Steam\” – это каталог (папка), в который установлен Steam.

Существует два способа установки плагинов из svn:

1. Ручной. Вы должны вручную сделать CheckOut по всем указанным выше ссылкам при помощи любого svn-клиента. Этот способ лишь кажется простым и удобным, т.к. нужно много раз повторять одни и те же действия, а также вручную обновлять каталоги, т.к. плагины постоянно обновляются.
2. Полностью автоматический (рекомендуется). Этот способ состоит в простом редактировании и запуске уже написанных мною cmd-скриптов установки и обновления набора плагинов (работает во всех версиях Microsoft Windows). Это самый простой, быстрый и удобный способ. От Вас требуется лишь установить консольный svn-клиент (где его можно скачать описано выше в этом HOWTO), открыть файл скрипта и изменить путь к папке плагинов Garry’s Mod (обычно достаточно вместо LOGIN вписать свой настоящий логин Steam) и путь к консольному клиенту svn (если Вы его изменяли во время установки).

Автоматическая установка плагинов:

1. Скачиваем и устанавливаем консольный svn-клиент отсюда: http://www.easycoding.org/files/CollabNetSubversion-client-1.6.5-2.win32.exe, либо с официального сайта (требуется пройти обязательную бесплатную регистрацию): http://www.collab.net/downloads/subversion/ (CollabNet Subversion Command-Line Client v1.6.5 (for Windows)). Во время установки настоятельно не рекомендуется изменять путь установки программы.
2. Скачиваем набор скриптов для установки и обновления набора плагинов.
3. Открываем файл svn_fetch.cmd и файл svn_update.cmd в любом текстовом редакторе и в строке “set GMODADDONS=” вместо “LOGIN” пишем свой настоящий логин Steam. Пример правильной строки: “set GMODADDONS=%PROGRAMFILES%\Steam\steamapps\vasya_pupkin\garrysmod\garrysmod\addons“. Значение переменной SVNDIR нужно менять только если Вы во время установки изменили папку назначения консольного клиента svn. Внимание! Проверьте правильность пути к установленному Steam. Если Вы устанавливали Steam в папку по умолчанию (%SYSTEMDRIVE%\Program Files\Steam), то Вам достаточно заменить LOGIN на свой настоящий логин в строке GMODADDONS, а если в любую другую папку – замените “%PROGRAMFILES%\Steam\” на путь к папке установленного стима, а также укажите свой настоящий логин вместо LOGIN.
4. Зайдите в папку “C:\Program Files\Steam\steamapps\{LOGIN}\garrysmod\garrysmod\addons“, где {LOGIN} – Ваш логин в Steam, а C:\Program Files\Steam – путь к установленному Steam и удалите оттуда имеющиеся плагины (в идеале – удалите всё, что там есть), т.к. старые версии будут конфликтовать с новыми, скачанными из svn:
   1. Wire (WireMod);
   2. Wire Model Pack;
   3. Advanced Duplicator;
   4. Wire Extras;
   5. PHX3 (PHX Model Pack);
   6. StarGate:
      1. catdaemon_stargate;
      2. gmdm_resources;
      3. stargate;
      4. stargate_resources;
   7. ULX;
   8. U-Lib;
   9. U-Restrict;
5. Двойным щелчком запускайте файл svn_fetch.cmd и дождитесь окончания загрузки (окно с прогрессом скачивания не закрывайте; по окончании процесса скачивания оно закроется автоматически).
6. Установка плагинов окончена. Для их обновления запустите файл svn_update.cmd и дождитесь окончания обновления. Все плагины будут обновлены до новейших версий автоматически. По окончании обновления окно закроется автоматически.

Рекомендуется обновлять плагины (запускать файл svn_update.cmd не реже двух раз в неделю).

Скачать набор скриптов для автоматической установки/обновления плагинов для Garry’s Mod.

Введение.

В Jabber-клиенте Psi предусмотрена возможность настройки шифрования GnuPG для всех сообщений между клиентами собеседников. Это рекомендуется сделать всем, кто пользуется Psi и передаёт (или получает) конфиденциальную информацию по протоколу XMPP (Jabber), т.к. администраторы Jabber-серверов могут настроить запись логов всех сообщений, отправляемых или получаемых пользователями. После включения шифрования, в логи сервера ничего не запишется, т.к. шифрование осуществляется по типу клиент (открытый ключ для отправки) – клиент (закрытый ключ для получения). Шифрование GnuPG является полностью свободным и может использоваться на любых компьютерах.

Настройка шифрования в оригинальной версии Psi.

Оригинальная версия – это версия, которую можно скачать с официального сайта программы. Последней стабильной версией, на момент написания статьи, являлась 0.12.

1. Заходим на официальный сайт Psi и скачиваем дистрибутив программы для свой операционной системы (поддерживаются Windows, Linux и Mas OS).
2. Если у Вас ОС Microsoft Windows любой версии, то нужно скачать и установить систему шифрования и управления ключами GnuPG – GPG4Win с официального сайта. Скачивайте Light версию 1.1.4 (это последняя стабильная версия на момент написания статьи) или новее. P.S. Если у Вас Linux, то скачивать ничего не нужно, т.к. свободная реализация GPG уже имеется в Вашем дистибутиве.
3. Сначала устанавливаем GPG4Win, запустив скачанный файл вида gpg4win-light-1.1.4.exe на исполнение. Внимание! Установить GPG4Win необходимо строго в папку по умолчанию: C:\Program Files\GNU\GnuPG, где C:\ – системный диск, на котором установлена ОС Windows.
4. Настраиваем GPG4Win:
   1. Нажимаем “Пуск” – “(Все) Программы” – “GnuPG For Windows” – “GPA“.
   2. В открывшемся окне, предлагающем сгенерировать новую ключевую пару, нажимаем “Generate key now“. Запустится мастер, который сделает несколько шагов:
      1. В поле “Your name” вводите своё имя латинскими буквами (можно ник) и жмите “Forward“.
      2. В “Your Email Address” вводите свой JID (Jabber ID вида имя@jabber-сервер, например, имя@jabber.ru, имя@jabber.org и т.п.).
      3. В “Passphrase” и “Repeat Passphrase” нужно придумать и ввести собственный пароль. Пароль будет спрашиваться каджый раз при подключении к Jabber-серверу.
      4. Делаем (“Create Backup copy“) или отказываемся делать (“Do it later“) резервную копию ключа шифрования GPG. Лучше сделать копию ключей и поместить на сменный носитель.
      5. Жмём “Apply” и ждём примерно 1-2 минуты (зависит от мощности центрального процессора и сложности пароля) до окончания генерации ключевой пары. По окончании, если Вы выбрали создание резервной копии, то можете её сохранить на сменном носителе.
   3. После успешного создания новой ключевой пары, в окне “GNU Privacy Assistant“, Вы увидите свой ключ. Теперь нужно получить его открытый ключ чтобы в дальнейшем передать собеседникам в Psi. Выделите его щелчком левой кнопки мыши и нажмите на панели инструментов кнопку “Export” и сохраните ключ с любым именем, но с расширением asc.
   4. Передайте свой открытый ключ, сохранённый на этапе 3, собеседникам, с которыми Вы хотите общаться по защищённому каналу в Psi любым способом (через электронную почту, jabber, icq и т.д.).
   5. Импортируйте ключ собеседника, который сгенерировал его таким же способом (пункты 4.1 – 4.3) кнопкой “Import” и указанием файла с открытым ключом собеседника.
   6. Если ключ собеседника также появился в списке, жмите “File” – “Quit” для выхода из оболочки.
5. Устанавливаем и запускаем программу Psi, скачанную на 1 шаге (если она ещё не установлена), подключаем уже имеющуюся учётную запись для того JID, для которого мы создали ключевую пару.
6. Открываем настройки аккаунта через меню Пси (находится внизу окна с эмблемой программы) – “Аккаунты” – выбираем имя своего аккаунта и жмём кнопку “Изменить” (эти же настройки откроются автоматически после выбора опции “Использовать имеющуюся учётную запись” во время первого запуска), переходим на страницу “Подробности” и жмём кнопку “Выбрать ключ…“. Выбираем из списка свой закрытый ключ и жмём OK. Если будет запрошен пароль для этого ключа, то вводим. Теперь для этой учётной записи ключ шифрования задан.
7. Подключаемся к Jabber-серверу и вводим пароль на свой закрытый ключ GnuPG (пароль будет спрашиваться при каждом подключении).
8. Выбираем в своём ростере (списке контактов) собеседника, с которым нужно настроить защищённый канал, жмём по нему правой кнопкой мыши и выбираем “Присвоить ключ OpenPGP“. Если появится предупреждение, то жмём на “Выбрать ключ вручную” (обычно предупреждений быть не должно). Выбираем из списка открытый ключ собеседника, который был импортирован на этапе 4.5 данного HOWTO и жмём “OK“.
9. Открываем окно беседы с этим собеседником и жмём кнопку с замком “Переключить шифрование” (находится возле кнопки для вставки смайликов в сообщение) и отправляем любое сообщение собеседнику. После этого в беседе появится сообщение “Шифрование включено”. Теперь вся беседа с этим человеком зашифрована и никто её не сможет расшифровать и прочитать. Внимание! После каждого перезапуска клиента Psi кнопку “Переключить шифрование” нужно нажимать повторно, т.к. она почему-то отключается.

Настройка шифрования в Psi Portable.

Psi Portable – это особая сборка программы Psi для запуска со сменных накопителей. Все файлы программы, ключи шифрования, настройки и журнал сообщений хранятся на сменном носителе. Подробнее об этой версии можно прочитать здесь.

1. Выполняем шаги 2 – 4 (с подпунктами) из “Настройка шифрования в оригинальной Psi”.
2. В Windows 2000/XP/2003 заходим в папку C:\Documents and Settings\{ИМЯ}\Application Data\gnupg, где {ИМЯ} – это имя учётной записи пользователя компьютера, а C:\ – диск, на котором установлена ОС Windows и копируем всё её содержимое в PsiData\gpg\ Portable-версии.
3. В Windows Vista и Windows 7 нажимаем “Пуск” – “Выполнить” и вводим “%APPDATA%\gnupg” (без кавычек). Копируем всё содержимое в PsiData\gpg\ Portable-версии.
4. Выполняем шаги 6 – 9 из “Настройка шифрования в оригинальной Psi”.

Вступление.

Jabber-клиент Psi является, на мой взгляд, лучшим Jabber-клиентом из всех существующих в настоящее время, однако у него нет официальной Portable-сборки, которая бы могла запускаться с флешек, USB-HDD, iPod и других внешних устройств. В этом HOWTO я подробно опишу как сделать такую сборку самостоятельно, затрачивая на эти цели минимум времени. Отличия нашей сборки Psi Portable от оригинальной Psi:

1. Не требуется установка. Программа работает на любом компьютере. Все личные данные, настройки и история хранятся на сменном устройстве.
2. Добавлено шифрование GnuPG (GPG) для всех сообщений в Portable-версии. Все ключи шифрования и необходимые библиотеки хранятся на сменном устройстве вместе с Psi Portable.
3. Добавлена поддержка русской орфографии в Portable-исполнении. Все словари (для русского и английского языков) хранятся на сменном устройстве.

Создание.

1. Заходим на сайт http://www.psi-im.org/ и скачиваем последнюю версию программы (на момент написания этого HOWTO последней являлась версия 0.12).
2. Качаем заготовку для создания собственной сборки (размер около 10 МБ из-за включения в состав полного словаря русского языка), включающую в себя:
   1. GnuPG (GPG) последней версии;
   2. официальные русскоязычные языковые пакеты для Psi, а также для QT4;
   3. русские словари для встроенной системы проверки орфографии (aspell) последней версии;
   4. командный сценарий для запуска Portable-версии программы.
3. Распаковываем скачанную заготовку в нужную папку на сменном устройстве, например в ДИСК:\PsiPortable\.
4. Устанавливаем скачанный на этапе 1 дистрибутив Psi, затем копируем из папки C:\Program Files\Psi (если программа была установлена в эту папку) всё содержимое в папку App нашей сборки (файл uninstall.exe и файлы с расширением *.url лучше не копировать (в нашей сборке они не нужны и будут только занимать место на диске)). Сразу после копирования удаляем программу Psi через Панель управления – Установка и удаление программ.
5. Запускаем файл psi_launch.cmd из состава сборки и начинаем использовать Psi Portable. Вся конфигурация хранится в каталоге PsiData и будет создана при первом запуске. В каталоге PsiData\gpg\ хранятся открытые и закрытые ключи для системы шифрования GPG, а также их настройки.

Полезные советы и предупреждения.

1. Запускайте Psi Portable только файлом psi_launch.cmd, т.к. этот файл задаёт нужные программе переменные. Запуск в обход этого файла приведёт к ошибкам и невозможности загрузки настоек, ростера, а также журнала сообщений.
2. Если у Вас установлена Windows 9x (95/98/ME), то файл psi_launch.cmd нужно переименовать в psi_launch.bat для правильной работы.
3. Если Вы уже использовали Psi ранее, то просто скопируйте содержимое папки C:\Documents and Settings\USERNAME\PsiData (в Windows 9x находится обычно в папке установки Psi, например в C:\Program Files\Psi) в папку PsiData нашей сборки, где USERNAME – логин Вашей учётной записи Windows 2000/XP/2003. Psi Portable во время этих действий не должен быть запущен.
4. Если Вы использовали GPG под любой платформой, то скопируйте свои открытые/закрытые ключи в папку PsiData\gpg\.

Вступление.

Сегодня решил написать подробную статью об установке и настройке слушающего сервера игры Team Fortress 2. Итак, чем же отличается слушающий сервер игры от выделенного (Team Fortress 2 Dedicated Server):

1. Слушающий сервер не требует особой настройки и установки модификаций.
2. Слушающий сервер позволяет одновременно хостить личный сервер и играть в игру. Выделенный сервер не позволяет играть на этом же компьютере (если всё-таки запустить игру и подключиться к такому серверу, у всех появятся серьёзные лаги, т.к. создаётся дисбаланс между сервером и клиентов при обращении к CPU (процессору)).
3. Слушающий сервер – это практически тот же Dedicated Server, но имеющий следующие недостатки (хотя достоинств больше):
   1. Администратором является только тот, кто создал сервер. Управление осуществляется через консоль управления сервером (консоль игры, вызывается клавишей “тильда”; нужно включить консоль управления в настройках клавиатуры игры).
   2. Если администратор (создатель) отключится от сервера, то все клиенты, подключившиеся к нему, будут кикнуты автоматически. Сервер будет остановлен.
   3. Включена принудительная проверка учётных записей Steam, т.е. с пираток на такой сервер  зайти не удастся.
   4. На слушающий сервер нельзя установить SourceMod и другие админ-плагины.
4. Слушающий сервер запускается прямо из главного меню игры (там же указывается максимальное число игроков).
5. Все настройки такого сервера хранятся в файле listenserver.cfg.

Техническая часть.

1. Чтобы к Вам могли подключаться клиенты, Вы должны иметь “белый” IP-адрес, т.е. видимый из Интернета. Создание сервера с “серым” IP, либо с жёстким NAT’ом провайдера не имеет смысла, т.к. подключиться к такому серверу никто не сможет.
2. Сервер запускается на порту 27015, поэтому если у Вас ADSL, вы должны пробросить этот порт по протоколу UDP в настройках своего роутера (модема).
3. На сервере главное – скорость отдачи от Вас клиентам, а также мощность процессора Вашего компьютера. На ADSL максимальная отдача может составлять около 780 Кбит/с – 1 МБит/с (на ADSL с модуляцией AnnexM (такая разновидность встречается крайне редко) – 3 Мбит/с). Если у Вас тариф на 256 КБит/с, то к Вам могут подключиться 6 клиентов. Если 512 – 10-12 клиентов, если 1 Мбит и более (ADSL) – 18 клиентов, кабель без NAT – 23 клиента (максимум для слушающего сервера). В соотвествие с этими параметрами Вы должны настроить значение переменной “Максимальное число игроков” во время создания сервера. Если Ваш канал или процессор не будут выдерживать такое количество подключившихся игроков, у всех появятся лаги.

Настройка и подготовка к запуску.

1. Устанавливаем Steam и игру Team Fortress 2 (если они ещё не установлены).
2. Запускаем игру, ждём полной загрузки и выходим из неё (это нужно только если выполнялся шаг 1 для создания файлов базовой конфигурации).
3. Открываем “Мой компьютер” и переходим в папку “C:\Program Files\Steam\SteamApps\{ВАШ_ЛОГИН}\team fortress 2\tf\cfg“, где {ВАШ_ЛОГИН} – логин входа в Steam, а C:\Program Files\Steam\ – путь куда установлен Steam. Если Steam установлен в другую папку или диск, то его нужно откорректировать. В этой папке лежат файлы настроек игры TF2, в том числе и слушающего сервера.
4. Качаем и распаковываем архив с файлами конфигурации в эту папку с заменой существующих файлов. Архив обновляется после выхода серьёзных изменений в игре.
5. Открываем распакованный файл listenserver.cfg в любом текстовом редакторе (например, в Блокноте Windows) и делаем нужные настройки (меняем имя сервера, настройки и т.п.). В файле я всё подробно описал какая переменная чем управляет, что включает/выключает, поэтому на этом я останавливаться не буду здесь. Внимание! Первым делом задайте пароли вместо !!PASSWORD1!! и !!PASSWORD2!!, иначе Ваш сервер могут взломать.
6. Открываем файл config_arena.cfg в том же текстовом редакторе и меняем имя сервера для режима Арена, а также максимальное число пользователей режима Арена.
7. Запускаем игру Team Fortress 2, выбираем в главном меню пункт “Создать сервер“. В окрывшемся окне выбираем любую установленную карту, а затем переходим на страницу “Игра” и устанавливаем “Максимальное число игроков” (должно быть целым числом от 2 до 24). Остальные параметры не будут играть никакого значения, т.к. игнорируются файлом конфигурации. Внимание! Не устанавливайте тут пароль, иначе к Вам никто не сможет подключиться. Пароль можно установить уже после запуска игры и подключения первых игроков командой в консоли sv_password “your_pass”, где вместо your_pass должна идти комбинация латинских букв и цифр. Этот пароль будет запрашиваться у всех, кто захочет подключиться к серверу.
8. После успешного запуска сервера и Вашего подключения к нему, открываем консоль разработки (вызывается клавишей “тильда”) и сразу меняем карту на любую из установленных (лучше на текущую, т.к. это ускорит перезагрузку сервера) командой changelevel имя_карты (например, changelevel cp_dustbowl). Это действие применит настройки файла listenserver.cfg. Без этого шага к Вам никто не сможет подключиться (на клиентах будет выдаваться сообщение LAN servers are restricted to local clients). Этот шаг нужно повторять всегда после запуска слушающего сервера!
9. Даём свой внешний IP-адрес всем, кто должен к Вам подключиться и они смогут это сделать, набрав у себя в консоли TF2 команду connect IP_вашего_сервера:27015 (например, connect 126.65.110.99:27015). Свой внешний адрес можно узнать тут: http://www.2ip.ru (он определится в строке “Ваш IP-адрес“).
10. Если к Вашему серверу кто-нибудь подключился, значит он успешно установлен и настроен. Чтобы отключить сервер, достаточно войти в меню игры TF2 и выбрать пункт “Отключиться“. После этого сервер кикнет всех, кто на нём играл и закончит свою работу.

Переменные, которые можно задавать прямо во время игры.

• sv_alltalk 1 – включение (1) или отключение (0) общего голосового чата.
• tf_weapon_criticals 1 – включение (1) или отключение (0) критов.
• mp_allowspectators 1 – включение (1) или выключение (0) зрителей.
• sv_password “your_pass” – задание пароля, где вместо your_pass должен идти пароль. Кавычки обязательны. Пароль будет запрошен у всех, кто захочет подключиться к Вашему серверу.
• sv_password “” – убирает пароль с сервера. К серверу может подключиться любой желающий.
• mp_friendlyfire 1 – включает (1) или отключает (0) огонь по своим.
• sv_gravity 800 – управляет гравитацией на сервере (800 – стандартное значение), может быть числом от 0 до 10000. Чем меньше значение, тем меньше гравитация.

Внимание! При смене карты все переменные, заданные во время игры, будут автоматически заменены значениями из файла конфигурации сервера!

Итак, Ваш сервер установлен и правильно настроен. Если у Вас возникнут вопросы по статье, то оставляйте комментарии к этому сообщению. Я отвечу на все вопросы. Для того, чтобы оставить свой комментарий, регистрация не требуется.

Принтеры Canon PIXMA широко популярны на российском рынке, но, к сожалению, производитель (Canon Inc.) не укомплектовал их нормальным драйвером для операционной системы Linux (в наличии имеется только недоработанный, рассчитанный на доисторические дистрибутивы эпохи SuSE 9). Установка такого драйвера вызовет множество ошибок в системе (например, “битых” зависимостей). Поэтому я написал этот HOWTO, который поможет Вам установить и правильно настроить принтер под любой современный дистрибутив. Также этот HOWTO позволит установить и настроить абсолютно любой другой принтер из списка поддерживаемых (различаться будут только физические пути, но их можно посмотреть в форуме дистрибутива, либо на сайте производителя).

1. Заходим на официальный сайт драйвера и скачиваем его под свой дистрибутив Linux (на выбор представляется 32-битный и 64-битный драйвер в форматах rpm (для RPM-Based дистрибутивов), deb (для дистрибутивов, основанных на Debian, например, Ubuntu) и tar.gz (для всех остальных дистрибутивов с графическим конфигуратором).
2. Устанавливаем пакет RPM/DEB штатными средствами дистрибутива, либо распаковываем tar.gz и даём команду ./setup для запуска графического инсталлятора (запускать эту команду нужно только от имени администратора, например, так: sudo ./setup в консоли). После установки CUPS будет перезапущен автоматически для применения списка новых устройств.
3. Если у Вас установлен KDE или Gnome, с помощью меню приложений запускайте графический настройщик драйвера TurboPrint – TurboPrint-Setup. Внимание! TurboPrint-Setup должен запускаться с правами администратора! Нажимайте кнопку “Add“, выбирайте свою модель принтера, в поле “connection” вводите “tpu://Canon/iP1500” (без кавычек), либо “usb://Canon/iP1500“, где вместо iP1500 указывайте свою модель (например, Canon PIXMA iP1500 имеет указанный выше путь, Canon PIXMA iP2800 имеет путь: “tpu://Canon/iP2800” и т.д.). Имя можно указывать любое, но без пробелов (желательно оставить стандартное – tp0). На этом же шаге можно проверить работоспособность принтера, распечатав на нём тестовую страницу.
4. Сохраняйте настройки TurboPrint и перезапустите CUPS, либо перезагрузите компьютер.
5. Теперь все приложения в системе увидят Ваш принтер и Вы сможете начинать печатать.

P.S. Драйвер TurboPrint является условно-бесплатной программой и без регистрации проработает только 30 дней!

Недавно я себе приобрёл новый UPS (источник бесперебойного питания) марки Ippon Smart, который способен подключаться к компьютеру по портам RS-232 (COM) и USB. Программное обеспечение, которое шло в комплекте, не смотря на то, что заявлена (на коробке, в инструкции пользователя и на самом диске) работа на всех платформах (Windows, Linux, FreeBSD, *NIX, Solaris и т.д.), работает только под Windows (да и то нестабильно (очень часто вместо значка в трее вылетает консоль и тут поможет только переустановка)); на всех остальных платформах ещё при установке (а если всё-таки установку удастся завершить, то и при запуске) выдаётся ошибка: “Exception in thread “main” java.lang.NoClassDefFoundError: com/zerog/lax/LAX“. Эта ошибка появляется абсолютно на всех компьютерах с ОС, отличающейся от MS Windows, т.к. ПО, идущее в комплекте, написано на Java какой-то давно устаревшей версии, а в новой версии таких библиотек, необходимых для запуска, уже нет. Техническая поддержка ничего по этому поводу не говорит (если судить о количестве сообщений с такой темой на их форуме) и просто советует обновить виртуальную машину Java на компьютере и выкачать то же самое ПО и их сайта (эти действия выполнялись, но не принесли никакого успеха). Таким образом, придётся решать проблему собственными силами (впрочем, как всегда в Linux  ). Далее я опишу подробное HOWTO (пошаговую инструкцию) как “заставить” работать UPS марки Ippon Smart в Linux на примере популярного дистрибутива openSUSE 10.3 (если у Вас установлен другой дистрибутив, то не расстраивайтесь, этот HOWTO подойдёт практически к любому современному дистрибутиву).

1. Выкачиваем и устанавливаем пакет nut (nut-2.2.0-59.x86_64.rpm для архитектуры x86_64 или nut-2.2.0-59.i386.rpm для стандартных ПК) для Вашего дистрибутива (для openSUSE этот пакет можно найти на http://software.opensuse.org в разделе “Software Search“. Внимание! Если Вы будете позже собирать пакет knutclient из исходных кодов, то скачайте также nut-devel (nut-devel-2.2.0-59.x86_64.rpm для x86_64 или nut-devel-2.2.0-59.i386.rpm для стандартных ПК). Чтобы установить этот пакет, можно воспользоваться одним из двух способов:
   • Установить пакет из рут-консоли командой rpm -ipv имя_пакета;
   • Установить пакет с помощью Yast в openSUSE (для этого достаточно в Konqueror 1 раз щёлкнуть по файлу пакета и в открывшейся программе просмотра содержимого пакета нажать “Установить пакет с помощью Yast”).
   • Если у Вас установлен Ubuntu, то все файлы пакетов должны иметь расширение *.deb. Устанавливать их можно либо через apt-get install имя_пакета, либо дважды щёлкнув в файловом менеджере Gnome по файлу, либо запустив пакет через Synaptic.
2. Переходим к самой сложной части – настройке уже установленного пакета nut. Для этого  в openSUSE открываем Konqueror (в Ubuntu нужно открывать Nautilus) в режиме root (хотя, можно зайти в систему от пользователя root на время выполнения операций настройки (в этом режиме можно повредить систему, поэтому нужно сразу выйти из него после окончания)) и открываем root-консоль (также можно в обычной консоли дать команду su и ввести пароль root (в  Ubuntu нужно вводить команду sudo bash для запуска консоли с правами суперпользователя и ввести пароль текущего пользователя для подтверждения прав доступа) для ввода команд. Теперь в уже открытом окне Konqueror (c root-правами) переходим в папку /etc/ups/ и открываем файл ups.conf, щёлкнув по нему правой кнопкой и выбрав “Открыть в” – “Редактор KWrite”. В самом конце файла заменяем исходные 4 строки на следующие:
   • [myups]
     driver = megatec
     port = /dev/ttyS0
     desc = “Local UPS”

   Во второй строке (driver = megatec) указано, какой драйвер нужно загружать (megatec полностью поддерживает все модели Ippon Smart, подключённые через порт RS-232 (COM), а megatec_usb – через USB). В третьей строке указан порт для подключения, где /dev/ttyS0 – это порт COM1, а /dev/ttyS1 – COM2 (при подключении по USB пути будут другими и они зависят от авторов дистрибутива, а также от версии ПО). Сохраняем изменения в файле ups.conf. Теперь откройте файл upsd.conf. В нём должны быть раскомментированы следующие строки (по умолчанию всё должно быть указано правильно, но, если что-то не так, исправьте):

   • ACL all 0.0.0.0/0
     ACL localhost 127.0.0.1/32ACCEPT localhost
     REJECT all
3. Основная настройка окончена, но зайдите в файл upsd.users и в конце файла в [upsmaster] посмотрите пароль (по умолчанию он 8f15aa1c7a). Здесь upsmaster – это имя пользователя UPS, которое вместе с паролем будет указываться в программе мониторинга UPS. Если Вы что-то изменили (имя пользователя или пароль), то сразу зайдите в файл upsmon.conf, найдите строку “MONITOR myups@localhost 1 upsmaster 8f15aa1c7a master“, сделайте свои поправки.
4. Всё. Пробуем запустить сервер и клиент. Для этого в рут-консоли даём команду “rcupsd start“, результатом выполнения которой во всех строках должно появиться слово “done” (если оно появилось, значит настройка закончена и можно перейти к установке клиента):
   • Starting NUT UPS drivers                                             done
     Starting NUT UPS server                                              done
     Starting NUT UPS monitor                                            done
5. Пробуем получить информацию от UPS командой “upsc myups@localhost“. Если в ответ получена информация о UPS, значит вся настройка прошла корректно и встроенный клиент видит устройство.
6. Теперь выкачиваем и устанавливаем программу-клиент knutclient (имеет удобный русифицированный графический интерфейс (эта программа только для графической среды KDE 3.x, под Ubuntu её запускать не рекомендуется (под Kubuntu она будет работать)). Можно выкачать как в виде пакета, так и в виде исходных кодов (лучше в виде пакета). Пакет можно найти на RPMSearch или воспользоваться прямой ссылкой для openSUSE-версии (там же есть ссылка для поиска этого пакета для других дистрибутивов). Устанавливайте также, как устанавливали nut.
7. Запускаем свежеустановленный knutclient, заходим в меню “Настройка” – “Настроить KNutClient…“. В открывшемся окне переходим на страницу “UPS” (переключатель страниц находится в левом фрейме). Нажимаем кнопку “Добавить“. Вводим:
   • “Имя”: “Ippon” (тут можно указать любое имя);
   • “UPS адрес”: “localhost”;
   • “UPS имя”: “myups”;
   • “Задержка”: “5000″;
   • “Порт”: “3493″;
   • “Имя пользователя”: “upsmaster” (если не изменяли ранее, укажите это, если изменяли – укажите изменённое);
   • “Пароль”: “8f15aa1c7a” (если не изменяли, укажите этот, но лучше всего – посмотрите в уже упомянутом выше файле upsd.users).
   • Установите галочку в строке “Хранить пароль в файле конфигурации” для того, чтобы каждый раз его не пришлось вводить вручную.
   • В полях “UPS переменные” нужно указать датчики, которые должны отображаться в графическом виде на панели программы knutclient. Некоторые не работают. У меня указаны следующие: “Входное напряжение”, “Выходное напряжение”, “UPS температура”, “UPS загрузка”, “Напряжение батареи”, “Зарядка батареи”. Остальные датчики не работают и при их выборе, они просто не появятся на панели датчиков.
8. Нажимаем в окне конфигурации “OK“, “Применить“, “OK“. Если датчики начали показывать параметры, значит всё настроено корректно. Если они не начали показывать ничего – воспользуйтесь кнопкой “Обновить” или клавишей “F5“. При правильной настройке ошибок не должно возникать.
9. Теперь нужно сделать так, чтобы upsd вместе со своими настройками и драйверами загружался при старте системы. Для этого в openSUSE запускаем “Yast2“, переходим на страницу “Система” и выбираем модуль “Системные службы (runlevel)“. В открывшемся окне модуля ищем строку “upsd“, выбираем её, нажимаем на кнопку “Включить” (появится сообщение об успешном изменении типа запуска службы), а затем “Завершить” для сохранения изменений в системе.

Выполнив все эти шаги, Вы сможете “заставить” Ваш UPS работать под Linux и в удобном виде отображать полезную информацию, а также отключать компьютер в случае длительной работы от батарей при отстутствии напряжения в сети.

Свои вопросы, предлжения и комментарии можете высказывать в комментариях к этому посту.