| |
|
| Auspice Services Manual Auspice Services Administration Manual
You need to make sure that you always have the latest version of Services. The latest version at this time is 2.5.1 Newlife and the direct link for it is: Services work best with UnrealIRCd version 3.1 and up. Support for other IRCd's is being worked on, however. 1.1 Unzipping the aus2.5.1.tgz file To start the installation, we assume that the zipped package is on the root directory of your shell. Depending on what version you are using, the file name may be different. Please follow the steps below to unzip Auspice Services into their default directory, auspices: You are finished with installing the files. If this was not successful, please repete the steps. 1.2 Compile-time Configuration To start the compile-time comfiguration and compile Auspice Services, you must first be in the auspices directory. From the root directory of your shell, type: You will be asked a number of questions reguarding the setup of your services. You must choose the IRCd that you are using from the first menu. For best results, I recommend you go with the first setting, UnrealIRCd (if you are using Unreal that is). Next, you will be asked what version of UnrealIRCd you are using. In this manual, I assume you are using Unreal3.2-Selin(beta4) which can be uptained from www.unrealircd.com. The last remaining options are related to the services that you want to use. I usually enable X, W, and MassServ. As it says, you may want to disable the game feature.. don't even think it works yet :) When you're done with the configuration script and are back at the prompt with no errors, type the following to compile your services. Note: if you had an error, try to configure it again. This will compile your services. You should return to the prompt ready to continue. 1.3 Configuring Auspice Services To Work With Your IRCd With the services installed, compiled, and configured, we must do the rest of the configuration to make the services link with your server. Assuming you are using UnrealIRCd version 3.2, copy and insert these lines into your unrealircd.conf file and edit them to fit your network's configuration. /* Link configuration for network services */ The following few lines are also important for you to add to your unrealircd.conf file and edit. These allow Services to change channel modes without being opped in the channel. /* U:line for network services */ Remember to define the port 7029 in the unrealircd.conf file if you have not done it yet: listen 127.0.0.1:7029;
Once you are done editing sample.conf, rename it to services.conf. This is very important. 1.4 Starting Auspice Services Once the configuration is completed with no errors, switch to your auspices directory, and issue the following command to boot the services: If you get any errors, try to correct them, and if that fails, see the support section. Also before contacting us, be sure that your IRCd is running before booting services so that they are able to link!!!
Now since you have your services up and linked to your server, you are ready to connect to your server and change the settings of your services to suit your wants and needs. Auspice Services provide a very huge amount of options, settings, and configuration to greatly enhance your network. Auspice contains around 15 services, including the popular NickServ, ChanServ, and MemoServ. Also included is a helpful tool for users called HelpServ that enables your users to get all the help they need from one service. There are a lot of services bots provided to you as an admin to adjust your server and services settings. The following administrative bots are available: 2.1 Registering Your Nickname To Get Access In order to access any of the commands provided to Services Founders or any kind of Service Oper, you must register your nickname. To register your nickname, you must first connect to your server. Then, issue the following command: After doing this, you may have to reconnect and identify to your nickname to gain access. 2.2 AdminServ The tool to adding opers to your Services access lists is called AdminServ. It is recommended that a user on the access lists of Services should also have an O line in the server's configuration file. When you add a user, you have to define his/her privilages. The privilages include: Opers may also have extra flags which we will discuss later. To add an oper, use the following command syntax: You may view an oper's information and privilages by issuing the following command: You can get a list of opers by doing the following command: If you wish to change an oper's privilages, use the following command: You can add aditional flags to an oper's privilages. Below is a list of aditional flags you may add: To add one of the above flags to an oper's privilages, use the following command: 2.3 OperServ OperServ gives users commands over the network and it's users. All commands invoked from within OperServ have help text in the Services help files. You can use The following short list of commands can be used depending on your flags and privilages: /msg operserv kick <channel> <user> <reason> /msg operserv update /msg operserv global <message> For lots more commands, type: 2.4 RootServ
Small list of commands: /msg rootserv shutdown /msg rootserv quit /msg rootserv restart For more commands do: 2.5 Agent Agent is a very large and option-full services. It lets you take full control over services settings, such as welcome messages, making opers autojoin channels, etc. Agent has so many commands that it'd be impossible to list them all here. However, a few common ones are listed: /msg agent exit <nickname> <reason> /msg agent backupdata /msg agent update 2.6 MassServ MassServ is a services used to move users and services bots around the network. It may be useful, but is also a very fun service to play with users. A list of commands follows: /msg massserv alljoin <channel> Please note that MassServ is still under construction! For more commands type: 2.7 HostServ HostServ allows you to set a fake host for opers and users who have a registered nickname. This should make it harder for people to get information with your hostname. To set a fake hostname for a user, use: To remove a user from the autohost list, use: 2.8 Create Bots For Your Network With BotServ You can use BotServ to create feature-rich bots for your users to keep in their channels. These bots can be configured to kick colors, swearing, bolds, repeats, etc. To create a bot for a user, use: When the bot is created, it will be connected, and will almost be ready for users to use. However, when you create a bot, it is set by default to only let the bot master (it's creater) to control it. Use this simple command to turn this off so that users can assign your bot to their channels: To assign this bot to a channel, the user must issue the following command: Sometimes users will want the bot to permanently sit on the channel. A normal user cannot use this command; they will come asking you. Use this: To configure the bot to kick certain things, use: You can tell the bot to kick the following things: To invoke these:
The following sections will explain to you how you can get further support on Auspice IRCd Services. 3.1 Various Help Commands For all of these services, and any other service, you can type: 3.2 Support If you still need help, point your IRC client to irc.auspice.org and /join #ausserv. Please note that we do not help you link Services with the IRCd!! This is covered in the IRCd docs somewhere. If you are using UnrealIRCd, try example.conf and unrealircd.doc. Also try unrealircd.conf.txt. Send bugs or suggestions to auspice@auspice.org 4.0 End Well, I hope you enjoy using Auspice IRCd Services, a very nice, feature-rich, services package. I'd like to thank Auspice for providing us with Auspice Services. If you'd like to contact me, use robertls@shellyeah.org. Thanks, |
