tubearchivist
/
docs
mirror of https://github.com/tubearchivist/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

More fixes for formatting of tables and admonitions.

This commit is contained in:
lamusmaser 2024-04-20 05:59:20 -06:00
parent a13b738059
commit d765d9165c
1 changed files with 52 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
mkdocs/docs/installation/synology.md
View File

@ -71,21 +71,37 @@ Once all of the folders have been created, it should have a folder structure wit
1. Open an SSH connection to the Synology. Login as your primary `Admin` user, or the user that was enabled for SSH access.
2. Elevate your access to `root`. Steps are provided [here](https://kb.synology.com/en-sg/DSM/tutorial/How_to_login_to_DSM_with_root_permission_via_SSH_Telnet).
3. Change directories to the **Volume** where the "Docker" folder resides.
> !!! example "`cd /volume1`"
4. Change directories to the "Docker" folder.
> !!! example "`cd Docker`"
5. Change directories to the "TubeArchivist" folder.
> !!! example "`cd TubeArchivist`"
6. Change the owner of the "redis" folder. *If correct, this does not have an output.*
> !!! example "`chown 999:100 redis`"
7. Change the owner of the "es" folder. *If correct, this does not have an output.*
> !!! example "`chown 1000:0 es`"
8. Confirm that the folders have the correct permissions.
> !!! example "`ls -hl`"
![Synology - Docker Folder Permissions Command](../assets/Synology_0.3.6_Docker-Folder-Permissions-Commands.png)
9. Logout from root.
> !!! example "`logout`"
10. Disconnect from the SSH connection.
> !!! example "`exit`"
@ -124,6 +140,7 @@ Once all of the folders have been created, it should have a folder structure wit
#### 3. Configure ElasticSearch
**ElasticSearch**
1. Select the associated image.
2. Click the **Launch** button in the top.
3. Edit the **Container Name** to be "tubearchivist-es".
@ -138,13 +155,13 @@ Once all of the folders have been created, it should have a folder structure wit
| Environment Variable | Setting |
| :------------------- | :------ |
| `discovery.type | single-node` |
| `ES_JAVA_OPTS | -Xms512m -Xmx512m` |
| `UID | 1000` |
| `GID | 0` |
| `xpack.security.enabled | true` |
| `ELASTIC_PASSWORD | verysecret` |
| `path.repo | /usr/share/elasticsearch/data/snapshot` |
| `discovery.type` | `single-node` |
| `ES_JAVA_OPTS` | `-Xms512m -Xmx512m` |
| `UID` | `1000` |
| `GID` | `0` |
| `xpack.security.enabled` | `true` |
| `ELASTIC_PASSWORD` | `verysecret` |
| `path.repo` | `/usr/share/elasticsearch/data/snapshot` |
!!! danger "BE AWARE"
- Do not use the default password, as it is very insecure.
@ -157,7 +174,9 @@ Once all of the folders have been created, it should have a folder structure wit
14. Review the settings to confirm, then click the **Apply** button.
#### 4. Configure Redis
**Redis**
1. Select the associated image.
2. Click the **Launch** button in the top.
3. Edit the **Container Name** to be "tubearchivist-redis".
@ -173,7 +192,9 @@ Once all of the folders have been created, it should have a folder structure wit
13. Review the settings to confirm, then click the **Apply** button.
#### 5. Configure Tube Archivist
**Tube Archivist**
1. Select the associated image.
2. Click the **Launch** button in the top.
3. Edit the **Container Name** to be "tubearchivist".
@ -189,15 +210,15 @@ Once all of the folders have been created, it should have a folder structure wit
| Environment Variable | Setting |
| :------------------- | :------ |
| `TA_HOST | synology.local` |
| `ES_URL | http://tubearchivist-es:9200` |
| `REDIS_HOST | tubearchivist-redis` |
| `HOST_UID | 1000` |
| `HOST_GID | 0` |
| `TA_USERNAME | tubearchivist` |
| `TA_PASSWORD | verysecret` |
| `ELASTIC_PASSWORD | verysecret` |
| `TZ | America/New_York` |
| `TA_HOST` | `synology.local` |
| `ES_URL` | `http://tubearchivist-es:9200` |
| `REDIS_HOST` | `tubearchivist-redis` |
| `HOST_UID` | `1000` |
| `HOST_GID` | `0` |
| `TA_USERNAME` | `tubearchivist` |
| `TA_PASSWORD` | `verysecret` |
| `ELASTIC_PASSWORD` | `verysecret` |
| `TZ` | `America/New_York` |
!!! danger "BE AWARE"
- Do not use the default password as it is very insecure.
@ -211,14 +232,14 @@ Once all of the folders have been created, it should have a folder structure wit
### 6. Post-Installation Monitoring
6. After the containers have been configured and started, you can go to the **Container** tab and monitor the containers.
7. To review the logs to ensure that the system has started successfully, select the `tubearchivist` container and click on the **Details** button. In the new window, go to the **Log** tab. Monitor the logs until either an error occurs or the message `celery@tubearchivist ready.` is in the logs. This may take a few minutes, especially for a first time setup.
1. After the containers have been configured and started, you can go to the **Container** tab and monitor the containers.
2. To review the logs to ensure that the system has started successfully, select the `tubearchivist` container and click on the **Details** button. In the new window, go to the **Log** tab. Monitor the logs until either an error occurs or the message `celery@tubearchivist ready.` is in the logs. This may take a few minutes, especially for a first time setup.
> !!! note "Reviewing Logs"
Synology Docker presents the logs in a paginated format, showing in historical order (oldest first).
If you are not seeing the logs update, check if there are additional pages.
8. After it has started, go to the location provided in the `TA_HOST`. This should give you the standard **Tube Archivist** login screen.
3. After it has started, go to the location provided in the `TA_HOST`. This should give you the standard **Tube Archivist** login screen.
<!--
### Docker-Compose Setup -->
<!-- This section is a Work In Progress -->