Server setup and installation
Contents |
Preface
This guide explains how to install and run PowerFolder Server.
Server installation and setup
Requirements
- PowerFolder Server installation file.
- Server license key. Get a trial.
- Linux, Windows or Mac computer with Java Runtime Edition 6.0 (Update 11 or higher).
- 1 GB memory.
- Firewall, that allows inbound TCP connections on port 1337 and 8080.
- SMTP mail service.
- Fix DNS hostname, fix IP or at least a DynDNS.
Optional Settings
- Configure an external database (requires PowerFolder Server 2.0+).
- An encrypted drive or partition to store all user data. We recommend LUKS.
Windows
Jump to Linux/Mac installation
Preparation
Installation and setup
- Execute the installer EXE file and complete the installation.
- Open the web console at http://127.0.0.1:8080.
- Activate with your PowerFolder.com email account and password. (#Troubleshooting)
- Now the admin console opens.
- Click on "Preferences" and fill out all required fields. The admin account password should be changed. Click "Save".
- PowerFolder Server is now configured and running as service. You may now add new user accounts via the admin console.
Notes:
- On a clean installation the admin account on your server is admin/password.
- Change the windows user, which is running the service if it should access network drives in a domain. Change this under Services/PowerFolder/Log On
Stopping/Restarting
To stop the server use the Windows services control panel or execute the helper batch files in the program menu. Make sure to execute them as Administrator.
Linux / Mac
Preparation
- Download PowerFolder Server
- It is recommend to create a special user account, which runs PowerFolder Server. Running as root is highly discouraged.
- Create an installation directory, that hosts the PowerFolder jar file, debug logs and the configuration file. Recommendation "~/powerfolder". PowerFolder Server gets executed in this installation directory.
Installation
- Extract the server tar-gz-distribution file into the installation directory (e.g. "tar -xf PowerFolder-server-W.X.Y.Z.tar.gz").
- Start the server by executing "./PowerFolder.sh start".
- Open a browser and point it to http://localhost:8080/activation.
- Activate with your PowerFolder.com email account and password. (#Troubleshooting)
- Now the admin console opens.
- Click on "Preferences" and fill out all required fields. Click "Save".
- PowerFolder Server is now configured. You may now add new user accounts via the admin console.
Note: On a clean installation the admin account on your server is admin/password.
Starting/Stopping/Restarting
The script "PowerFolder.sh" offers various command line options like "start", "stop", "restart", "kill" and "status".
Debian init-script
Benedikt Wegmann from GWDG provided us with an init-script for Debian, which you can install with the following command:
update-rc.d PowerFolder defaults 98 02
It will start PowerFolder late in the boot process and will stop it early in the shutdown process.
Read more on optimization and automation under Linux
Adding user accounts
You may now start to create new user accounts. Open the admin console in your web browser and click "Accounts".
Admin user account reset
Stop PowerFolder Server. Edit the Server configuration file and add these lines to reset the admin username and password.
Troubleshooting
If the server does not seem to start, try to start it by hand with the following command line in the installation directory:
Windows: PowerFolder.bat
Linux: ./PowerFolder.sh console
Alternative: java -jar PowerFolder-server.jar -l INFO
Check the output for any warnings or severe problems.
Copy the console output and file a ticket with it's contents attached.
Example console output of a successful server start:
Check java
Check the installed java version with the command: java -version
You require an official Java Runtime Environment (Java2SE) at least version 1.6.0 from Sun Microsystems.
Check date and time
Make sure the computer running PowerFolder Server has the correct date / time. Otherwise it's not possible to log in.
