Another important component of pulse is its virtual file system (VFS), where all images, PDFs and other downloadable files are stored, so that they can be easily used via the administration’s point and click editors.
The file system has two root folders: public and private, which can be selected by the corresponding buttons in the toolbar. The public folder is where all files that shall be visible to all users of your website go, whereas files in the private folder will be accessible only to users currently logged in.
The file system browser works almost like the explorer in Microsoft Windows™. The folder tree structure is displayed on the left hand side of the popup window. You can navigate through the folders by using the 'expand' or 'collapse' buttons. Double-clicking a folder also opens it, as well as a file can be selected by a double-click.
Note: a file is selected only if its name appears in the field labelled ‘file’ at the bottom of the window and must be confirmed for use by clicking on the ‘select’ button.
So far there are two possible methods to upload files into the VFS. You can either use a WebDAV client or the built in WebDAV support of your operating system.
Note: in all cases you need the URL of your server. If you are testing pulse in a local
environment the url would be
for the public folder: localhost/pulse/WEBDAV/public/
and for the private folder: localhost/pulse/WEBDAV/private/
If your pulse distribution is installed on a web server, the URL needs to be adjusted accordingly, by replacing the term ‘localhost’ with the http:// address of your site. Also if you do have a ssl certificate installed on your server you have to use https:// instead of http://
Please note also that your application server (i.e. tomcat) requires write access permissions on the actual folders which are at the following location within your pulse installation directory
for the public folder: .../pulse/WEB-INF/vfs-private
and for the private folder: .../pulse/WEB-INF/vfs-public
Method one and the one we are recommending so far, is to use a so called WebDAV-client such as WebDrive from South River Technologies for Windows or cyberduck for MacOS as this is the most comfortable and failsafe way.
A trial version of the client can be obtained here:
Cyberduck is a free file transfer program that supports WebDAV. Before using Cyberduck, download and install the software from http://www.cyberduck.ch. The latest versions can be found in the top right corner of the page. Once installed, follow these steps:
BitKinex is a free file transfer software that supports WebDAV.
Before using BitKinex, download and install the software from http://www.bitkinex.com/download.
Once installed, please follow these steps:
Launch BitKinex. Afterwards right-click on the Http/WebDAV entry in the tree menu and select New -> Http/WebDAV (Fig. 4).
Enter the name for your new WebDAV location and confirm it by pressing enter. Enter the server’s URL (without http://) and your user information in the appearing popup (Fig. 5). Select the “Site Map” point from the pop-up’s tree menu. Enter the base-path of your virtual file system in the input field and select "Directory (WebDAV-compliant)" from the dropdown beneath (Fig. 6). When this is done, use the add button to save your VFS-path, confirm your settings by clicking the pop-up’s OK button and your all set up and ready.
Uploading files works via drag and drop.
Many of the file managers in the Linux system cut off the trailing '/', which is required to access pulse WebDAV folders. One solution is to use the command line program davfs2.
Here are the instructions for Ubuntu based systems:
$ sudo apt-get install davfs2
Use of this tool generally requires being a super user, but you can change that easily.
$ sudo dpkg-reconfigure davfs2
Now create two files in your home directory to mount the WebDAV-folders:
$ mkdir -p /home/user/mnt/pulse-private
$ mkdir -p /home/user/mnt/pulse-public
and add your user to the davfs2 group by editing
/etc/group. Go to go to
davfs2 and add your user name afterward -
Add two entries into
/etc/fstab, each one on a single line:
http://localhost/pulse/WEBDAV/public/ /home/user/mnt/pulse-public davfs rw,noauto,user
http://localhost/pulse/WEBDAV/private/ /home/user/mnt/pulse-private davfs rw,noauto,user 0 0
After that, logout and log back into your session.
To mount the WebDAV drive type this in your command line:
$ mount 'http://localhost/pulse/WEBDAV/private/'
$ mount 'http://localhost/pulse/WEBDAV/public/'
This will mount the pulse WebDAV folders on your system.
To unmount the folders use:
$ umount ~/mnt/pulse-public