FAQ

How to update the temporary folder used to restore data?

By default, rdiffweb is using the “/tmp” folder as a working directory to restore your data. This might cause some issues if you are trying to restore a huge folder and your /tmp is tiny. In this situation, you might get a similar error to :

Unable to restore! rdiff-backup output: Exception '[Errno 28] No space left
on device'

Version 0.6.5 (and before)
To fix this situation, you may change your temporary folder by redefining TEMP environment variable. You can do so by editing your init script.

Since 0.7.0
To fix this issue you may edit your configuration file /etc/rdiffweb/rdw.conf and change the “tempdir” configuration parameters. Make sure the new location exists and is readable and writable.

How to change/fixe encoding?

On linux the filenames don’t have any specific encodings. By default, if you’re creating files directly on the server, the application uses the default encoding of your system (usually stored in variable environment LANG). In most cases, the default encoding on Linux is UTF-8. This encoding is then used by rdiffweb to interpret the filenames. This works 99% of the time unless your files are created by an external system. I’m talking about Windows. If the files you want to backup are created by Windows, it’s probably because the filenames won’t use UTF-8 encoding. This situation might arise if:

  • you run rdiff-backup on Windows ;

  • you are using Samba2 without proper configuration.

Since version 0.7, rdiffweb is supporting this scenario, but you might end up with the wrong filename in the web interface. The following screenshots represent the problem. You may continue to use rdiffweb without any modifications. Browsing and restoring your data should not be affected by this visual problem.

Screen capture without proper configuration. Screen capture with proper encoding configuration.

To get the proper filename in the web interface, it’s possible to provide a hint to rdiffweb.

1. You need to know what is the encoding

If your data is generated by a Windows computer, you need to figure out which encoding is used by your Windows system. We are still searching for the best way to get this value without a third-party application. If you are using rdiffweb, the right encoding is probably in the following table. If not, let’s have a look at this link: complete code page table

  • window-1250 : ANSI Central European; Central European (Windows)

  • window-1251 : ANSI Cyrillic; Cyrillic (Windows)

  • window-1252 : ANSI Latin 1; Western European (Windows)

  • window-1253 : ANSI Greek; Greek (Windows)

  • window-1254 : ANSI Turkish; Turkish (Windows)

  • window-1255 : ANSI Hebrew; Hebrew (Windows)

  • window-1256 : ANSI Arabic; Arabic (Windows)

  • window-1257 : ANSI Baltic; Baltic (Windows)

  • window-1258 : ANSI/OEM Vietnamese; Vietnamese (Windows)

2. Tell rdiffweb about the right encoding

Go to your repository settings and change the selected encoding.

The result should be immediate. In your web browser, refresh the page and the new encoding should take effect.

Repository encoding

How to enable HTTPS / SSL

Multiple solutions are available to run rdiffweb with SSL. If you are really serious about security, it is highly recommended to run Rdiffweb behind an Apache server to enable SSL and other security features. Otherwise, you may simply enable SSL as follow.

Add the following lines to your /etc/rdiffweb.rdw.conf:

ssl-certificate=/path/to/certificate.file
ssl-private-key=/path/to/key.file