Linux-hda commands

From Amahi Wiki
Jump to: navigation, search

Linux Basic Commands

Linux Basic Commands most users will need.

General Linux/HDA Commands

Fedora

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


  • Ubuntu
Command Action
service apache2 start restart web server
apt-get -y upgrade automatically update Ubuntu


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
hda-alias SYSTEM USE ONLY
hda-fix-sudoers SYSTEM USE ONLY
hda-install deprecated - use amahi-installer
hda-install-file SYSTEM USE ONLY
hda-register-apps SYSTEM USE ONLY
hda-settings Dumps current settings
hda-update-webapps SYSTEM USE ONLY
hda-add-apache-sudoers SYSTEM USE ONLY
hda-diskmount Used to mount disk drives
hda-gems-install SYSTEM USE ONLY

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

Miscellaneous

Command Action
e2fsck -c /dev/sdb1 Check hard drive sdb1 for errors
​nscd -i hosts Clear DNS cache on HDA


Greyhole (0.9.2)

NOTE: This is the official version installed by default in Amahi 6, Fedora 14.

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 devices.
 -s, --stats           Display storage pool statistics.
 -S, --status          Display what the Greyhole daemon is currently doing.
 -q, --view-queue      Display the current work queue.
 -a, --empty-attic     Empty the attic.
 -b, --debug=filename  Debug past file operations.
 -p, --prerotate       Pre-rotate task (for logrotate).
 -P, --postrotate      Post-rotate task (for logrotate).
 -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.

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-graveyard
                       Speed up fsck by skipping the scan of the graveyard
                       directories. Scanning the graveyards 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, a share directory
                       on a storage pool volume, or a sub-directory of
                       of a share on a storage pool volume.
 -o, --find-orphaned-files
                       Scan for orphaned files in the storage pool volumes
                       while running the fsck and create tombstones for
                       the found files.

Greyhole (0.9.22)

NOTE: Upgrade to the latest version is not automatic and must be performed manually. See Updating Greyhole for guidance.

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.