Difference between revisions of "Linux-hda commands"

From Amahi Wiki
Jump to: navigation, search
(Updated for greyhole-0.9.22)
Line 122: Line 122:
 
= Greyhole =
 
= Greyhole =
 
Use just "greyhole" in a Terminal to get the list, since those could change in the future. Currently, they are:
 
Use just "greyhole" in a Terminal to get the list, since those could change in the future. Currently, they are:
  Usage: greyhole [ACTION] [OPTIONS]
+
Usage: greyhole [ACTION] [OPTIONS]
 
+
 
  Where ACTION is one of:
+
Where ACTION is one of:
    -?, --help            Display this help and exit.
+
  -?, --help            Display this help and exit.
    -D, --daemon          Start the daemon.
+
  -D, --daemon          Start the daemon.
    -f, --fsck            Schedule a fsck.
+
  -f, --fsck            Schedule a fsck.
     -l, --balance        Balance available space on storage pool devices.
+
  -C, --cancel-fsck     Cancel all scheduled fsck.
    -s, --stats          Display storage pool statistics.
+
  -l, --balance        Balance available space on storage pool drives.
    -S, --status          Display what the Greyhole daemon is currently doing.
+
  -s, --stats          Display storage pool statistics.
    -q, --view-queue      Display the current work queue.
+
  -i, --iostat          I/O statistices for your storage pool drives.
    -a, --empty-attic     Empty the attic.
+
  -L, --logs            Display new greyhole.log entries as they are logged.
    -b, --debug=filename  Debug past file operations.
+
  -S, --status          Display what the Greyhole daemon is currently doing.
    -p, --prerotate      Pre-rotate task (for logrotate).
+
  -q, --view-queue      Display the current work queue.
    -P, --postrotate      Post-rotate task (for logrotate).
+
  -a, --empty-trash     Empty the trash.
    -t, --thaw[=path]    Thaw a frozen directory. Greyhole will start working on
+
  -b, --debug=filename  Debug past file operations.
                          files inside <path>. If you don't supply an option, the list
+
  -t, --thaw[=path]    Thaw a frozen directory. Greyhole will start working on
                          of frozen directories will be displayed.
+
                        files inside <path>. If you don't supply an option, the list
    -w, --wait-for[=path] Tell Greyhole that the missing drive at <path> will return
+
                        of frozen directories will be displayed.
                          soon, and that it shouldn't re-create additional file copies
+
  -w, --wait-for[=path] Tell Greyhole that the missing drive at <path> will return
                          to replace it. If you don't supply an option, the available
+
                        soon, and that it shouldn't re-create additional file copies
                          options (paths) will be displayed.
+
                        to replace it. If you don't supply an option, the available
    -g, --gone[=path]    Tell Greyhole that the missing drive at <path> is gone for
+
                        options (paths) will be displayed.
                          good. Greyhole will start replacing the missing file copies
+
  -g, --gone[=path]    Tell Greyhole that the missing drive at <path> is gone for
                          instantly. If you don't supply an option, the available
+
                        good. Greyhole will start replacing the missing file copies
                          options (paths) will be displayed.
+
                        instantly. If you don't supply an option, the available
    -n, --going[=path]    Tell Greyhole that you want to remove a drive. Greyhole will
+
                        options (paths) will be displayed.
                          then make sure you don't loose any files, and that the
+
  -n, --going[=path]    Tell Greyhole that you want to remove a drive. Greyhole will
                          correct number of file copies are created to replace the
+
                        then make sure you don't loose any files, and that the
                          missing drive. If you don't supply an option, the available
+
                        correct number of file copies are created to replace the
                          options (paths) will be displayed.
+
                        missing drive. If you don't supply an option, the available
    
+
                        options (paths) will be displayed.
   For --fsck, the available OPTIONS are:
+
   -r, --replace[=path]  Tell Greyhole that you replaced the drive at <path>.
    -e, --email-report    Send an email when fsck completes, to report on what was
