163 lines
2.7 KiB
Markdown
163 lines
2.7 KiB
Markdown
# Frequently Asked Questions
|
||
|
||
<br>
|
||
|
||
### My dump doesn't migrate.
|
||
|
||
_This assumes a running setup._
|
||
|
||
<br>
|
||
|
||
1. Enter into database container:
|
||
|
||
```sh
|
||
docker exec \
|
||
--interactive \
|
||
--username=nano \
|
||
--tty kemono-db psql \
|
||
kemonodb
|
||
```
|
||
|
||
<br>
|
||
|
||
2. Check the contents of the `posts` table.
|
||
|
||
```sql
|
||
SELECT * FROM posts;
|
||
```
|
||
|
||
_Most likely it has `0` rows._
|
||
|
||
<br>
|
||
|
||
3. Move contents of `booru_posts` ➞ `posts`
|
||
|
||
```sql
|
||
INSERT INTO posts SELECT * FROM booru_posts ON CONFLICT DO NOTHING;
|
||
```
|
||
|
||
<br>
|
||
|
||
4. Restart the archiver.
|
||
|
||
```sh
|
||
docker restart kemono-archiver
|
||
```
|
||
|
||
If you see a bunch of log entries from `kemono-db` , <br>
|
||
then this indicates that the archiver is doing it's job.
|
||
|
||
<br>
|
||
|
||
5. In case the frontend still doesn't show <br>
|
||
the artists / posts, clear the redis cache.
|
||
|
||
```sh
|
||
docker exec \
|
||
kemono-redis \
|
||
redis-cli \
|
||
FLUSHALL
|
||
```
|
||
|
||
<br>
|
||
<br>
|
||
|
||
### How do I git modules?
|
||
|
||
_This assumes you haven't cloned the repository recursively._
|
||
|
||
<br>
|
||
|
||
1. Initiate the submodules
|
||
|
||
```sh
|
||
git submodule init
|
||
git submodule update \
|
||
--recursive \
|
||
--init
|
||
```
|
||
|
||
<br>
|
||
|
||
2. Switch to the archiver folder and <br>
|
||
add your fork to the remotes list.
|
||
|
||
```sh
|
||
cd archiver
|
||
git remote add <remote_name> <your_fork_link>
|
||
```
|
||
|
||
<br>
|
||
|
||
3. Now you can interact with Kitsune repo the same <br>
|
||
way you do as if it was outside of project folder.
|
||
|
||
<br>
|
||
<br>
|
||
|
||
### How do I import from db dump?
|
||
|
||
<br>
|
||
|
||
1. Retrieve a database dump.
|
||
|
||
<br>
|
||
|
||
2. Run the following in the folder of said dump.
|
||
|
||
```sh
|
||
cat db-filename.dump \
|
||
| gunzip \
|
||
| docker exec \
|
||
--interactive kemono-db psql \
|
||
--username=nano kemonodb
|
||
```
|
||
|
||
<br>
|
||
|
||
3. Restart the archiver to trigger migrations.
|
||
|
||
```sh
|
||
docker restart kemono-archiver
|
||
```
|
||
|
||
<br>
|
||
|
||
If that didn't start the migrations, refer <br>
|
||
to [`My Dump Doesn't Migrate`] section.
|
||
|
||
<br>
|
||
<br>
|
||
|
||
### How do I put files into nginx container?
|
||
|
||
<br>
|
||
|
||
1. Retrieve the files in required folder structure.
|
||
|
||
<br>
|
||
|
||
2. Copy them into nginx image.
|
||
|
||
```sh
|
||
docker \
|
||
cp ./ kemono-nginx:/storage
|
||
```
|
||
|
||
<br>
|
||
|
||
3. Add required permissions to that folder.
|
||
|
||
```sh
|
||
docker \
|
||
exec kemono-nginx \
|
||
chown --recursive \
|
||
nginx /storage
|
||
```
|
||
|
||
<br>
|
||
|
||
<!----------------------------------------------------------------------------->
|
||
|
||
[`My Dump Doesn't Migrate`]: #my-dump-doesnt-migrate
|