[deploy_windows] small tweaks

jyelee · Jul 9, 2014 · 4e53fc1 · 4e53fc1
1 parent c866804
commit 4e53fc1
Show file tree

Hide file tree

Showing 5 changed files with 139 additions and 65 deletions.
diff --git a/SUMMARY.md b/SUMMARY.md
@@ -25,8 +25,10 @@
    * [Common Problems for Setting up Server](deploy/common_problems_for_setting_up_server.md)
    * [Upgrade Seafile server](deploy/upgrade.md)
 * [Deploy Seafile under Windows](deploy_windows/deploy_with_windows.md)
+   * [Download and Setup Seafile Windows Server](deploy_windows/download_and_setup_seafile_windows_server.md)
    * [Install Seafile Server as a Windows Service](deploy_windows/install_seafile_server_as_a_windows_service.md)
    * [Ports used by Seafile Windows Server](deploy_windows/ports_used_by_seafile_windows_server.md)
+   * [Upgrading Seafile Windows Server](deploy_windows/upgrading_seafile_windows_server.md)
 * [Deploy Seafile Pro Edition](deploy_pro/README.md)
    * [Download and Setup Seafile Professional Server](deploy_pro/download_and_setup_seafile_professional_server.md)
    * [Migrate from Seafile Community Server](deploy_pro/migrate_from_seafile_community_server.md)

diff --git a/deploy_windows/deploy_with_windows.md b/deploy_windows/deploy_with_windows.md
@@ -1,75 +1,36 @@
 # Deploy with Windows
 
-## Download/Uncompress
-###Install Python 2.7
+## Setup and Upgrade
 