+
  -X, --fix-symlinks    Try to find a good file copy to point to for all broken
                          checked, and any error that was found.
+
                        symlinks found on your shares.
    -y, --dont-walk-graveyard
+
   -p, --delete-metadata<=path>
                          Speed up fsck by skipping the scan of the graveyard
+
                        Delete all metadata files for <path>, which should be a
                          directories. Scanning the graveyards is only required to
+
                        share name, followed by the path to a file that is gone
                          re-create symbolic links that might be missing from your
+
                        from your storage pool.
                          shared directories.
+
  -U, --remove-share<=share_name>
    -c, --if-conf-changed Only fsck if greyhole.conf changed since the last fsck.
+
                        Move the files currently inside the specified share from the
                          Used in the daily cron to prevent unneccesary fsck runs.
+
                        storage pool into the shared folder (landing zone),
    -d, --dir=path        Only scan a specific directory, and all sub-directories.
+
                        effectively removing the share from Greyhole's storage pool.
                          The specified directory should be a Samba share, or a
+
 
                          sub-directory of a Samba share.
+
For --stats and --view-queue, the available OPTIONS are:
 +
  -j, --json            Output the result as JSON, instead of human-readable text.
 +
 
 +
For --fsck, the available OPTIONS are:
 +
  -e, --email-report    Send an email when fsck completes, to report on what was
 +
                        checked, and any error that was found.
 +
  -y, --dont-walk-metadata-store
 +
                        Speed up fsck by skipping the scan of the metadata store
 +
                        directories. Scanning the metadata stores is only required to
 +
                        re-create symbolic links that might be missing from your
 +
                        shared directories.
 +
  -c, --if-conf-changed Only fsck if greyhole.conf or smb.conf paths changed since
 +
                        the last fsck.
 +
                        Used in the daily cron to prevent unneccesary fsck runs.
 +
  -d, --dir=path        Only scan a specific directory, and all sub-directories.
 +
                        The specified directory should be a Samba share, a
 +
                        sub-directory of a Samba share, or any directory on a
 +
                        storage pool drive.
 +
  -o, --find-orphaned-files
 +
                        Scan for files with no metadata in the storage pool drives.
 +
                        This will allow you to include existing files on a drive
 +
                        in your storage pool without having to copy them manually.
 +
  -k, --checksums      Read ALL files in your storage pool, and check that
 +
                        file copies are identical. This will identify any problem
 +
                        you might have with your file-systems.
 +
                        NOTE: this can take a LONG time to complete, since it will read
 +
                        everything from all your drives!
 +
  -m, --delete-orphaned-metadata
 +
                        When fsck find metadata files with no file copies, delete those
 +
                        metadata files. If the file copies re-appear later, you'll need
 +
                        to run fsck with --find-orphaned-files to have them reappear in
 +
                        your shares.

Revision as of 00:35, 20 April 2012

Linux Basic Commands

Linux Basic Commands most users will need.

General Linux/HDA Commands

Command Action
service httpd start restart web server
yum -y update automatically update fedora
rpm -Uvh http://dl.getdropbox.com/u/364883/Amahi/hda-platform-*.*-*.noarch.rpm updates HDA
rpm -q hda-platform check to see what version of HDA you're running


HDA Script Commands

Command Action
first-admin returns name of first admin user
reset-user-password reset a forgotten user password

NOTE: Must be run from the /var/hda/platform/html/script directory.


Command Action
hda-change-gw change gateway/router IP address
hda-change-dns change DNS provider for HDA
hda-install-gem install a specific Ruby Gem
hda-create-db-and-user create MySql user and database
hda-new-install manual install for Amahi
hda-php-zone-change change time zone
hda-refresh-shares refresh HDA shares

NOTE: Can be run from anywhere (located in /usr/bin).

Miscellaneous

