|This page was written by Pluto and imported with their permission when LinuxMCE branched off in February, 2007. In general any information should apply to LinuxMCE. However, this page should be edited to reflect changes to LinuxMCE and remove old references to Pluto.|
This bash scripts where created to configure / setup storage devices that can be used in pluto. Currently there are 2 device templates that can be configured by this scripts:
- Hard Drives / Generic Internal Driver (1790)
- Network Storage / HD-HG300LAN (1794)
This device templates have some common device data:
- PK_Users (3)
- A list of integer values separated by comma. The numbers represent the id of the users who can use the storage device for storing private files on them. If the 0 value is there too, the storage device can also be used to store public files. If no value is entered, the default is considered 0 (public only). If the next device data (use pluto dir structure) is not set to 1, all the files will be accessible from one directory on the storage device, meaning that public / private files can be accessible by every user that can access that device.
- Use Pluto Directory Structure (130)
- This value can be 1 or 0, meaning that the information on that devices will be stored using a pluto directory structure, identical to the one in /home directory. For every user there will be a separate directory to store it's private data and there will also be a /public directory in there. The default is set to 1 but if other/no value is entered will be considered 0.
- Use Automatically (134)
- A leftover ? Not used
- Directories (153)
- The media directories from the pluto directory structure that can be used on this device. Example by entering music, movies only the music and movies folders will be available from pluto. The value can be empty, meaning that all directories will be available.
Scripts used to do generic setup
- The /etc/auto.PlutoStorageDevices file is used by automounter to mount different storage device in the /mnt/device/device_id directories.
- Some devices can be attached to only one computer, for example the internal disc drive. This script generates a section in the /etc/exports file that can export the local mounts of this kind of devices over nfs. This way the local storage devices can be accessed by any computer over the network. After it updates the /etc/exports file it also triggers a nfs reload.
- The mounted storage devices will be accessible to the user via symlinks that are created in the /home directory by this script. Depending if the storage device uses a pluto directory structure or not the symlink will be pointing to the mount point directly or to the pluto media directors that where previously created in it. Also the symlinks will be created only in the directories listed on the Directories device data.
- StorageDevices_PlutoDirStructure.sh [-d <deviceID>]
- Creates a pluto directory structure on a mounted storage device. Called without -d parameter it creates the pluto dir structure only on the locally mounted devices, used with -d it creates the pluto structure on the specified device. If a device doesn't have the corresponding device data (130) set to true that the script skips it.
- StorageDevices_Setup.sh [--cascade]
- is the main script that calls the previous script so that it can setup the storage devices. Is intended to be used as a startup script. At startup is called by sysv-rc without the cascade parameter. If the --cascade parameter is supplied that the scripts runs on the local machine and triggers itself to run on the other working machines too.
Generic Internal Driver (1790)
This device can be associated with a spare partition that the user has on the drives located in one of the computers running pluto (Diskless MD, Core or Hybrid). The spare partition can be used to store data like movies, music or any other files that the user wants to be easily accessed by pluto.
This device is detected automatically by Pluto.
HD-HG300LAN (Buffalo NAS) (1794)
This device template is used for integrating Buffalo HD-HG300LAN Network Storage Device into Pluto. The Buffalo device is detected via the DHCP Plug'n'Play daemon once inserted into the internal network of the pluto core.
This device can be associated with a samba(windows) or nfs share that is located on a computer/storage device. To add this kind of device, the user needs to manually add it from the pluto-admin web interface.
For the samba share the user needs to know:
- The ip address which will need to added to the device IPaddress field
- The username that that can have acces to that samba share. If the user is left empty or is 'guest', an unathenticated mount will be tried.
- The password for the username (mandatory)
- The share name
He can also add the maximum file size that is supported by that share. For example on FAT32 partitions the maximum file size is limited to 4GB.
For the nfs shares the user needs to know:
- The ip address of the device/computer that has that share
- The name of the directory that is shared
After adding one of this devices the user should manually do a quick reload router.