-- Download and install [python 2.7](https://www.python.org/ftp/python/2.7.8/python-2.7.8.msi)
-- Add the installation path of python2.7 to the system PATH environment variable. If you installed python 2.7 to ``C:\Python27`` add ``C:\Python27`` to the PATH environment variable
+Seafile Windows Community Edition only support SQLite database now. The Seafie Windows business edition supports MySQL, WebDAV and file search.
 
-### Download/Uncompress Seafile Server
-
-- Get the latest version of Seafile Server program
-- Create a new folder to store seafile program, such as ``C:\SeafileProgram\``. Please remember the location of the folder, we'll use it later.
-- Uncompress ``seafile-server_1.7.0_win32.tar.gz`` to ``C:\SeafileProgram\``
-
-Now you have a folder like this:
-```sh
-C:\SeafileProgram
-         |__ seafile-server-1.7.0
-```
-##Start/Initialization
-
-###Start Seafile Server
-
-Go to the folder ``C:\SeafileProgram\seafile-server-1.7.0\``, and double click run.bat to start Seafile Server. You should notice a seafile icon appears in the system tray.
-Choose a disk to store Seafile Server data
-
-Now you'll be prompted a dialog to choose a disk to store the data of seafile server
-
-- Please choose a disk with enough free space
-- Once you clicked the OK button, Seafile would create a folder named seafile-server under the disk you choosed. That would be the data folder of Seafile Server. If you choose disk D, your data folder would be ``D:\seafile-server``
-
-###Add an admin account
-
-Right click the tray icon of Seafile Server, choose __Add an admin__. Input your admin username and password in the prompted dialog.
-
-If the operation is successful, the tray icon would show a bubble saying __Successully added the admin acount__
-###Configure Seafile Server
-
-After initialization, there are some options need to be configured:
-
-- Right click the tray icon, choose __Open seafile-server folder__. Your seafile-server data folder would be opened.
-- Edit the file ``ccnet/ccnet.conf``. Modify two lines of ``ccnet.conf``:
-```
-NAME = XXXXX
-SERVICE_URL = XXX
-```
-- Change the value of NAME to the name of your Seafile Server, such as NAME = my-company-seafile. This name would be displayed on your seafile clients
-- Change the value of ``SERVICE_URL`` to ``http://<your ip address>:8000``. Say the ip address of your windows server is 192.168.1.100, then change it to ``SERVICE_URL = http://192.168.1.100:8000``
-
-After the edit, right click tray icon, choose __Restart seafile__
-###Visit Seahub
+- [Download and Setup Seafile Windows Server](download_and_setup_seafile_windows_server.md)
+- [LDAP Integration](../deploy/using_ldap.md)
+- [Install Seafile Server as a Windows Service](install_seafile_server_as_a_windows_service.md)
+- [Ports used by Seafile Windows Server](ports_used_by_seafile_windows_server.md)
+- [Upgrading Seafile Windows Server](Upgrading Seafile Windows Server)
+- [Options & Customization](../deploy/server_configuration.md)
 
-Open your browser, and visit ``http://127.0.0.1:8000``. Login with the admin account. If you can login, the initialization is successful.
-Configuration done
+For more information on Seafile server, check [this](../deploy/README.md)
 
-Seafile Server configuration is finished. See Seafile Client Manual for how to use the client
+## Server Administration
 
+- [Garbage Collecting Unused Blocks on Seafile Server](../maintain/seafile_gc.md)
 
-##Common Issues
+## Common Issues
 
 If you failed to set up Seafile server, first check seafserv-applet.log.
-###"ERROR: D:/seafile-server\seahub.db not found"
+### "ERROR: D:/seafile-server\seahub.db not found"
 
 This file is created during Seafile initialization. Please:
 
 - Check whether your Python and the ``PATH`` for Python is correctly set.
 - Put Seafile server package in a simple path, like ``C:\seafile-packages``.
 
-###Failed to create seahub.db
+### Failed to create seahub.db
 
 Use python version 2.7.x, do not use python 3+.
-###Can not upload/download files in the Web interface
+### Can not upload/download files in the Web interface
 
 Make sure you have modified ``SERVICE_URL`` in ccnet.conf.
 The browser can't get the css and javascript files
@@ -78,8 +39,4 @@ The browser can't get the css and javascript files
 - Delete non-ASCII keys from the registry path ``HKEY_CLASSES_ROOT\MIME\Database\Content`` Type, and try again.
 
 
-###You may also want to read about:
 
-- [Install Seafile Server as a Windows Service](install_seafile_server_as_a_windows_service.md)
-- [LDAP Integration](using_ldap.md)
-- [Ports used by Seafile Windows Server](ports_used_by_seafile_windows_server.md)
diff --git a/deploy_windows/download_and_setup_seafile_windows_server.md b/deploy_windows/download_and_setup_seafile_windows_server.md
@@ -0,0 +1,64 @@
+# Download and Setup Seafile Windows Server
+
+## Download/Uncompress
+### Install Python 2.7
+
+- Download and install [python 2.7](https://www.python.org/ftp/python/2.7.8/python-2.7.8.msi)
+- Add the installation path of python2.7 to the system PATH environment variable. If you installed python 2.7 to ``C:\Python27`` add ``C:\Python27`` to the PATH environment variable
+
+### Download/Uncompress Seafile Server
+
+- Get the latest version of Seafile Server program
+- Create a new folder to store seafile program, such as ``C:\SeafileProgram\``. Please remember the location of the folder, we'll use it later.
+- Uncompress ``seafile-server_1.7.0_win32.tar.gz`` to ``C:\SeafileProgram\``
+
+Now you have a folder like this:
+```sh
+C:\SeafileProgram
+         |__ seafile-server-1.7.0
+```
+## Start/Initialization
+
+### Start Seafile Server
+
+Go to the folder ``C:\SeafileProgram\seafile-server-1.7.0\``, and double click run.bat to start Seafile Server. You should notice a seafile icon appears in the system tray.
+Choose a disk to store Seafile Server data
+
+Now you'll be prompted a dialog to choose a disk to store the data of seafile server
+
+- Please choose a disk with enough free space
+- Once you clicked the OK button, Seafile would create a folder named seafile-server under the disk you choosed. That would be the data folder of Seafile Server. If you choose disk D, your data folder would be ``D:\seafile-server``
+
+### Add an admin account
+
+Right click the tray icon of Seafile Server, choose __Add an admin__. Input your admin username and password in the prompted dialog.
+
+If the operation is successful, the tray icon would show a bubble saying __Successully added the admin acount__
+### Configure Seafile Server
+
+After initialization, there are some options need to be configured:
+
+- Right click the tray icon, choose __Open seafile-server folder__. Your seafile-server data folder would be opened.
+- Edit the file ``ccnet/ccnet.conf``. Modify two lines of ``ccnet.conf``:
+```
+NAME = XXXXX
+SERVICE_URL = XXX
+```
+- Change the value of NAME to the name of your Seafile Server, such as NAME = my-company-seafile. This name would be displayed on your seafile clients
+- Change the value of ``SERVICE_URL`` to ``http://<your ip address>:8000``. Say the ip address of your windows server is 192.168.1.100, then change it to ``SERVICE_URL = http://192.168.1.100:8000``
+
+After the edit, right click tray icon, choose __Restart seafile__
+### Visit Seahub
+
+Open your browser, and visit ``http://127.0.0.1:8000``. Login with the admin account. If you can login, the initialization is successful.
+Configuration done
+
+Seafile Server configuration is finished. See Seafile Client Manual for how to use the client
+
+### You may also want to read about:
+
+- [LDAP Integration](../deploy/using_ldap.md)
+- [Install Seafile Server as a Windows Service](install_seafile_server_as_a_windows_service.md)
+- [Ports used by Seafile Windows Server](ports_used_by_seafile_windows_server.md)
+- [Upgrading Seafile Windows Server](Upgrading Seafile Windows Server)
+- [Options & Customization](../deploy/server_configuration.md)
diff --git a/deploy_windows/ports_used_by_seafile_windows_server.md b/deploy_windows/ports_used_by_seafile_windows_server.md
@@ -1,23 +1,23 @@
 # Ports used by Seafile Windows Server
 
 Seafile server has several components, so several TCP ports are used.
-##The two configuration files
+## The two configuration files
 
 All ports related configuration are recorded in ``ccnet.conf`` and ``seafile.conf``.
-###How to open ``ccnet.conf``
+### How to open ``ccnet.conf``
 
 - Right click the seafile server trayicon, choose __Open seafile-server folder__
 - Open the folder ``ccnet`` under ``seafile-server`` folder. The file ``ccnet.conf`` is there.
 
-###How to open ``seafile.conf``
+### How to open ``seafile.conf``
 
 - Right click the seafile server trayicon, choose __Open seafile-server folder__
 - Open the folder ``seafile-data`` under ``seafile-server`` folder. The file ``seafile.conf`` is there.
 
 In the following section we list the TCP ports used by each of seafile components, as well as how to change them (For example, some port may have already been used by some other application).
 
 **Note**: If you change any of the ports, you have to restart seafile server.
-##ccnet
+## ccnet
 
 ccnet is the networking service for seafile server
 
@@ -28,7 +28,7 @@ ccnet is the networking service for seafile server
 [Network]
 PORT = 10001
 ```
-##seaf-server
+## seaf-server
 
 seaf-server provides the data service for seafile server
 
@@ -40,7 +40,7 @@ seaf-server provides the data service for seafile server
 [network]
 port=22001
 ```
-###seafile httpserver
+### seafile httpserver
 
 seafile httpserver handles raw file upload/download for Seahub
 
@@ -51,7 +51,7 @@ seafile httpserver handles raw file upload/download for Seahub
 [httpserver]
 port=8082
 ```
-###seahub
+### seahub
 
 seahub is the web interface of seafile server.
 

diff --git a/deploy_windows/upgrading_seafile_windows_server.md b/deploy_windows/upgrading_seafile_windows_server.md
@@ -0,0 +1,51 @@
+# Upgrading Seafile Windows Server
+
+- Minor Upgrade
+- Major Upgrade
+- Upgrade Windows Service
+
+**Note**：You must shutdown seafile server before you upgrade.
+## Uncompress the new version of Seafile Server
+
+Before you upgrade, assume you have:
+```
+C:/SeafileProgram
+             |______ seafile-server-1.7.0/
+```
+Then the first step is to download the new version of Seafile Server and uncompress it to ``C:/SeafileProgram``. After this you should have:
+```
+C:/SeafileProgram
+             |______ seafile-server-1.7.0/
+             |______ seafile-server-1.8.0/
+```
+## Minor upgrade (like upgrade from 1.7.0 to 1.7.1)
+
+Now assume you are upgrading from Seafile Windows Server 1.7.0 to 1.7.1
+### Move the contents of the avatars folder
+
+Go to the folder ``seafile-server-1.7.0/seahub/media/avatars``
+
+The ``avatars`` folder contains all the avatars uploaded by seafile users.
+
+If you have a user ``[email protected]``, then in this folder, you will find a subfolder ``[email protected]``. This subfolder contains the avatar pictures of the user ``[email protected]``.
+
+Copy all subfolders like ``[email protected]`` to ``seafile-server-1.7.1/seahub/media/avatars``. So that when you start the new seafile 1.7.1 server, these avatars can be load correctly.
+## Major upgrade (like upgrade from 1.7.0 to 1.8.0)
+
+Now assume you are upgrading from Seafile Windows Server 1.7.x to 1.8.y:
+### Run the database upgrade script
+
+- Go to seafile-server-1.8.y/upgrade
+- Right click the file upgrade_1.7_1.8.bat
+- Choose "run as administrator"
+
+### Copy avatars
+
+Copy all subfolders of ``seafile-server-1.7.0/seahub/media/avatars`` to ``seafile-server-1.8.0/seahub/media/avatars``
+## Upgrading Windows Service
+
+If you have installed Seafile server as a Windows Service, you need to:
+
+- Run the old version of seafile windows server, right click the tray icon, and choose uninstall windows service in the menu
+- Exit the old version of seafile windows server
+- Start the new version of seafile windows server, right click the tray icon, and choose install as windows service in the menu