Command Action
service amahi-ushare restart restart ushare after adding new content
vncserver Starts the VNCServer
vncserver -kill :1 Stops the VNCServer
/etc/init.d/mt-daapd start Starts mt-daapd
/etc/init.d/mt-daapd stop Stops mt-daapd
e2fsck -c /dev/sdb1 Check hard drive sdb1 for errors
​nscd -i hosts Clear DNS cache on HDA


Greyhole

Use just "greyhole" in a Terminal to get the list, since those could change in the future. Currently, they are: Usage: greyhole [ACTION] [OPTIONS]

Where ACTION is one of:

 -?, --help            Display this help and exit.
 -D, --daemon          Start the daemon.
 -f, --fsck            Schedule a fsck.
 -C, --cancel-fsck     Cancel all scheduled fsck.
 -l, --balance         Balance available space on storage pool drives.
 -s, --stats           Display storage pool statistics.
 -i, --iostat          I/O statistices for your storage pool drives.
 -L, --logs            Display new greyhole.log entries as they are logged.
 -S, --status          Display what the Greyhole daemon is currently doing.
 -q, --view-queue      Display the current work queue.
 -a, --empty-trash     Empty the trash.
 -b, --debug=filename  Debug past file operations.
 -t, --thaw[=path]     Thaw a frozen directory. Greyhole will start working on
                       files inside <path>. If you don't supply an option, the list
                       of frozen directories will be displayed.
 -w, --wait-for[=path] Tell Greyhole that the missing drive at <path> will return
                       soon, and that it shouldn't re-create additional file copies
                       to replace it. If you don't supply an option, the available
                       options (paths) will be displayed.
 -g, --gone[=path]     Tell Greyhole that the missing drive at <path> is gone for
                       good. Greyhole will start replacing the missing file copies
                       instantly. If you don't supply an option, the available
                       options (paths) will be displayed.
 -n, --going[=path]    Tell Greyhole that you want to remove a drive. Greyhole will
                       then make sure you don't loose any files, and that the
                       correct number of file copies are created to replace the
                       missing drive. If you don't supply an option, the available
                       options (paths) will be displayed.
 -r, --replace[=path]  Tell Greyhole that you replaced the drive at <path>.
 -X, --fix-symlinks    Try to find a good file copy to point to for all broken
                       symlinks found on your shares.
 -p, --delete-metadata<=path>
                       Delete all metadata files for <path>, which should be a
                       share name, followed by the path to a file that is gone
                       from your storage pool.
 -U, --remove-share<=share_name>
                       Move the files currently inside the specified share from the
                       storage pool into the shared folder (landing zone),
                       effectively removing the share from Greyhole's storage pool.

For --stats and --view-queue, the available OPTIONS are:

 -j, --json            Output the result as JSON, instead of human-readable text.

For --fsck, the available OPTIONS are:

 -e, --email-report    Send an email when fsck completes, to report on what was
                       checked, and any error that was found.
 -y, --dont-walk-metadata-store
                       Speed up fsck by skipping the scan of the metadata store
                       directories. Scanning the metadata stores is only required to
                       re-create symbolic links that might be missing from your
                       shared directories.
 -c, --if-conf-changed Only fsck if greyhole.conf or smb.conf paths changed since
                       the last fsck.
                       Used in the daily cron to prevent unneccesary fsck runs.
 -d, --dir=path        Only scan a specific directory, and all sub-directories.
                       The specified directory should be a Samba share, a
                       sub-directory of a Samba share, or any directory on a
                       storage pool drive.
 -o, --find-orphaned-files
                       Scan for files with no metadata in the storage pool drives.
                       This will allow you to include existing files on a drive
                       in your storage pool without having to copy them manually.
 -k, --checksums       Read ALL files in your storage pool, and check that
                       file copies are identical. This will identify any problem
                       you might have with your file-systems.
                       NOTE: this can take a LONG time to complete, since it will read
                       everything from all your drives!
 -m, --delete-orphaned-metadata
                       When fsck find metadata files with no file copies, delete those
                       metadata files. If the file copies re-appear later, you'll need
                       to run fsck with --find-orphaned-files to have them reappear in
                       your shares.