mirror of
https://github.com/haiwen/seafile-admin-docs.git
synced 2025-12-25 18:22:48 +00:00
Update server.md
This commit is contained in:
lian
GitHub
parent
d617cbf45a
commit
6a85856643
|
|
@ -1,393 +1,197 @@
|
|||
# Server
|
||||
This is the document for deploying Seafile open source development environment in Ubuntu 1804 docker container.
|
||||
|
||||
## Preparation
|
||||
|
||||
The following list is all the libraries you need to install on your machine. **You should install all of them before you build seafile**.
|
||||
|
||||
Package names are according to Ubuntu 12.04. For other Linux distros, please find their corresponding names yourself.
|
||||
|
||||
* libevent-dev (2.0 or later )
|
||||
* libcurl4-openssl-dev (1.0.0 or later)
|
||||
* libglib2.0-dev (2.28 or later)
|
||||
* uuid-dev
|
||||
* intltool (0.40 or later)
|
||||
* libsqlite3-dev (3.8 or later)
|
||||
* libmysqlclient-dev (5.5 or later)
|
||||
* libarchive-dev
|
||||
* libtool
|
||||
* libjansson-dev
|
||||
* valac
|
||||
* libfuse-dev
|
||||
|
||||
Also, python 2.7 is required since seafile server 5.1.0.
|
||||
|
||||
The following libraries need to be compiled from source.
|
||||
|
||||
### Notes about MySQL client library
|
||||
|
||||
You can also use MariaDB's LGPL Connector/C library. Download the latest stable version of the library on <https://downloads.mariadb.org/connector-c/> then compile and install the library.
|
||||
## Run a container
|
||||
|
||||
```
|
||||
cmake .
|
||||
make
|
||||
sudo make install
|
||||
|
||||
docker run -it -p 8000:8000 -p 8082:8082 --name seafile-ce-env ubuntu:18.04 bash
|
||||
```
|
||||
|
||||
By default the library will be installed under `/usr/local/lib/mariadb`. Add this path to your `LD_LIBRARY_PATH` environment variable so the loader can find this library.
|
||||
Note, the following commands are all executed in the seafile-ce-env docker container.
|
||||
|
||||
## Update Source and Install Dependencies.
|
||||
|
||||
```
|
||||
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib/mariadb
|
||||
apt-get update && apt-get upgrade -y
|
||||
|
||||
apt-get install -y ssh libevent-dev libcurl4-openssl-dev libglib2.0-dev uuid-dev intltool libsqlite3-dev libmysqlclient-dev libarchive-dev libtool libjansson-dev valac libfuse-dev python-dateutil cmake re2c flex sqlite3 python-pip python-simplejson git libssl-dev libldap2-dev libonig-dev vim vim-scripts wget cmake gcc autoconf automake mysql-client librados-dev libxml2-dev curl sudo telnet netcat unzip netbase ca-certificates apt-transport-https build-essential libxslt1-dev libffi-dev libpcre3-dev libz-dev xz-utils nginx pkg-config poppler-utils libmemcached-dev sudo
|
||||
|
||||
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
|
||||
apt-get install -y nodejs
|
||||
|
||||
apt-get install -y python3-pip python3.6 python3.6-dev
|
||||
|
||||
python3.6 -m pip install --upgrade pip
|
||||
|
||||
rm /usr/bin/python
|
||||
rm /usr/bin/python3
|
||||
ln -s /usr/bin/python3.6 /usr/bin/python
|
||||
ln -s /usr/bin/python3.6 /usr/bin/python3
|
||||
|
||||
rm /usr/bin/pip
|
||||
rm /usr/bin/pip3
|
||||
ln -s /usr/local/bin/pip3.6 /usr/bin/pip
|
||||
ln -s /usr/local/bin/pip3.6 /usr/bin/pip3
|
||||
|
||||
pip install python-cas djangosaml2 cffi sqlalchemy pymysql pillow pycryptodome configparser pylibmc django-pylibmc elasticsearch==5.5.0 elasticsearch-dsl==5.4.0 Django==2.2.14 future captcha django-statici18n django-post_office==3.3.0 django-webpack_loader gunicorn mysqlclient django-picklefield==2.1.1 openpyxl qrcode django-formtools django-simple-captcha djangorestframework==3.11.1 python-dateutil requests pillow pyjwt pycryptodome requests_oauthlib mock nose exam splinter pytest pytest-django
|
||||
```
|
||||
|
||||
### libevhtp
|
||||
|
||||
* Download [libevhtp](https://github.com/ellzey/libevhtp/archive/1.1.6.tar.gz).
|
||||
* Build libevhtp by:
|
||||
|
||||
## Install MariaDB and Create Databases
|
||||
|
||||
```
|
||||
apt-get install -y mariadb-server
|
||||
service mysql start
|
||||
mysqladmin -u root password 123456
|
||||
```
|
||||
|
||||
sql for create databases
|
||||
|
||||
```
|
||||
create database ccnet charset utf8;
|
||||
create database seafile charset utf8;
|
||||
create database seahub charset utf8;
|
||||
```
|
||||
|
||||
## Download Source Code
|
||||
|
||||
```
|
||||
cd ~/
|
||||
mkdir -p ~/dev/source-code
|
||||
cd ~/dev/source-code
|
||||
|
||||
git clone https://github.com/haiwen/libevhtp.git
|
||||
git clone https://github.com/haiwen/libsearpc.git
|
||||
git clone https://github.com/haiwen/seafobj.git
|
||||
git clone https://github.com/haiwen/seafile-server.git
|
||||
git clone https://github.com/haiwen/seahub.git
|
||||
|
||||
cd libsearpc/
|
||||
git fetch origin 8.0:8.0
|
||||
git checkout 8.0
|
||||
|
||||
cd ../seafile-server
|
||||
git checkout tags/v8.0.0-server -b tag-v8.0.0-server
|
||||
|
||||
cd ../seahub
|
||||
git checkout tags/v8.0.0-server -b tag-v8.0.0-server
|
||||
|
||||
cd ../seafobj
|
||||
git checkout tags/v8.0.0-server -b tag-v8.0.0-server
|
||||
```
|
||||
|
||||
## Compile and Install seaf-server
|
||||
|
||||
```
|
||||
cd ../libevhtp
|
||||
cmake -DEVHTP_DISABLE_SSL=ON -DEVHTP_BUILD_SHARED=OFF .
|
||||
make
|
||||
sudo make install
|
||||
make install
|
||||
ldconfig
|
||||
|
||||
```
|
||||
|
||||
### Seahub dependencies
|
||||
|
||||
**Seahub** is the web front end of Seafile. It's written in the [django](http://djangoproject.com) framework. Seahub requires Python 2.6(or 2.7) installed on your server, and it needs the following python libraries:
|
||||
|
||||
* Django 1.8
|
||||
* pytz
|
||||
* django-statici18n
|
||||
* djangorestframework
|
||||
* django_compressor
|
||||
* django-post_office
|
||||
* [django-constance](https://github.com/haiwen/django-constance/) (install it by `pip install https://github.com/haiwen/django-constance/archive/bde7f7c.zip`)
|
||||
* gunicorn
|
||||
* flup
|
||||
* chardet
|
||||
* python-dateutil
|
||||
* six
|
||||
* openpyxl
|
||||
|
||||
Before continue, make sure you have all the above libraries available in your system.
|
||||
|
||||
### Prepare the directory layout
|
||||
|
||||
In the following sections, you'll be guided to build and setup the seafile server step by step. Seafile server is consisted of several components. In order for them to function correctly, you must:
|
||||
|
||||
* Follow our instructions step by step
|
||||
* Make sure your directory layout is exactly the same with the guide in each step.
|
||||
|
||||
First create the top level directory. In the following sections, we'll use "/data/haiwen" as the top level directory.
|
||||
|
||||
```
|
||||
mkdir /data/haiwen/
|
||||
cd /data/haiwen/
|
||||
mkdir seafile-server
|
||||
cd seafile-server
|
||||
|
||||
```
|
||||
|
||||
The currently layout is:
|
||||
|
||||
```
|
||||
haiwen/
|
||||
└── seafile-server
|
||||
|
||||
```
|
||||
|
||||
### Get the source
|
||||
|
||||
First you should get the latest source of libsearpc/ccnet-server/seafile-server/seahub
|
||||
|
||||
Download the source tarball of the latest tag from
|
||||
|
||||
* <https://github.com/haiwen/libsearpc/tags>
|
||||
* <https://github.com/haiwen/ccnet-server/tags>
|
||||
* <https://github.com/haiwen/seafile-server/tags>
|
||||
* <https://github.com/haiwen/seahub/tags>
|
||||
|
||||
For example, if the latest released seafile server is 6.0.1, then just use the **v6.0.1-server** tags of the projects (except for libsearpc, which uses the **v3.0-latest** tag). You should get four tarballs:
|
||||
|
||||
* libsearpc-3.0-latest.tar.gz
|
||||
* ccnet-server-6.0.1-server.tar.gz
|
||||
* seafile-server-6.0.1-server.tar.gz
|
||||
* seahub-6.0.1-server.tar.gz
|
||||
|
||||
Create a folder `haiwen/src`, and uncompress libsearpc/ccnet/seafile source to it.
|
||||
|
||||
```
|
||||
cd haiwen/seafile-server
|
||||
mkdir src
|
||||
cd src
|
||||
tar xf /path/to/libsearpc-3.0-latest.tar.gz
|
||||
tar xf /path/to/ccnet-server-6.0.1-server.tar.gz
|
||||
tar xf /path/to/seafile-server-6.0.1-server.tar.gz
|
||||
|
||||
```
|
||||
|
||||
And uncompress seahub tarball to `haiwen/seafile-server`:
|
||||
|
||||
```
|
||||
cd haiwen/seafile-server
|
||||
tar xf /path/to/seahub-6.0.1-server.tar.gz
|
||||
mv seahub-6.0.1-server seahub
|
||||
|
||||
```
|
||||
|
||||
So far, The current directory layout is:
|
||||
|
||||
```
|
||||
haiwen/
|
||||
└── seafile-server
|
||||
└── seahub
|
||||
└── src
|
||||
├── libsearpc-6.0.1-server
|
||||
├── ccnet-server-6.0.1-server
|
||||
├── seafile-server-6.0.1-server
|
||||
├── ... (other files)
|
||||
|
||||
```
|
||||
|
||||
### Building
|
||||
|
||||
To build seafile server, you need first build **libsearpc** and **ccnet-server**.
|
||||
|
||||
##### libsearpc
|
||||
|
||||
```
|
||||
cd libsearpc-${version}
|
||||
cd ../libsearpc
|
||||
./autogen.sh
|
||||
./configure
|
||||
make
|
||||
make install
|
||||
ldconfig
|
||||
|
||||
```
|
||||
|
||||
##### ccnet-server
|
||||
|
||||
```
|
||||
cd ccnet-server-${version}
|
||||
cd ../seafile-server
|
||||
./autogen.sh
|
||||
./configure # `export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig` if libsearpc is not found
|
||||
./configure --disable-fuse
|
||||
make
|
||||
make install
|
||||
|
||||
ldconfig
|
||||
```
|
||||
|
||||
By default, `configure` tries to find MySQL and Postgresql client libraries in the system. If you do not want to support MySQL or Postgresql, use the following configure options:
|
||||
## Create Conf Files
|
||||
|
||||
```
|
||||
./configure --without-mysql --without-postgresql
|
||||
mkdir ~/dev/conf
|
||||
cd ~/dev/conf
|
||||
|
||||
cat > ccnet.conf <<EOF
|
||||
[Database]
|
||||
ENGINE = mysql
|
||||
HOST = localhost
|
||||
PORT = 3306
|
||||
USER = root
|
||||
PASSWD = 123456
|
||||
DB = ccnet
|
||||
CONNECTION_CHARSET = utf8
|
||||
CREATE_TABLES = true
|
||||
|
||||
[General]
|
||||
SERVICE_URL = http://127.0.0.1:8000
|
||||
EOF
|
||||
|
||||
cat > seahub_settings.py <<EOF
|
||||
DATABASES = {
|
||||
'default': {
|
||||
'ENGINE': 'django.db.backends.mysql',
|
||||
'NAME': 'seahub',
|
||||
'USER': 'root',
|
||||
'PASSWORD': '123456',
|
||||
'HOST': 'localhost',
|
||||
'PORT': '3306',
|
||||
}
|
||||
}
|
||||
FILE_SERVER_ROOT = 'http://127.0.0.1:8082'
|
||||
EOF
|
||||
|
||||
|
||||
mkdir ~/dev/seafile-data
|
||||
cd ~/dev/seafile-data
|
||||
|
||||
cat > seafile.conf <<EOF
|
||||
[database]
|
||||
type = mysql
|
||||
host = localhost
|
||||
port = 3306
|
||||
user = root
|
||||
password = 123456
|
||||
db_name = seafile
|
||||
connection_charset = utf8
|
||||
create_tables = true
|
||||
EOF
|
||||
```
|
||||
|
||||
If you want to use MariaDB Connector/C library, use the following configure option:
|
||||
## Start seaf-server
|
||||
|
||||
```
|
||||
./configure --with-mysql=/usr/local/bin/mariadb_config
|
||||
|
||||
seaf-server -c /root/dev/conf -d /root/dev/seafile-data -D all -f -l - &
|
||||
```
|
||||
|
||||
##### seafile-server
|
||||
## Start seahub
|
||||
|
||||
### Prepare environment variables
|
||||
|
||||
```
|
||||
cd seafile-${version}
|
||||
./autogen.sh
|
||||
./configure
|
||||
make
|
||||
make install
|
||||
cd ~/dev/source-code/seahub/
|
||||
|
||||
export PYTHONPATH=/usr/local/lib/python3.6/site-packages/:/root/dev/source-code/seahub/thirdpart:$PYTHONPATH
|
||||
export CCNET_CONF_DIR=/root/dev/conf
|
||||
export SEAFILE_CONF_DIR=/root/dev/seafile-data
|
||||
```
|
||||
|
||||
You can use the same options as ccnet-server to configure MySQL and Postgresql client libraries.
|
||||
|
||||
_Note_: You need to run `sudo ldconfig` to refresh the system libraries cache after you compiles all the components.
|
||||
|
||||
## Deploy Seafile Server
|
||||
|
||||
### Components of the Seafile Server
|
||||
|
||||
The seafile server consists of the following components:
|
||||
|
||||
|
||||
|
||||
* **ccnet** stores its configuration and metadata is a directory named `ccnet`.
|
||||
* **seaf-server** store its configuration and data in a directory, normally named `seafile-data`.
|
||||
* **seahub** is written in Django. If you have any experience with Django, you should know the `syncdb` command must be run to create all the database tables.
|
||||
* An **admin account** has to be created, so that you, the admin, can login with this account to manage the server.
|
||||
|
||||
These are the essential steps to create the configuration:
|
||||
|
||||
* ensure seafile is already installed and all the python libraries seahub needs are installed.
|
||||
* create the ccnet configuration with the **ccnet-init** program
|
||||
* create the seafile configuration with **seaf-server-init** program
|
||||
* run Django **syncdb** command for seahub
|
||||
* create an admin account for the seafile server
|
||||
|
||||
To create the configurations, you can either:
|
||||
|
||||
* use the seafile-admin script(see below)
|
||||
* \[\[create server configuration by hand]]
|
||||
|
||||
### Create Configurations with the seafile-admin script
|
||||
|
||||
`seafile-admin` should have been installed to system path after you have built and installed Seafile from source.
|
||||
### Create seahub database tables
|
||||
|
||||
```
|
||||
usage: seafile-admin [-h] {setup,start,stop,reset-admin} ...
|
||||
|
||||
optional arguments:
|
||||
-h, --help show this help message and exit
|
||||
|
||||
subcommands:
|
||||
|
||||
{setup,start,stop,reset-admin}
|
||||
setup setup the seafile server
|
||||
start start the seafile server
|
||||
stop stop the seafile server
|
||||
reset-admin reset seafile admin account
|
||||
|
||||
python manage.py migrate
|
||||
```
|
||||
|
||||
Go to the top level directory(in this guide it's **/data/haiwen/**), and run **seafile-admin setup** to create all the configuration:
|
||||
### Create user
|
||||
|
||||
```
|
||||
cd /data/haiwen
|
||||
export PYTHONPATH=/data/haiwen/seafile-server/seahub/thirdpart
|
||||
seafile-admin setup
|
||||
|
||||
python manage.py createsuperuser
|
||||
```
|
||||
|
||||
The script would ask you a series of questions, and create all the configuration for you.
|
||||
|
||||
This is a screenshot of the **seafile-admin setup** command:
|
||||
|
||||
|
||||
And a screenshot after setup is finished successfully:
|
||||
|
||||
|
||||
At this time, the directory layout would be like this:
|
||||
### Start seahub
|
||||
|
||||
```
|
||||
haiwen/
|
||||
└── ccnet # ccnet config directory
|
||||
└── ccnet.conf # ccnet config file
|
||||
└── seafile-data # seafile configuration and data
|
||||
└── seafile.conf # seafile config file
|
||||
└── seahub-data/ # seahub data
|
||||
└── seahub.db # seahub sqlite3 database
|
||||
└── seahub_settings.py # custom settings for seahub
|
||||
└── seafile-server
|
||||
└── seahub/
|
||||
└── seafile-{VERSION} # seafile source code
|
||||
|
||||
python manage.py runserver 0.0.0.0:8000
|
||||
```
|
||||
|
||||
### Start the Seafile Server
|
||||
Then, you can visit <http://127.0.0.1:8000/> to use Seafile.
|
||||
|
||||
After configuration successfully created, run **seafile-admin start** in the top directory to start the all components of Seafile. ( **You should always run the seafile-admin script in the top directory** ).
|
||||
## The Final Directory Structure
|
||||
|
||||
```
|
||||
cd /data/haiwen # go to the top level directory
|
||||
seafile-admin start
|
||||
|
||||
```
|
||||
|
||||
At this moment, all the components should be running and seahub can be visited at <http://yourserver-ip-or-domain:8000>
|
||||
|
||||
**Note** You may want to deploy seahub with nginx or apache. In this case, follow the instructions on Deploy Seafile Web With [Nginx](../deploy/deploy_with_nginx.md)/[Apache](../deploy/deploy_with_apache.md).
|
||||
|
||||
### Stop the Seafile Server
|
||||
|
||||
To stop seafile server, run **seafile-admin stop**.
|
||||
|
||||
```
|
||||
cd /data/haiwen # go to the top level directory
|
||||
seafile-admin stop
|
||||
|
||||
```
|
||||
|
||||
## Upgrade the Seafile Server
|
||||
|
||||
When you want to upgrade to a new vesrion of seafile server, you need to:
|
||||
|
||||
* Stop the seafile server if it's running
|
||||
|
||||
|
||||
```
|
||||
cd /data/haiwen
|
||||
seafile-admin stop
|
||||
|
||||
```
|
||||
|
||||
* Get and latest source code and build libsearpc/ccnet/seafile, just as what you do in a fresh setup.
|
||||
* Run the upgrade script. The upgrade script mainly updates database used by seafile for you. For example, create a new database table that is used in the latest seafile server but not in the previous version.
|
||||
|
||||
### Get and compile the latest libsearpc/ccnet/seafile
|
||||
|
||||
See the **Building** section above.
|
||||
|
||||
### Get the new seahub tarball and uncompress it
|
||||
|
||||
```
|
||||
cd haiwen/seafile-server
|
||||
mv seahub/ seahub-old # move away the old seahub folder
|
||||
tar xf /path/to/new/seahub-x.x.x-server.tar.gz
|
||||
mv seahub-x.x.x-server seahub
|
||||
|
||||
```
|
||||
|
||||
### Do the upgrade
|
||||
|
||||
* copy the scripts/upgrade/ subdir outside
|
||||
|
||||
The upgrade scripts is distributed in the `scripts/upgrade` subdir of seafile source code, we need to copy it to **seafile-server** directory before run the scripts.
|
||||
|
||||
```
|
||||
cd /data/haiwen/seafile-server
|
||||
cp -rf seafile-{version}/scripts/upgrade .
|
||||
|
||||
```
|
||||
|
||||
#### Continuous Upgrade (like from 1.1 to 1.2)
|
||||
|
||||
Continuous upgrade means to upgrade from one version of seafile server to the next version. For example, upgrading from 1.1.0 to 1.2.0 is a continuous upgrade.
|
||||
|
||||
**Note:** Minor upgrade, like upgrade from 1.3.0 to 1.3.1, is documented in a separate section below.
|
||||
|
||||
Say you are upgrading from 1.1.0 to 1.2.0, you should run the script **upgrade_1.1_1.2.sh** in `seafile-server` directory.
|
||||
|
||||
```
|
||||
cd /data/haiwen/seafile-server
|
||||
./upgrade/upgrade_1.1_1.2.sh
|
||||
|
||||
```
|
||||
|
||||
#### Non-continous version upgrade(like from 1.1 to 1.3)
|
||||
|
||||
If you upgrade a few versions at once, e.g. from 1.1.0 to 1.3.0. The procedure is:
|
||||
|
||||
* upgrade from 1.1.0 to 1.2.0
|
||||
* upgrade from 1.2.0 to 1.3.0
|
||||
|
||||
Just run the upgrade scripts in sequence.
|
||||
|
||||
#### Minor Upgrade (like from 1.3.0 to 1.3.1)
|
||||
|
||||
Minor upgrade Minor upgrade is like an upgrade from 1.3.0 to 1.3.1. For this type of upgrade, you only need to update the avatar link:
|
||||
|
||||
```
|
||||
cd /data/haiwen/seafile-server/seahub/media
|
||||
cp -rf avatars/* ../../../seahub-data/avatars/
|
||||
rm -rf avatars
|
||||
ln -s ../../../seahub-data/avatars
|
||||
|
||||
```
|
||||
|
||||
## Problems Report
|
||||
|
||||
If you encounter any problem when building/deploying Seafile, please leave us a message or [open an issue](https://github.com/haiwen/seafile/issues).
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue