gosora/docs/updating.md
Azareal 5ff6d8b6ee Cleaned up the update instructions and moved them into their own home.
Added more code blocks to make the instructions easier to follow.
2018-08-26 15:56:56 +10:00

3.7 KiB

Updating Gosora (Windows)

The update system is currently under development, but you can run dev-update.bat to update your instance to the latest commit and to update the associated database schema, etc.

If you run into any issues doing so, please open an issue: https://github.com/Azareal/Gosora/issues/new

If you want to manually patch Gosora rather than relying on the above scripts to do it, you'll first have to create a copy of ./schema/schema.json named ./schema/lastSchema.json, and then, you'll overwrite the files with the new ones with git pull origin master.

After that, you'll need to run go build ./patcher.

Once you've done that, you just need to run patcher.exe to apply the latest patches to the database, etc.

Updating a software with a simple installation (Linux)

The update system is currently under development, but you can run dev-update-linux to update your instance to the latest commit and to update the associated database schema, etc.

If you run into any issues doing so, please open an issue: https://github.com/Azareal/Gosora/issues/new

If you want to manually patch Gosora rather than relying on the above scripts to do it, you'll first have to create a copy of ./schema/schema.json named ./schema/lastSchema.json, and then, you'll overwrite the files with the new ones with git pull origin master.

After that, you'll need to run the following code block:

cd ./patcher
go build -o Patcher
mv ./Patcher ..

Once you've done that, you just need to run ./Patcher to apply the latest patches to the database, etc.

Updating a software using systemd (Linux)

You will first want to follow the instructions in the section for updating dependencies.

The update system is currently under development, but you can run quick-update-linux in /home/gosora/srcto update your instance to the latest commit and to update the associated database schema, etc.

If you run into any issues doing so, please open an issue: https://github.com/Azareal/Gosora/issues/new

If you're using a systemd service, then you might want to switch to the gosora user with su gosora (you may be prompted for the password to the user), you can switch back by typing exit. If this is the first time you've done an update as the gosora user, then you might have to configure Git, simply do:

git config --global user.name "Lalala" git config --global user.email "lalala@example.com"

Replace that name and email with whatever you like. This name and email only applies to the gosora user. If you see a zillion modified files pop-up, then that is due to you changing their permissions, don't worry about it.

If you get an access denied error, then you might need to run chown -R gosora /home/gosora and chgrp -R www-data /home/gosora to fix the ownership of the files.

If you want to manually patch Gosora rather than relying on the above scripts to do it, you'll first have to create a copy of ./schema/schema.json named ./schema/lastSchema.json, and then, you'll overwrite the files with the new ones with git pull origin master.

After that, you'll need to run:

cd ./patcher
go build -o Patcher
mv ./Patcher ..

Once you've done that, you just need to run ./Patcher to apply the latest patches to the database, etc.

Updating Dependencies

Dependencies are third party scripts and programs which Gosora relies on to function. The instructions here do not cover updating MySQL / MariaDB or Go.

You can update themn by running update-deps.bat on Windows or ./update-deps-linux on Linux.

You'll need to restart the server after you change a template or update Gosora, e.g. with run.bat or killing the process and running ./run-linux or via ./pre-run-linux followed by service gosora restart.