Deploying clients to users/devices
Preparing clients for download
When is started for the first time, it will start to download the so-called Generic Clients to the client_deployment directory of the Server Maintenance Folder. The clients will then be available for download in the web interface to logged-off users on the log-in page and to logged-in users on the Download Clients tab.
After the client has been downloaded by the user from the web interface, it needs to be installed. After the installation, the client will ask for the server URL, username and password to connect to the server.
Updating clients to a new version
After the initial download of the clients to the client_deployment directory of the Server Maintenance Folder, the server will NOT automatically update the client if a new version is released by PowerFolder, except if the client installation packages are deleted and the service restarted. During runtime the clients in the client_deployment directory have to be updated manually whenever a new version should be deployed to the user's devices.
Please take care you download the Generic Client version when updating the clients on the PowerFolder Server. The clients connecting to our public cloud don't offer to enter the URL to your server!
Download links to the latest Generic Clients:
- Windows Installer (.exe)
- Windows Installer (.msi / 32-bit)
- Windows Installer (.msi / 64-bit)
- Mac Package (.dmg)
- Linux Package (.tar.gz)
- Linux Package (.deb / i386)
- Linux Package (.deb / amd64)
- Linux Package (.rpm / i386)
- Linux Package (.rpm / x86_64)
Earlier versions of the Generic Clients can be found here: http://download.powerfolder.com/pro/
Notifying clients about a new version
Once you've updated the clients in the client_deployment directory, they will be available for download on your web interface. However existing clients will not detect automatically that there is a new version yet. This can be useful if you want to start with a slow rollout making the updated clients only available for new users.
If you want to have all exisiting clients to detect the new version, you need to edit the
PowerFolderPro_LatestVersion.txt in the client_deployment directory and set the version number to the number of the updated clients.
Next time one of the existing clients start, it will compare the installed version to the version mentioned in the
PowerFolderPro_LatestVersion.txt and will offer the updated version to the user.
Deploying on Windows with the exe installer using silent mode
The Windows client installer supports some command line options to make it easier to deploy it with batch scripts or package deployment tools:
Silent uninstall can be performed by executing the
uninstall.exe in installation directory with the command line
Deploying on Windows using MSI
The MSI package is provided to support automated installation via command line, Active Directory or software deployment/packing solutions. As such, it does not feature a GUI, but can be customized using standard mechanisms like msiexec or transforms. Administrators can use Orca to inspect the MSI package, edit values and create transforms.
|PowerFolder||1||Main PowerFolder components, including the jar, binaries and entries in the start menu and desktop.|
The JRE distributed with PowerFolder.
|ShellExtensions||1||Integrate PowerFolder into Windows Explorer etc.|
|ServerConfig||1||Set server URL on installation. The public installer property CONFIG_URL must be set.|
|StartupEntry||1||Create an entry in the Windows Startup folder to automatically launch PowerFolder.|
|DesktopShortcut||1||Create a shortcut on the Desktop|
|Kerberos_Support||2000||Create registry entries for Kerberos Authentification.|
|WebDAV_Support||2000||Create registry entries to use the WebDAV client.|
By default, all features with a level of 1 will be installed. Windows Installer allows to override this behavior in the following ways:
- The INSTALLDIR property is used to customize the directory where the main files (PowerFolder.exe, jar etc.) will be placed.
- The LANG property determines the language of the installed shell extensions. For possible values see Language Identifier Constants and Strings. The default value is provided by GetSystemDefaultLanguageID.
- The INSTALLLEVEL property can be set manually. All features with a level lower than INSTALLLEVEL will be installed.
- The ADDLOCAL property allows to specify features to be installed by their name.
- The REMOVE property names features to be removed.
With the MSI installer the folder base path can be set during the interactive installation process. The installer proposes the folder base path already set in the registry. If no folder path was set the installer proposes the default path $HOME/PowerFolders.
It is also possible to set the parameter via command line parameter:
msiexec /i installer.msi FOLDERBASEPATH=C:\test
The installation can also be done completely silent (requires console with administrator privileges):
msiexec /i installer.msi /qn FOLDERBASEPATH=C:\test
During installation, the folder base path is written to the registry of the local user (foldersbase). A second key (foldersbase.overwrite) is also written to the registry and set to true. At the next start of the PowerFolder client the folder base path is read from the registry and the overwrite flag set to false. From this point on all changes to the folder base path are controlled by the client and automatically synced to the registry.
|msiexec /i PowerFolder_<VERSION_NUMBER>_Installer.msi|
Default: Install all features with a level equal to 1.
|msiexec /i PowerFolder_<VERSION_NUMBER>_Installer.msi INSTALLDIR=E:\PowerFolder||Default installation, but use folder E:\PowerFolder for program files.|
|msiexec /i PowerFolder_<VERSION_NUMBER>_Installer.msi CONFIG_URL=https://powerfolder.example.com||Default installation with a custom server, for on-premise servers.|
|msiexec /i PowerFolder_<VERSION_NUMBER>_Installer.msi ADDLOCAL=Kerberos_Support||Default installation plus Kerberos registry entries.|
|msiexec /i PowerFolder_<VERSION_NUMBER>_Installer.msi INSTALLLEVEL=32767||Install all features. 32767 is the greatest level allowed.|
|msiexec /i PowerFolder_<VERSION_NUMBER>_Installer.msi INSTALLLEVEL=0||Install nothing.|
|msiexec /i PowerFolder_<VERSION_NUMBER>_Installer.msi INSTALLLEVEL=0 ADDLOCAL=PowerFolder,ShellExtensions,ServerConfig, StartupEntry||Default install, minus the bundled JRE.|
|msiexec /i PowerFolder_<VERSION_NUMBER>_Installer.msi REMOVE=Bundled_JRE||Remove the bundled JRE from an existing installation.|