(btw. If you downloaded a binary release of galena there should already be a basic configuration)
Making a basic configuration file
First of all you need to generate a startup file which will be executed after the bot starts (e.g. startup.txt)
And afterwards a config file which loads the modules. (e.g. config.txt)
Example startup.txt:
AddinConfig /home/kahless/galena/config.txt
set kernel.savefile /home/kahless/galena/save.file
modules load
(Note: If you want less debug output you can write here set kernel.debug 0)
(the last line loads the Socket module and tells it to bind the port 3333 you can also use galena.addins.interfaces.sslsocket if you want ssl encryption for administration - not recommended unless you have a ssl telnet client)
Starting the bot
You need a JRE (Java Runtime Environment) installed on your system. (See http://java.sun.com)
If you have a release of galena there should allready be a .sh file for linux and a .bat file for windows users.
You only need to edit them to use the JRE (change the line java -jar .. to e.g. C:javabinjava.exe -jar ..)Important : you need to include the galena kernel into the classpath of java, but do NOT include the galena addins into the CLASSPATH of java, because galena uses it's own classloader !
Here are possible parameters for galena:
addinpath (needed): takes as parameter the directory (or .jar file) to the galena addins (needs to point to the first directory of the addin structure, not to the binary directory which contains it. ie. when you have /galenaaddins/bin/galena/addins/interfaces/socket/Socket.class you have to point to /galenaaddins/bin/galena not to /galenaaddins/bin )
startupscript (needed): points to the startup script explained above.
configplugin (optional): this defines the config plugin used to load the basic configuration - never tried if it actually works.. usually it uses the textfile addin
savefile (deprecated): this should be specified in the startup script using set kernel.savefile !!
Setting up an Administrator account
You need to use telnet (or ssltelnet if you used sslsocket) to connect to the bot.
(telnet comes with most OSes.. if you use win32 you can try: Putty)Now connect to the bot (it bound the port you specified in the config file) and type:
registerAdmin <username>
(This only works for the first user of course and will register <username> as your name.)You can now login using your username and the password 'empty' to change your password.Now your Galena Bot is ready to use.. Check out GalenaDocumentation for example usages