Linux-hda commands
From Amahi Wiki
Contents
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.
