The location of data and settings depends on the operating system. Fanurio does this to integrate smoothly with each platform it runs on. As a rule, it stores them somewhere in the user's home folder. Knowing the location can be helpful if you want to backup the settings and data by hand.
By data and settings we mean:
-
repository folder: This is the folder where Fanurio keeps the database and templates. To change the location of the repository folder, use .
-
data subfolder: This folder contains the user entered data like clients, projects and invoices.
-
audit file: This file is used by Fanurio to log database actions so that data can be recovered if something goes wrong with the database or the backup copies. Fanurio keeps at most three audit files. The size of an audit file is no larger than 2 MB.
-
-
templates subfolder: This folder contains subfolders with user-defined templates. You can open these folders by using commands from .
Fanurio also has some default templates.
-
-
backup folder: This folder contains backups made by Fanurio. You can open it from . To change the location of the backup folder, use .
-
settings file: This file keeps application specific settings like the position and size of the Fanurio window.
-
log file: This file is used by Fanurio to log messages and errors related to its execution. Fanurio keeps at most two log files, depending on the volume of errors and warnings. The size of a log file is no larger than 2 MB.
-
certificates file: This file stores the SSL certificates trusted by the user. Fanurio prompts users to save invalid certificates (self-signed, untrusted, expired, etc) when connecting to a secure server.
-
user translations folder: The folder where users can add their (unofficial) translations of the application.
Table 5.3. Location of user data on Windows (XP, 2000)
| Item | Location |
|---|---|
| Log | C:\Documents and Settings\USER_NAME\Application Data\Fanurio\fanurio.log |
| Settings | C:\Documents and Settings\USER_NAME\Application Data\Fanurio\fanurio.properties |
| Certificates | C:\Documents and Settings\USER_NAME\Application Data\Fanurio\certs |
| Default repository folder | C:\Documents and Settings\USER_NAME\Application Data\Fanurio\ |
| Default backup folder | C:\Documents and Settings\USER_NAME\Application Data\Fanurio\backup |
| Default templates folder | C:\Program Files\Fanurio\share\templates |
| User translations folder | C:\Documents and Settings\USER_NAME\Application Data\Fanurio\i18n |
Table 5.4. Location of user data on Windows (Vista, 7)
| Item | Location |
|---|---|
| Log | C:\Users\USER_NAME\AppData\Roaming\Fanurio\fanurio.log |
| Settings | C:\Users\USER_NAME\AppData\Roaming\Fanurio\fanurio.properties |
| Certificates | C:\Users\USER_NAME\AppData\Roaming\Fanurio\certs |
| Default repository folder | C:\Users\USER_NAME\AppData\Roaming\Fanurio\ |
| Default backup folder | C:\Users\USER_NAME\AppData\Roaming\Fanurio\backup |
| Default templates folder | C:\Program Files\Fanurio\share\templates |
| User translations folder | C:\Users\USER_NAME\AppData\Roaming\Fanurio\i18n |
Table 5.5. Location of user data on Mac OS X
| Item | Location |
|---|---|
| Log | ~/Library/Logs/Fanurio/fanurio.log |
| Settings | ~/Library/Preferences/Fanurio/fanurio.properties |
| Certificates | ~/Library/Preferences/Fanurio/certs |
| Default repository folder | ~/Library/Application Support/Fanurio/ |
| Default backup folder | ~/Library/Application Support/Fanurio/backup |
| Default templates folder | /Applications/Fanurio.app/Contents/Resources/Java/share/templates |
| User translations folder | ~/Library/Application Support/Fanurio/i18n |
Table 5.6. Location of user data on Linux
| Item | Location |
|---|---|
| Log | ~/.fanurio/fanurio.log |
| Settings | ~/.fanurio/fanurio.properties |
| Certificates | ~/.fanurio/certs |
| Default repository folder | ~/.fanurio/ |
| Default backup folder | ~/.fanurio/backup |
| Default templates folder |
./share/templates /usr/share/fanurio/share/templates |
| User translations folder | ~/.fanurio/i18n |
A repository is a folder on your hard-disk where Fanurio stores data and files. A repository folder contains:
-
a data subfolder for its database where the actual data (clients, projects, etc) is saved and
-
a templates subfolder where user-defined templates may be installed.
A repository is created when Fanurio is set up for the first time but other repositories may be created from especially if you need to manage multiple repositories.
Besides creating a new repository, you can also:
-
Open a different repository: Go to to select the new repository.
-
Move the current repository: Go to to select the new location and check the "Copy files to the new folder" box. Fanurio will copy the current repository to the new location and then open it.
Fanurio can manage only one repository at a time. The current repository is opened automatically when you start the application.
We know data is a very important asset. That's why Fanurio creates backup copies every six hours (1:00, 7:00, 13:00, 19:00) when it is running and another copy when it is started. A backup copy is also created when a new version is installed. Fanurio keeps at most 25 backup copies.
An additional security measure is the audit file that contains the latest database operations. The audit file can be at most 6MB in size and that should be enough to record the data entered during the last week. The audit file can be used to recover data just in case there is no backup copy and the database is corrupted. We don't imagine how both these things could happen and that's why this is an additional measure.
For experts: Just in case you want to change the number of backup copies or the time when Fanurio saves the backup copies, you need to change the following settings manually. This example shows how to create a new backup copy every 5 minutes and keep 20 backup copies. When specifying new autosave patterns, make sure you test them first.
backup.autosave.running.pattern=0 0/5 * * * ? backup.copies.number=20
You can manage backups using the following commands:
-
Go to to create a backup.
-
Go to to restore an existing backup.
-
Go to to open the backup folder. You can then delete or copy older backups.
-
Go to to change the location of the backup folder. When you change the location of the backup folder, old backup copies are copied to the new location.
Besides being useful in case something wrong happens with your data, backup copies can also be used to transfer data between two computers. Whether you want to replace your desktop PC with a laptop or you decide to switch from Windows to Mac OS X or Linux, you can transfer your data from the old computer to the new computer using backup copies. Here's what you need to do:
Old Computer
-
Start Fanurio on your old computer
-
Go to and name the backup migration
-
Go to to open the backups folder
-
Copy the file called migration.fro to your new computer
New Computer
-
Start Fanurio on your new computer
-
Go to to open the backups folder on the new computer
-
Copy the migration.fro file to the backups folder on the new computer
-
Go to and choose migration from the list of backups
Once you complete these steps, the data from the old computer will be available on the new computer.
If you need to use Fanurio on multiple computers just for yourself, it's very likely you will want to keep your data synchronized. For instance, you may use Fanurio on a desktop PC in your office and on a laptop when you're travelling.
As a single user, you have two options for synchronizing your data, you can either use the server version and let Fanurio synchronize it for you can use the standalone version and let a file-synchronization service like Dropbox do it.
We recommend using the server version because:
-
you don't risk losing data as it may happen if you decide to use a file-synchronization service,
-
you don't have to worry that your local data is not up-to-date before starting Fanurio,
-
you don't have to install Dropbox if you don't need it and
-
you can run Fanurio on multiple computers at the same time.
This section explains how a file-synchronization service like Dropbox synchronizes data across multiple computers and why we're not recommending it for Fanurio.
If Fanurio stores its files in Dropbox then a copy of your database will be available on all computers where Dropbox is installed and running. To keep the data synchronized across all computers, Dropbox detects when a file changes and updates it on all the other computers. It does this by replacing the existing file with the new file.
For instance, if you add time in Fanurio on one computer, Dropbox detects that some database files have changed and uploads them in the cloud. Then the other computers running Dropbox get the new files and save them locally, replacing existing files.
That's why BEFORE running Fanurio on a new computer, you need to make sure that:
-
Fanurio is closed on the current computer (File / Exit, Fanurio / Quit, File / Quit) and
-
Dropbox is running on the current computer so that all the changes are uploaded in the cloud and that
-
Dropbox is running on the new computer so that its Dropbox folder is up-to-date.
If you don't do this, you will be working on an old copy of your data on the new computer and your changes from the current computer will be lost. This also means you can't run Fanurio at the same time on multiple computers because each instance will overwrite the database files of the other instance.
Although we don't recommend this solution it doesn't mean you can't use it. You need to be careful to follow the instructions listed below if you don't want to lose some of your data.
If you haven't used Fanurio before, you need to set up the server version. If you're already using the standalone version, you need to upgrade to the server version.
Before using the server version, you may want to read about how Fanurio synchronizes data across multiple computers.
IMPORTANT: Before reading this section make sure you read about how a file-synchronization service works and why we're not recommending it.
Here's how you can configure Fanurio to run on two computers. We're assuming you will be using Dropbox but the steps are the same for other services (Google Drive, Microsoft OneDrive).
-
Preparing Dropbox
-
Make sure Dropbox is installed on all computers where you want to use Fanurio.
-
In your Dropbox folder, create a folder called Fanurio with two subfolders: repository and backup.
-
-
Configuring Fanurio on the first computer
-
Start Fanurio
-
Change the repository folder from to point to the Dropbox repository folder created at step 1.b. Make sure you check the "Copy files to the new folder" box to copy existing files to the new location.
-
Change the backup folder from to point to the Dropbox backup folder created at step 1.b. Make sure you check the "Copy files to the new folder" box to copy existing files to the new location.
-
Close Fanurio on your first computer as indicated below, don't close it by clicking the window close button (X).
-
Use to close the application on Windows
-
Use to close the application on Mac
-
Use to close the application on Linux
-
-
-
Configuring Fanurio on the second computer
-
Make sure Dropbox has finished syncing its data so that the repository from the first computer is copied on the second computer.
-
Start Fanurio
-
Repeat steps 2.b and 2.c without checking the "Copy files to the new folder" box. There are already some files in there so you don't need to copy them again from the second computer. Now both computers will keep their data in the Dropbox folder.
-
-
Running Fanurio on either computer (important!)
-
Make sure Fanurio is not running on the other computer. If it is, close it (see step 2.d.).
-
Make sure Dropbox has finished syncing its data on both computers so that the local repository is up to date.
If you don't do this, you will be working on an older version that will conflict with the copy saved in Dropbox. Dropbox can't handle conflicts and you will lose some of your data.
-
Start Fanurio
-
If you notice something unusual about Fanurio, you can always send us the log file. You can either locate it on disk or use the Export Log button from the About dialog.
When you export the log from the About dialog, Fanurio creates a file called fanurio.log.zip at a location you specify. It's recommended that you export it to Desktop so that you can locate it easier.
Warning: Changing settings manually should be done with care and only if it's absolutely necessary. In some situations (very very rare, maybe never), it's the only way Fanurio can be configured.
The settings are different from the actual data (like clients or projects) that users enter in the application. Settings refer to anything Fanurio must remember between successive runs like the position of the application window or the output folder for exported invoices, just to name a few.
Some settings can be changed from the application but others can only be changed by editing the settings file. By doing this, we keep the user interface simple to use and learn with only a few options.
Follow these steps to edit the settings file manually:
-
Make sure Fanurio is not running
-
Use to close the application on Windows
-
Use to close the application on Mac
-
Use to close the application on Linux
-
-
Find the file fanurio.properties in:
-
C:\Documents and Settings\USER_NAME\Application Data\Fanurio\ on Windows
-
C:\Users\USER_NAME\AppData\Roaming\Fanurio\ on Vista
-
~/Library/Preferences/Fanurio/ on Mac OS X
-
~/.fanurio on Linux
-
-
Open it with a text editor
-
Add, edit or remove the lines that contain the settings that you want to edit
-
Save the file and close the editor
-
Restart Fanurio
Example 5.1. Mini-timer size and coordinates
Fanurio uses the ui.window.mini.bounds setting to remember the size and location of the iTunes-like mini timer. If you want to reset this setting, you have to follow the above steps and delete the line that starts with ui.window.mini.bounds.
Fanurio keeps all translations in an archive called fanurio-i18n.zip.
You need this even if you create a brand new translation. The file fanurio_i18n.properties is the main file that contains the English translation of the application. The others contain translations of other languages and have a suffix of the form _ll_CC where ll is the language code and CC is the country code.
For instance, fanurio_i18n_fr_CA.properties represents the French translation for Canada while fanurio_i18n_en_CA.properties represents the English translation for Canada.
-
Download fanurio-i18n.zip
-
Extract the contents of the .zip archive somewhere on your computer (e.g. Desktop)
-
Download PRBEditor and start it from your computer
PRBEditor is an application that can help you translate Fanurio easier. Just in case you are wondering what PRB stands for, it means Property Resource Bundle and is a technical term that Java uses when dealing with *.properties files like the ones found in fanurio-i18n.zip.
A *.properties file can also be edited using a plain text editor but it's a lot more work.
-
Once PRBEditor starts, select Open resource file from the Welcome Form
-
Locate fanurio_i18n.properties in the folder created at step 2
-
Check the languages that you want to see in the Select Locales to Open dialog.
If you want to translate to a language that's not displayed there, don't select anything.
-
Select Locale > New Locale from the menu to add a new language.
You don't have to do this if the language you want to translate to already exists. When adding a new locale, make sure you select one that includes both the language and the country, Greek (Greece) for instance and not just Greek.
-
Click on a cell from your language column and type the translation to translate a key.
-
When you're done, go to File > Save. It will save the language file in the folder created at step 2.
While using PRBEditor, you can press F4 to display the Statistics Form. It shows how many keys are translated.
If you choose to share your translation with other users, please send it to us so that we can make it public.
Follow these steps to install a language file or to test a translation file that you created:
-
Locate the user translations folder:
-
C:\Users\USER_NAME\AppData\Roaming\Fanurio\i18n on Windows Vista or Windows 7
-
C:\Documents and Settings\USER_NAME\Application Data\Fanurio\i18n on Windows
-
~/.fanurio/i18n on Linux
-
~/Library/Application Support/Fanurio/i18n on Mac OS X
-
-
Copy the language file to the translations folder. It can be the language file created above or any other language file from fanurio-i18n.zip.
-
Start Fanurio
-
Go to the Options/Preferences dialog
-
Go to the Locale section
-
Change the language and press Done
-
Restart Fanurio
Fanurio encrypts passwords using your computer's id so that they cannot be decrypted anywhere else. In other words, if someone (our support team, for instance) has access to the configuration file where one or more of your passwords are saved, they will not be able to decrypt them on other computers unless they know your computer's id.
Fanurio decrypts the password and uses it only when it needs to send an email, for instance when emailing invoices. If Fanurio fails to decrypt the password, it will ask you to reenter it. This is not supposed to happen but if it does, you should contact us.
Fanurio uses the MAC address to determine your computer's id.
|
Copyright © 2006-2017 Fanurio Time Tracking SRL |