Asagi¶
Compiling Asagi¶
$ git clone https://github.com/FoolCode/asagi.git
$ mvn package assembly:single
Configuring Asagi¶
Asagi uses a JSON configuration file named asagi.json
. An example configuration file is included within
thegit repository as asagi.json.example
.
Warning
If you are using MySQL/MariaDB as your database server, you must set the character_set_server
setting
under the [mysqld]
section to utf8mb4
in your my.cnf
file. This will allow you to properly
store multi-byte unicode characters properly.
Running Asagi¶
$ java -Xmx256m -XX:+UseParNewGC -XX:MaxPermSize=24m -jar asagi.jar
Note
We strongly recommend the usage of screen
or tmux
with Asagi. Also, you may be required to
adjust the Xmx
and XX:MaxPermSize
values accordingly.
Configuring FoolFuuka¶
Warning
It is very crucial that you configure and run/restart Asagi before adding the board to FoolFuuka. This will allow Asagi to create the board tables properly with some additional steps that aren’t included in FoolFuuka. If this is not done, the board tables will not be populated properly.
You must first configure FoolFuuka to use the Asagi database created in the previous steps. This can be done by following the steps listed below:
- Access the FoolFuuka Administrative Panel
- Navigate to
Preferences
under theBoards
section - Set the
Boards Database
field to the same database name used in theasagi.json
config file - Save your changes
Note
The steps listed above only need to be completed once.
In order to access the boards being archived with Asagi, you will need to add the boards to FoolFuuka by following the steps listed below:
- Access the FoolFuuka Administrative Panel
- Navigate to
Manage
under theBoards
section - Click “Add Board”
- Fill out the required fields properly
- Check the “Is this an archived board?” checkbox
- Click “Submit” to add the board to the database
Note
You will need to repeat the steps listed above each time you wish to add a board archived by Asagi.