en:manuals:freediams:install_usb
Keywords: en:freediams,en:usermanual,updated
Date: 2010-11-08T12:16:28+0100

freediams, usermanual, updated

# Installation multi-OS sur clé USB

This page is up-to-date.

# USB key, multi-platform installation

## Prerequired

The USB Key feature is only available with FreeDiams >= 0.5.0.

Of course, you need to download all OS version needed of FreeDiams. Let's assume that you need all the OS version running from a unique USB Key with shared datas. There are two ways to store your personnal datas with FreeDiams : SQLite local files or MySQL external database.

You should format the key in FAT32 format. This format is recognized by all the OS.

Create a directory tree like:

- FreeDiamsAllConfigs
  - Linux
  - MacOs
  - Win32
  - SharedResources
  - FreeDiamsDownloads

## Downloads

You will need the different downloads :

- FreeDiams for Win32 : zip format. Store the zip file on the USB Key.
- FreeDiams for MacOS : DMG format. Store the dmg file on the USB Key.
- FreeDiams for Linux (zipped binary package) : do not download the .deb file or the .rpm. Store

the file on th USB Key.

Unzip and copy packages to the OS representative path. Copy the MacOS FreeDiams application to its USB Key folder.

## Create and install the USB Key configuration file

The USB Key configuration file does only contains the path to config.ini to use (and the resources path). It must stand just next the FreeDiams executable whatever is the OS.

Create for each packages a file called pathtoconfig.ini and write inside the path to the shared \e config.ini. Use relative path.

- For Linux: executable lies in FreeDiamsAllConfigs/Linux/ . Content of the pathtoconfig.ini file:

    ../SharedResources/config.ini

- For MacOs: executable lies in FreeDiamsAllConfigs/MacOs/FreeDiams.app/Contents/MacOs . Content of the pathtoconfig.ini file:

    ../../../../../SharedResources/config.ini

- For Windows: executable lies in FreeDiamsAllConfigs/Win32 . Content of the pathtoconfig.ini file:

    ../SharedResources/config.ini

## Run on the USB Key

Know that's really easy:

- FreeDiams should never be called with the command line \e –config param.
- Just run FreeDiams depending on the OS
- Have multi-OS fun !

## Making the USB Key automatically starts FreeDiams when inserted

Linux, MacOS and Windows offers to the user the possibility to automatically start a command when a USB Key is inserted and recognize by the OS.