mirror of
https://github.com/haiwen/seafile-admin-docs.git
synced 2025-12-25 18:22:48 +00:00
remove 12.0 upgrade notes in 11.0
This commit is contained in:
Junxiang Huang
parent
861a3555e5
commit
8368413181
|
|
@ -87,171 +87,3 @@ Just download the new image, stop the old docker container, modify the Seafile i
|
|||
## Upgrade from 7.0 to 7.1
|
||||
|
||||
Just download the new image, stop the old docker container, modify the Seafile image version in docker-compose.yml to the new version, then start with docker compose up.
|
||||
|
||||
|
||||
## Upgrade from 11.0 to 12.0 (In progress)
|
||||
|
||||
From Seafile Docker 12.0, we recommend that you use `.env` and `seafile-server.yml` files for configuration.
|
||||
|
||||
First, backup the original docker-compose.yml file:
|
||||
|
||||
```sh
|
||||
mv docker-compose.yml docker-compose.yml.bak
|
||||
```
|
||||
|
||||
Then download [.env](https://manual.seafile.com/11.0/docker/docker-compose/ce/12.0/env), [seafile-server.yml](https://manual.seafile.com/11.0/docker/docker-compose/ce/12.0/seafile-server.yml) and [caddy.yml](https://manual.seafile.com/11.0/docker/docker-compose/ce/12.0/caddy.yml), and modify .env file according to the old configuration in `docker-compose.yml.bak`
|
||||
|
||||
For community edition:
|
||||
|
||||
```sh
|
||||
wget -O .env https://manual.seafile.com/11.0/docker/docker-compose/ce/12.0/env
|
||||
wget https://manual.seafile.com/11.0/docker/docker-compose/ce/12.0/seafile-server.yml
|
||||
wget https://manual.seafile.com/11.0/docker/docker-compose/ce/12.0/caddy.yml
|
||||
```
|
||||
|
||||
For pro edition:
|
||||
|
||||
```sh
|
||||
wget -O .env https://manual.seafile.com/11.0/docker/docker-compose/pro/12.0/env
|
||||
wget https://manual.seafile.com/11.0/docker/docker-compose/pro/12.0/seafile-server.yml
|
||||
wget https://manual.seafile.com/11.0/docker/docker-compose/pro/12.0/caddy.yml
|
||||
```
|
||||
|
||||
The following fields merit particular attention:
|
||||
|
||||
* The volume directory of Seafile data (SEAFILE_VOLUMES, same as the seafile volumes in the old docker-compose.yml)
|
||||
* The volume directory of MySQL data (SEAFILE_MYSQL_VOLUMES, same as the mysql volumes in the old docker-compose.yml)
|
||||
* The volume directory of Elasticsearch data (SEAFILE_ELASTICSEARCH_VOLUMES, pro edition only, same as the elasticsearch volumes in the old docker-compose.yml)
|
||||
* The volume directory of Caddy data (SEAFILE_CADDY_VOLUMES)
|
||||
* The user of MySQL (SEAFILE_MYSQL_DB_USER, `database` - `user` can be found in `conf/seafile.conf`)
|
||||
* The password of MySQL (SEAFILE_MYSQL_DB_PASSWORD, `database` - `password` can be found in `conf/seafile.conf`)
|
||||
* jwt (JWT_PRIVATE_KEY, A random string with a length of no less than 32 characters, generate example: `pwgen -s 40 1`)
|
||||
* SEAFILE_SERVER_HOSTNAME (SEAFILE_SERVER_HOSTNAME, same as the SEAFILE_SERVER_HOSTNAME in the old docker-compose.yml)
|
||||
* SEAFILE_SERVER_PROTOCOL (SEAFILE_SERVER_PROTOCOL, use http or https)
|
||||
|
||||
SSL is now handled by the caddy server. If you have used SSL before, you will also need modify the seafile.nginx.conf. Change server listen 443 to 80.
|
||||
|
||||
Backup the original seafile.nginx.conf file:
|
||||
|
||||
```sh
|
||||
cp seafile.nginx.conf seafile.nginx.conf.bak
|
||||
```
|
||||
|
||||
Remove the `server listen 80` section:
|
||||
|
||||
```config
|
||||
#server {
|
||||
# listen 80;
|
||||
# server_name _ default_server;
|
||||
|
||||
# allow certbot to connect to challenge location via HTTP Port 80
|
||||
# otherwise renewal request will fail
|
||||
# location /.well-known/acme-challenge/ {
|
||||
# alias /var/www/challenges/;
|
||||
# try_files $uri =404;
|
||||
# }
|
||||
|
||||
# location / {
|
||||
# rewrite ^ https://example.seafile.com$request_uri? permanent;
|
||||
# }
|
||||
#}
|
||||
```
|
||||
|
||||
Change `server listen 443` to `80`:
|
||||
|
||||
```config
|
||||
server {
|
||||
#listen 443 ssl;
|
||||
listen 80;
|
||||
|
||||
# ssl_certificate /shared/ssl/pkg.seafile.top.crt;
|
||||
# ssl_certificate_key /shared/ssl/pkg.seafile.top.key;
|
||||
|
||||
# ssl_ciphers ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:ECDH+3DES:DH+3DES:RSA+AESGCM:RSA+AES:RSA+3DES:!aNULL:!MD5:!DSS;
|
||||
|
||||
...
|
||||
```
|
||||
|
||||
Start with docker compose up.
|
||||
|
||||
### Upgrade SeaDoc from 0.8 to 1.0 for Seafile v12.0
|
||||
|
||||
If you have deployed SeaDoc extension in version 11.0, please use the following steps to upgrade it to version 1.0.
|
||||
|
||||
SeaDoc 1.0 is for working with Seafile 12.0. SeaDoc and Seafile are deployed in the same directory. SeaDoc has no state in itself. You can simplify delete old configuration file and directory of v0.8. Then deploy SeaDoc 1.0 as following.
|
||||
|
||||
In version 1.0, we use .env file to configure SeaDoc docker image, instead of modifying the docker-compose.yml file directly.
|
||||
|
||||
Download [seadoc.yml](https://manual.seafile.com/11.0/docker/docker-compose/ce/12.0/seadoc.yml) to the Seafile `seafile-server.yml` directory, then modify Seafile .env file.
|
||||
|
||||
For community edition:
|
||||
|
||||
```sh
|
||||
wget https://manual.seafile.com/11.0/docker/docker-compose/ce/12.0/seadoc.yml
|
||||
```
|
||||
|
||||
For pro edition:
|
||||
|
||||
```sh
|
||||
wget https://manual.seafile.com/11.0/docker/docker-compose/pro/12.0/seadoc.yml
|
||||
```
|
||||
|
||||
```env
|
||||
COMPOSE_FILE='seafile-server.yml,caddy.yml,seadoc.yml'
|
||||
|
||||
SEADOC_VOLUMES=/opt/seadoc-data
|
||||
ENABLE_SEADOC=true
|
||||
SEADOC_SERVER_URL=http://example.seafile.com/sdoc-server
|
||||
```
|
||||
|
||||
The following fields merit particular attention:
|
||||
|
||||
* Add `seadoc.yml` to the `COMPOSE_FILE` field.
|
||||
* The volume directory of SeaDoc data (SEADOC_VOLUMES)
|
||||
* Enable SeaDoc (ENABLE_SEADOC)
|
||||
* SeaDoc service url (SEADOC_SERVER_URL, hostname + `/sdoc-server`)
|
||||
|
||||
If you have deployed SeaDoc older version, you should remove `/sdoc-server/`, `/socket.io` configs in seafile.nginx.conf file.
|
||||
|
||||
```config
|
||||
# location /sdoc-server/ {
|
||||
# add_header Access-Control-Allow-Origin *;
|
||||
# add_header Access-Control-Allow-Methods GET,POST,PUT,DELETE,OPTIONS;
|
||||
# add_header Access-Control-Allow-Headers "deviceType,token, authorization, content-type";
|
||||
# if ($request_method = 'OPTIONS') {
|
||||
# add_header Access-Control-Allow-Origin *;
|
||||
# add_header Access-Control-Allow-Methods GET,POST,PUT,DELETE,OPTIONS;
|
||||
# add_header Access-Control-Allow-Headers "deviceType,token, authorization, content-type";
|
||||
# return 204;
|
||||
# }
|
||||
# proxy_pass http://sdoc-server:7070/;
|
||||
# proxy_redirect off;
|
||||
# proxy_set_header Host $host;
|
||||
# proxy_set_header X-Real-IP $remote_addr;
|
||||
# proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
# proxy_set_header X-Forwarded-Host $server_name;
|
||||
# proxy_set_header X-Forwarded-Proto $scheme;
|
||||
# client_max_body_size 100m;
|
||||
# }
|
||||
# location /socket.io {
|
||||
# proxy_pass http://sdoc-server:7070;
|
||||
# proxy_http_version 1.1;
|
||||
# proxy_set_header Upgrade $http_upgrade;
|
||||
# proxy_set_header Connection 'upgrade';
|
||||
# proxy_redirect off;
|
||||
# proxy_buffers 8 32k;
|
||||
# proxy_buffer_size 64k;
|
||||
# proxy_set_header X-Real-IP $remote_addr;
|
||||
# proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
# proxy_set_header Host $http_host;
|
||||
# proxy_set_header X-NginX-Proxy true;
|
||||
# }
|
||||
```
|
||||
|
||||
Start Seafile server and SeaDoc server with the following command
|
||||
|
||||
```sh
|
||||
docker compose down
|
||||
|
||||
docker compose up -d
|
||||
```
|
||||
|
|
|
|||
|
|
@ -1,113 +0,0 @@
|
|||
# Upgrade notes for 12.0 (In progress)
|
||||
|
||||
These notes give additional information about changes.
|
||||
Please always follow the main [upgrade guide](./upgrade.md).
|
||||
|
||||
For docker based version, please check [upgrade Seafile Docker image](./upgrade_docker.md)
|
||||
|
||||
## Important release changes
|
||||
|
||||
Seafile version 12.0 has following major changes:
|
||||
|
||||
* A redesigned Web UI
|
||||
* SeaDoc is now stable, providing online notes and documents feature
|
||||
* A new wiki module (still in beta, disabled by default)
|
||||
* A new trash mechanism, that deleted files will be recorded in database for fast listing. In the old version, deleted files are scanned from library history, which is slow.
|
||||
|
||||
Other changes:
|
||||
|
||||
* A new lightweight and fast search engine, SeaSearch. SeaSearch is optional, you can still use ElasticSearch.
|
||||
|
||||
Breaking changes
|
||||
|
||||
* For security reason, WebDAV no longer support login with LDAP account, the user with LDAP account must generate a WebDAV token at the profile page
|
||||
* The password strength level is now calculated by algorithm. The old USER_PASSWORD_MIN_LENGTH, USER_PASSWORD_STRENGTH_LEVEL is removed. Only USER_STRONG_PASSWORD_REQUIRED is still used.
|
||||
* For binary package based installation, a new `.env` file is needed to contain some configuration items. These configuration items need to be shared by different components in Seafile. We name it `.env` to be consistant with docker based installation.
|
||||
* [File tags] The current file tags feature is deprecated. We will re-implement a new one in version 13.0 with a new general metadata management module.
|
||||
|
||||
Deploying SeaDoc and Seafile binary package on the same server is no longer supported. You can:
|
||||
|
||||
* Deploy SeaDoc on a new server and integrate it with Seafile.
|
||||
* Migrate Seafile to a docker based deployment method and then deploy SeaDoc in the same server.
|
||||
|
||||
Deploying Seafile with binary package is now deprecated and probably no longer be supported in version 13.0. We recommend you to migrate your existing Seafile deployment to docker based.
|
||||
|
||||
|
||||
### ElasticSearch change (pro edition only)
|
||||
|
||||
Elasticsearch version is not changed in Seafile version 12.0
|
||||
|
||||
## New Python libraries
|
||||
|
||||
Note, you should install Python libraries system wide using root user or sudo mode.
|
||||
|
||||
For Ubuntu 22.04/24.04
|
||||
|
||||
```sh
|
||||
sudo pip3 install future==1.0.* mysqlclient==2.2.* pillow==10.4.* sqlalchemy==2.0.* gevent==24.2.* captcha==0.6.* django_simple_captcha==0.6.* djangosaml2==1.9.* pysaml2==7.3.* pycryptodome==3.20.* cffi==1.17.0 python-ldap==3.4.* PyMuPDF==1.24.*
|
||||
```
|
||||
|
||||
## Upgrade to 12.0.x
|
||||
|
||||
### 1) Stop Seafile-11.0.x server
|
||||
|
||||
### 2) Start from Seafile 12.0.x, run the script
|
||||
|
||||
```sh
|
||||
upgrade/upgrade_11.0_12.0.sh
|
||||
```
|
||||
|
||||
### 3) Create the `.env` file in conf/ directory
|
||||
|
||||
conf/.env
|
||||
|
||||
```env
|
||||
JWT_PRIVATE_KEY=xxx
|
||||
```
|
||||
|
||||
Note: JWT_PRIVATE_KEY, A random string with a length of no less than 32 characters, generate example: `pwgen -s 40 1`
|
||||
|
||||
### 4) Start Seafile-12.0.x server
|
||||
|
||||
## Upgrade SeaDoc from 0.8 to 1.0
|
||||
|
||||
If you have deployed SeaDoc extension in version 11.0, please use the following steps to upgrade it to version 1.0.
|
||||
|
||||
Deploying SeaDoc and Seafile binary package on the same server is no longer supported. You can:
|
||||
|
||||
* Deploy SeaDoc on a new server and integrate it with Seafile.
|
||||
* Migrate Seafile to a docker based deployment method and then deploy SeaDoc in the same server.
|
||||
|
||||
If you have deployed SeaDoc extension in version 11.0 on a standalone server, please use the following steps to upgrade it to version 1.0.
|
||||
|
||||
### Delete sdoc_db
|
||||
|
||||
From version 1.0, SeaDoc is using seahub_db database to store its operation logs and no longer need an extra database sdoc_db. You can simply delete sdoc_db.
|
||||
|
||||
|
||||
### Deploy a new SeaDoc server
|
||||
|
||||
In version 1.0, we use env file to configure SeaDoc docker image, instead of modifying the docker-compose.yml file directly.
|
||||
|
||||
Download [.env](https://manual.seafile.com/11.0/docker/docker-compose/seadoc/1.0/standalone/env) and [docker-compose.yml](https://manual.seafile.com/11.0/docker/docker-compose/seadoc/1.0/standalone/docker-compose.yml), then modify .env file.
|
||||
|
||||
The following fields merit particular attention:
|
||||
|
||||
* Seafile MySQL host (SEAFILE_MYSQL_DB_HOST)
|
||||
* Seafile MySQL user (SEAFILE_MYSQL_DB_USER)
|
||||
* Seafile MySQL password (SEAFILE_MYSQL_DB_PASSWD)
|
||||
* The volume directory of SeaDoc data (SEADOC_VOLUMES)
|
||||
* SeaDoc service URL (SDOC_SERVER_HOSTNAME)
|
||||
* Seafile service URL (SEAHUB_SERVICE_URL)
|
||||
|
||||
Start SeaDoc server with the following command
|
||||
|
||||
```sh
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
## FAQ
|
||||
|
||||
We have documented common issues encountered by users when upgrading to version 12.0 in our FAQ <https://cloud.seatable.io/dtable/external-links/7b976c85f504491cbe8e/?tid=0000&vid=0000>.
|
||||
|
||||
If you encounter any issue, please give it a check.
|
||||
|
|
@ -161,7 +161,6 @@ nav:
|
|||
- Upgrade notes for 9.0.x: upgrade/upgrade_notes_for_9.0.x.md
|
||||
- Upgrade notes for 10.0.x: upgrade/upgrade_notes_for_10.0.x.md
|
||||
- Upgrade notes for 11.0.x: upgrade/upgrade_notes_for_11.0.x.md
|
||||
- Upgrade notes for 12.0.x (In progress): upgrade/upgrade_notes_for_12.0.x.md
|
||||
- Developing:
|
||||
- Outline: develop/README.md
|
||||
- How to Build Seafile:
|
||||
|
|
|
|||
Loading…
Reference in New Issue