Amahi Wiki - User contributions [en]

Adding a second hard drive to your HDA

2011-02-22T01:27:28Z

Cale250: added to specifically mention mac and gpt for guid drives

More hard drives can be added in your Amahi HDA for additional storage space.

We'll detail how to add such hard drives, and how to put them to good use.

=Important Notes=

* This is an how-to on how to add additional drives to your HDA.
* Amahi cannot be held responsible for any data breakage or destruction arising from the use or misuse of this script. We provide it as a service in good will. You accept this automatically if you use the script.
* This page and script does not support GUID-partitioned drives (such as drives previously in a Mac or have GPT partition tables). You can find what your partition is like with <code>fdisk -l</code>

=Make sure your drive is detected by Fedora=

Open a Terminal, and type the following command:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; background-color: #E6F2FF; margin: 0 1em;">
ls -1 /dev/disk/by-id/ | egrep -v "part|scsi"
</div>

Look for the line that matches the hard drive you added.

IDE and SATA hard drives will start with '''ata-''' and USB hard drives will start with '''usb-'''.<br/>
Look for your hard drive model and serial number.

Example:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
[gb@hda ~]$ ls -1 /dev/disk/by-id/ | egrep -v "part|scsi"
ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V
ata-ST31000528AS_6VP08W65
ata-ST3750640A_3QD0LJN8
ata-ST3750640A_5QD27A57
ata-WDC_WD10EADS-00L5B1_WD-WCAU4C700358
usb-ST310003_33AS_9E1CA6FFFFFF-0:0
usb-ST375064_0A_2009031309E2-0:0
</div>

=Install prerequisites=

[[Open Terminal as root|In a Terminal, as root]], type the following (two) commands:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
yum -y install pmount fuse fuse-libs ntfs-3g gparted util-linux-ng
</div>

=Partition and format the hard drive=

This step is optional, and should only be executed if you want to delete the content of your new hard drive, or if the hard drive has not yet been formatted.

You should (unless you have a good reason not to) use GParted to partition and format your hard drive.<br/>
Not having X installed would qualify as a good reason! In such cases, either use SSH X11 Forwarding (Google that if you'd like to use this), or [[Adding_a_second_hard_drive_to_your_HDA#Using_cfdisk|use cfdisk]] from a [[Open Terminal as root|Terminal, as root]].

You'll probably want to create a single partition, and format it as ''ext3''.<br/>
Note that Windows can't read ext3 partitions, so if you want dual-boot Windows on your Amahi PC, or if you intend to connect this hard drive to a Windows computer later, you should format as NTFS instead, and you should do that on Windows before you connect the drive in your HDA.<br/>
Remember that using NTFS partitions on Linux will be slower that using ext3 partitions, so you should only use NTFS if you really need it.<br/>
How much slower: compare the blue bars (NTFS-3G) with the red bars (ext3) on [http://www.tuxera.com/products/tuxera-ntfs-commercial/performance/ this graph].

To know what device (/dev/sdX) you need to partition and format, use the following command, in a [[Open Terminal as root|Terminal, as root]]:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
ls -l /dev/disk/by-id/
</div>

Find the row corresponding to your hard drive, and look at the end of the line to identify the correct device to use.

Example:
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;"><small>
[gb@hda ~]$ ls -l /dev/disk/by-id/
total 0
lrwxrwxrwx 1 root root 9 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V -> ../../sda
lrwxrwxrwx 1 root root 10 2010-02-18 03:24 ata-Hitachi_HDS722020ALA330_JK1131YAGDU37V-part1 -> ../../sda1
lrwxrwxrwx 1 root root 9 2010-02-18 03:24 ata-ST31000528AS_6VP08W65 -> ../../sdb
</small>
</div>

In the above example, /dev/sdb would be what I would select in GParted (or use on the cfdisk command). sda in my primary hard drive, and sdb my second hard drive.

==Using GParted==
From the HDA desktop (or using VNC), [[Open Terminal as root]] and type '''gparted''' to launch the GParted application.

Select the device (/dev/sdX) that you found above.

In the above example, /dev/sdb would be what I would select in GParted.

There are many easy to follow guides online on how to use GParted. You should Google for one, to find one that seems clear to you.

[http://www.mepisguides.com/Mepis-6/Install/gparted/gparted-set-partition.html Here's one] that looks simple. Just use ext3 instead of fat32 in you follow that tutorial.

Note that gparted supports GUID-partitioned drives, however, these directions and script do not support it at the moment.

==Using cfdisk==
From a [[Open Terminal as root|terminal, as root]], type '''cfdisk /dev/sdX''' to launch the cfdisk application.

If you have a GUID-partitioned drive, cfdisk will complain. GUID partitions are not supported.

Make sure to replace /dev/sdX with the actual device (eg. /dev/sdb) that you found above.

If your hard drive contains existing partitions, select them one by one at the top (using up/down arrow keys), then select the '''[ Delete ]''' action (using the left/right arrow keys), then hit ENTER.

You should now only have Free Space listed at the top.<br/>
Select the '''[ New ]''' action, and accept the default (Primary, and size).

You should now have a single partition listed at the top, of type Linux.<br/>
Select the '''[ Write ]''' action, then '''[ Quit ]'''.

Now that you partitioned your drive, you need to format your newly created partition.<br/>
To format as EXT3, use this command:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
mkfs.ext3 -j /dev/sdX1
</div>

Replace ext3 with ext4 in the above command to format your partition as EXT4 instead of EXT3.

'''/dev/sdX1''' in the above command refers to the partition your created in cfdisk.<br/>
Go back in cfdisk, and check the ''Name'' column if you're unsure.<br/>
If you see ''sdb1'' in the name column, you should use '''/dev/sdb1''' in the above command.

=Mount the hard drive=

A script is provided with Amahi that will look for unmounted partitions in your system, and mount any it finds.

[[Open Terminal as root|In a Terminal, as root]], type the following command:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
hda-diskmount
</div>

Example:
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;">
<small>
[root@hda ~]$ hda-diskmount
****************************************************************
Ignoring /dev/sda1 - already in /etc/fstab or mounted
****************************************************************
Mounted /dev/<strong style="color:green">sdb1</strong> as '<strong style="color:red">/var/hda/files/drives/sdb1</strong>' (read-write)
You may want your system to mount it every time you boot.
To do so, add this line VERY CAREFULLY to /etc/fstab and reboot:
<strong style="color:blue">UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2</strong>
****************************************************************
All Linux, Windows and Mac partitions on non-removable disks have been mounted
</small>
</div>

Do '''not''' edit /etc/fstab just yet. What you'll need to add there will depend on how you want to use the extra storage. More about that below.<br/>
Just note down the information in bold (green, red and blue). We'll use them below.

Note about ext4 in the blue line above: that doesn't necessarily mean your partition is formatted as ext4. It means the ext4 driver will be used to mount your partition. Since that driver is backward compatible, it can be safely used to mount ext2, ext3 and ext4 partitions.

If you get something like ''Disk /dev/dm-0 doesn't contain a valid partition table'' or ''mount: unknown file system type 'lvm2pv''' its because you have LVM's that 'fdisk' can not recognize (or something similar). It's nothing to worry about if you get that when executing the hda-diskmount script.

==Test your hard drive==
Optionally, you can test your new drive for bad blocks.<br/>
Note that this step can take a ''long'' time to complete! You'll probably want to start it in the evening, to have it completed in the morning.

To do so, [[Open Terminal as root|in a Terminal, as root]], type the following command. Replace <strong style="color:green">sdb1</strong> with the (green) value you received from hda-diskmount.

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
e2fsck -cn /dev/<strong style="color:green">sdb1</strong>
</div>

You'll receive a warning that says "WARNING!!! Running e2fsck on a mounted filesystem may cause SEVERE filesystem damage. Do you really want to continue (y/n)?"<br/>
Answer ''yes''. The -cn option we're using can safely be used on mounted filesystems.

=Use the hard drive=

You have a choice here on how to use your new hard drive storage space. We'll offer some examples.

==Use the hard drive for all shares==

If you want all your shares to be on your new hard drive, here's how to do that.

First, you'll want to move all you previous shares data, if any, into your new drive.<br/>
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders.<br/>
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount.
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
mv /var/hda/files/* <strong style="color:red">/var/hda/files/drives/sdb1/</strong>
</div>
You'll get a warning about "cannot move `/var/hda/files/drives' to a subdirectory of itself"; that is fine, ignore that.

Next, you'll need to unmount your new hard drive, and remount it as /var/hda/files

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
umount /var/hda/files/drives/sdb1/
</div>

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
nano /etc/fstab
</div>

In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you (the blue one), and change the second value (the path).<br/>
Replace the second value with '''/var/hda/files'''.

hda-diskmount gave me:
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
<span style="color:blue">UUID=9d972abc-1639-44df-a60e-668618d40236 <strong>/var/hda/files/drives/sdb1</strong> ext4 defaults 1 2</span>
</div>

So I should add this instead:
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
UUID=9d972abc-1639-44df-a60e-668618d40236 <strong>/var/hda/files</strong> ext4 defaults 1 2
</div>

Make sure you do '''not''' change anything else from the blue line you received from hda-diskmount.<br/>
It might not be the same thing as the above example; you need to use the values you've received.

Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
mount -a
ls /var/hda/files/
</div>

That last command should show you the content of you new hard drive.

That's it. All your shares in /var/hda/files are now on your new hard drive.

==Use the hard drive for only some shares==

If you want only some of your shares to be on your new hard drive, here's how to do that.

First, you'll want to move your previous shares data, if any, into your new drive.<br/>
You only need to do this next command if you have data that you care about in the /var/hda/files/* folders (that you want on the new drive).<br/>
[[Open Terminal as root|In a Terminal, as root]], type the following command. Replace the path in red with the path you received when you ran hda-diskmount. Replace '''something''' with the name of the share you want to have on your new drive (the share should already exist).
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
mv /var/hda/files/<strong>something</strong> <strong style="color:red">/var/hda/files/drives/sdb1/</strong>
</div>

Repeat with every share you want on your new drive.

Next, you'll need to make the mount permanent

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
umount /var/hda/files/drives/sdb1<br/>
nano /etc/fstab
</div>

In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.<br/>

So, following previous examples, I should add this:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;">
<span style="color: blue;">UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2</span>
</div>

Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
mount -a
ls /var/hda/files/drives/sdb1
</div>

That last command should show you the content of you new hard drive.

That's it. Your share(s) are now on your new hard drive.

==Use the hard drive in your Greyhole storage pool==

If you want to add your new hard drive to your Greyhole storage pool, here's how to do that.

First, you'll need to make the mount permanent. [[Open Terminal as root|In a Terminal, as root]], type the following command:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
umount /var/hda/files/drives/sdb1
nano /etc/fstab
</div>

In nano, you'll need to add a new line at the bottom. Take the line that hda-diskmount gave you, and insert that.<br/>

So, following previous examples, I should add this:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left;">
<span style="color: blue;">UUID=9d972abc-1639-44df-a60e-668618d40236 /var/hda/files/drives/sdb1 ext4 defaults 1 2</span>
</div>

Save and exit nano (CTRL-X, Y, ENTER), and try your new mount:

<div style="border: 1px solid #A3B1BF; padding: .5em 1em; background-color: #E6F2FF; margin: 3px 3px 1em 3px;">
mount -a
</div>

Finally, you'll need to configure Greyhole to select your new partition. To configure Greyhole, Advanced Settings must be enabled under [http://hda/setup?sub=settings&tab=setting Setup > Settings].

In the [http://hda/setup?sub=disk_pooling&tab=share Shares > Storage Pool page] of your Amahi dashboard, you'll see a list of mounted partitions, with checkboxes next to each, allowing you to include those partitions in your storage pool.

You should now have a new row in there, referring to /var/hda/files/drives/sdb1.

Select it (click the checkbox).

That's it. Your new hard drive just increased your Greyhole storage pool capacity.

UbuntuTesting

2010-07-30T01:35:56Z

Cale250:

=Testing For Amahi on Ubuntu=
'''NOTE'''
* There are no apps for this release
* This is a CLOSED beta as of right now. You can refer people for testing, but you need permission from cale250 or cpg.
* You'll need the CD OR DVD for Ubuntu 10.04 LTS Desktop
* DO NOT install on a production machine. It's not even close to being ready yet.
* This is a testing release. It may be broken from time to time. Only update if you receive an e-mail.
* Please report bugs on the forum first. I'll post them to the tracker.

'''Step by Step Instructions for Installation'''
# Install Ubuntu normally.
# Once installed, open up the terminal and run the following:
<code> $> sudo add-apt-repository ppa:amahi-drivers/amahi</code>
# Open up Synaptic and refresh the package lists (Click Refresh)
# Search for and install hdactl and hda-platform
# Reboot once done.
# Upon logging in, start Firefox and type http://localhost:2000/ in the address bar
# Enter your Amahi install code in the appropriate box (should look very familiar!)
# Let it do its work, and click the Reboot button at the end.
# Log in and test it out!

'''Updating your Amahi (for bug fixes and stuff)'''
# Please review the e-mail or other means carefully. Upgrading certain packages not mentioned could cause your install to break.
# Open Synaptic (NOT Update Manager) and mark the appropriate packages to upgrade.
# You know the drill.

UbuntuPorting

2010-06-16T07:27:16Z

Cale250: Updated to standard deb packaging

UbuntuTesting

2010-06-16T06:42:45Z

Cale250: Added upgrade instructions

=Testing For Amahi on Ubuntu=
'''NOTE'''
* There are no apps for this release
* This is a CLOSED beta as of right now. You can refer people for testing, but you need permission from cale250 or cpg.
* You'll need the CD OR DVD for Ubuntu 10.04 LTS Desktop
* DO NOT install on a production machine. It's not even close to being ready yet.
* This is a testing release. It may be broken from time to time. Only update if you receive an e-mail.

'''Step by Step Instructions for Installation'''
# Install Ubuntu normally.
# Once installed, open up the terminal and run the following:
<code> $> sudo add-apt-repository ppa:amahi-drivers/amahi</code>
# Open up Synaptic and refresh the package lists (Click Refresh)
# Search for and install hdactl and hda-platform
# Reboot once done.
# Upon logging in, start Firefox and type http://localhost:2000/ in the address bar
# Enter your Amahi install code in the appropriate box (should look very familiar!)
# Let it do its work, and click the Reboot button at the end.
# Log in and test it out!

'''Updating your Amahi (for bug fixes and stuff)'''
# Please review the e-mail or other means carefully. Upgrading certain packages not mentioned could cause your install to break.
# Open Synaptic (NOT Update Manager) and mark the appropriate packages to upgrade.
# You know the drill.

UbuntuTesting

2010-06-14T16:26:55Z

Cale250: grammatical error

=Testing For Amahi on Ubuntu=
'''NOTE'''
* There are no apps for this release
* This is a CLOSED beta as of right now. You can refer people for testing, but you need permission from cale250 or cpg.
* You'll need the CD OR DVD for Ubuntu 10.04 LTS Desktop
* DO NOT install on a production machine. It's not even close to being ready yet.
* This is a testing release. It may be broken from time to time. Only update if you receive an e-mail.

'''Step by Step Instructions for Installation'''
# Install Ubuntu normally.
# Once installed, open up the terminal and run the following:
<code> $> sudo add-apt-repository ppa:amahi-drivers/amahi</code>
# Open up Synaptic and refresh the package lists (Click Refresh)
# Search for and install hdactl and hda-platform
# Reboot once done.
# Upon logging in, start Firefox and type http://localhost:2000/ in the address bar
# Enter your Amahi install code in the appropriate box (should look very familiar!)
# Let it do its work, and click the Reboot button at the end.
# Log in and test it out!

UbuntuTesting

2010-06-14T00:44:13Z

Cale250:

=Testing For Amahi on Ubuntu=
'''NOTE'''
* There are no apps for this release
* This is a CLOSED beta as of right now. You can refer people for testing, but you need permission from cale250 or cpg.
* You'll need the CD OR DVD for Ubuntu 10.04 LTS Desktop
* DO NOT install on a production machine. It's not even close to being ready yet.
* This is a testing release. It may be broken from time to time. Only update if you receive an e-mail.

'''Step by Step Instructions for Installation'''
# Install Ubuntu normally.
# Once installed, open up the terminal and run the following:
<code> $> sudo add-apt-repository ppa:amahi-drivers/amahi</code>
# Open up Synaptic and refresh the package lists (Click Refresh)
# Search for and install hdactl and hda-platform
# Reboot once done.
# Upon logging in, start Firefox and type http://localhost:2000/ in the address bar
# Enter your Amahi install code in the appropriate box (should look very familiar!)
# Let it do it's work, and click the Reboot button at the end.
# Log in and test it out!

UbuntuTesting

2010-06-14T00:38:29Z

Cale250: Created page with '=Testing For Amahi on Ubuntu= '''NOTE''' * There are no apps for this release * This is a CLOSED beta as of right now. You can refer people for testing, but you need permission f…'

=Testing For Amahi on Ubuntu=
'''NOTE'''
* There are no apps for this release
* This is a CLOSED beta as of right now. You can refer people for testing, but you need permission from cale250 or cpg.
* You'll need the CD OR DVD for Ubuntu 10.04 LTS Desktop
* DO NOT install on a production machine. It's not even close
* This is a testing release. It may be broken from time to time. Only update if you receive an e-mail.

'''Step by Step Instructions for Installation'''
# Install Ubuntu normally.
# Once installed, open up the terminal and run the following:
<code> $> sudo add-apt-repository ppa:amahi-drivers/amahi</code>
# Open up Synaptic and refresh the package lists (Click Refresh)
# Search for and install hdactl and hda-platform
# Reboot once done.
# Upon logging in, start Firefox and type http://localhost:2000/ in the address bar
# Enter your Amahi install code in the appropriate box (should look very familiar!)
# Let it do it's work, and click the Reboot button at the end.
# Log in and test it out!

UbuntuPorting

2010-06-01T06:45:54Z

Cale250:

'''This page is being edited actively and a lot of sections are missing currently'''

=Current state=
We just started porting Amahi to Ubuntu. The support is highly experimental. There are a few important things to be fixed before you can run it with minimal tweaking. Please don't try it on a production server yet. We are using Ubuntu 10.04 LTS (Lucid) Desktop 32 bit for development. We strongly recommend you to use the same for experiments. You can download this version from [http://www.ubuntu.com/getubuntu/download here].

=Requirements=
You may want to have two different installations of Ubuntu.
* A development platform, running Ubuntu 10.04 LTS Desktop 32 bit and/or 64 bit with the recommended development packages installed.
* An Amahi sandbox, running Ubuntu 10.04 LTS Desktop 32 bit '''preferably''' under [http://www.virtualbox.org/ VirtualBox].
Please don't install the Amahi packages on the development platform as this might break your networking.

=Setting up the development platform=
# Install Ubuntu 10.04 LTS Desktop 32 bit.
# Install essential build toolchain.
## sudo apt-get update
## sudo apt-get install build-essential
## sudo apt-get install devscripts
## sudo apt-get install debhelper
## sudo apt-get install fakeroot
## sudo apt-get install lintian
# Install git. # sudo aptitude install git-core
# Read [https://wiki.ubuntu.com/PackagingGuide/Complete Ubuntu packaging guide] to get an idea of other additional packages that you may want to install to create Ubuntu packages. I will list the packages to make your part easier at a later point.

=Setting up the Amahi sandbox=
# Install [http://www.virtualbox.org/ Sun VirtualBox]. # sudo aptitude install virtualbox-ose
# Open VirtualBox and create a new guest platform for Ubuntu and install Ubuntu 10.04 LTS Desktop 32 bit.
# Install VirtualBox guest additions in your Amahi sandbox. # sudo apt-get install virtualbox-ose-guest-utils (do this inside your virtual machine!)
# Setup VirtualBox folder sharing between your development platform and Amahi sandbox.

=Amahi source code=
On your development platform, download Amahi source code from our git repository. Follow these steps to build Ubuntu packages.

Update Changelog

1. If you are repackaging for a newhttp://bugs.amahi.org/issues/show/487 version Run dch -v with the version number currently in the makefile. Where you run the command depends on if you are changing hdactl or hda-platform.

# cd deb/ubuntu/karmic/hdactl
OR
# cd deb/ubuntu/karmic/hda-platform

# dch -v <version number>

Add the changes that you made to the system. If you are just updating for a new version state so.

If you are not changing the version number run dch -a. Where you run the command depends on if you are changing hdactl or hda-platform.
# cd deb/ubuntu/karmic/hdactl
OR
# cd deb/ubuntu/karmic/hda-platform

# dch -a

NOTE: If you are just building a .deb for your own testing you can just run make deb or continue to step 2.

2. To build hdactl package, change to 'platform/hdactl' directory and
run 'make deb'.

# cd platform/hdactl
# rm -rf hdactl-hup
# rm -rf platform/hdactl/release
# make deb

NOTE: The removing of hdactl-hup is only needed if it is present.

You will find the .deb file generated under platform/hdactl/release
directory.

NOTE: For ease of use use gdebi to install.

3. To build hda-platform package, change to 'platform/platform' directory and
run 'make deb'.

# cd platform/platform
# make deb

You will find the .deb file generated under platform/platform/release
directory.

=Architecture differences=
*No /etc/sysconfig folder. Instead, configuration is scattered all over the place.
*Requires copying the functions library required by several shellscripts (but works fine)

=Post install gotchas (asp's notes)=

= Known Bugs =
Check out our project at [http://bugs.amahi.org/projects/show/ubuntu our bugtracker]
=Considerations=
*<s>Apache mod_passenger</s> This has been implemented in the installer since it is now in the default repositories.

'''This page is being edited actively and a lot of sections are missing currently'''

Ubuntu

2010-05-25T05:33:56Z

Cale250:

==Can I install Amahi on Ubuntu?==

Not yet. We hope to get Ubuntu contributions soon.

The long term goal for Amahi is to be an "easy to use" product rather than "for geeks only."

This is why the Amahi home server is managed through a Web 2.0 browser-based interface and is designed to run headless. Of course file sharing and related activities are supported cross platform - Linux, Windows and Mac.

The underlying distribution that Amahi is currently built on is Fedora.

There are frequent requests to make an Ubuntu version available - but to date there are not enough "truly experienced" Ubuntu developers ready to commit to make this happen. As developers get involved they realize that the underlying distribution does not impact the end user experience.

Amahi is designed to run headless, so porting to Ubuntu has not been a very high priority task (there is a lot of learning, since the developers are more familiar with Fedora). The development time is mostly spent improving Amahi while we gather real Ubuntu contributions.

If you are ready to lead the effort, let us know and the team will help get you started. Please subscribe to the amahi-devel mailing list!

== What To Do ==

NOTE: some [[UbuntuPorting | Ubuntu Porting Notes]] '''<-- CURRENT STATUS'''

Here are the rough suggested steps to make Amahi on Ubuntu possible.

# Focus on an installed system first, '''writing down''' (say in a wiki page here) the things needed to get things running. Later focus on the installer, which will have many more platform dependencies.
# Install Ubuntu server
# Install ruby, rails and the appropropriate gems (write down the exact commands needed to do this)
# Make the interface work first. Use RoR in development mode on a base amahi platform tree. This should be platform independent.
# Once the interface is working, install the Amahi control daemon. This will need some hooks to make work under Ubuntu for sure.
# This will complete the two basic things needed to get the ball rolling. The next one will be applications. This is potentially complex.
# After all of this is done, the various parts will need to be packaged as debs and put in a repo for ubuntu
# Finally, testing, testing, testing! :)

Some open questions/topics:

* Can we somehow live with RPMs in the short term (which is what we have today)? Using something that we have today would make it easier right away, i.e. if we can go with a repo that we already have, it would be a massive step to get started.
* Should we start with ubuntu desktop or ubuntu server? - my first impression would be server, which makes more sense. Any gotchas with that?
* How are updates handled in ubuntu?

Throw your ideas around about these at [http://forums.amahi.org/viewtopic.php?f=6&t=1416&p=7161 this forum post.]

Given how there is a lot of learning to be achieved on both sides,
you should probably stop by the [http://webchat.freenode.net/?channels=amahi #amahi irc channel]
at irc.freenode.net. At least one or two of the usuals
there are also interested in Ubuntu.

You can also discuss this in the amahi-devel mailing list.

UbuntuPorting

2010-05-25T05:10:04Z

Cale250:

'''This page is being edited actively and a lot of sections are missing currently'''

=Current state=
We just started porting Amahi to Ubuntu. The support is highly experimental. There are a few important things to be fixed before you can run it with minimal tweaking. Please don't try it on a production server yet. We are using Ubuntu 10.04 LTS (Lucid) Desktop 32 bit for development. We strongly recommend you to use the same for experiments. You can download this version from [http://www.ubuntu.com/getubuntu/download here].

=Requirements=
You may want to have two different installations of Ubuntu.
* A development platform, running Ubuntu 10.04 LTS Desktop 32 bit and/or 64 bit with the recommended development packages installed.
* An Amahi sandbox, running Ubuntu 10.04 LTS Desktop 32 bit '''preferably''' under [http://www.virtualbox.org/ VirtualBox].
Please don't install the Amahi packages on the development platform as this might break your networking.

=Setting up the development platform=
# Install Ubuntu 10.04 LTS Desktop 32 bit.
# Install essential build toolchain.
## sudo apt-get update
## sudo apt-get install build-essential
## sudo apt-get install devscripts
## sudo apt-get install debhelper
## sudo apt-get install fakeroot
## sudo apt-get install lintian
# Install git. # sudo aptitude install git-core
# Read [https://wiki.ubuntu.com/PackagingGuide/Complete Ubuntu packaging guide] to get an idea of other additional packages that you may want to install to create Ubuntu packages. I will list the packages to make your part easier at a later point.

=Setting up the Amahi sandbox=
# Install [http://www.virtualbox.org/ Sun VirtualBox]. # sudo aptitude install virtualbox-ose
# Open VirtualBox and create a new guest platform for Ubuntu and install Ubuntu 10.04 LTS Desktop 32 bit.
# Install VirtualBox guest additions in your Amahi sandbox. # sudo apt-get install virtualbox-ose-guest-utils (do this inside your virtual machine!)
# Setup VirtualBox folder sharing between your development platform and Amahi sandbox.

=Amahi source code=
On your development platform, download Amahi source code from our git repository. Follow these steps to build Ubuntu packages.

Update Changelog

1. If you are repackaging for a newhttp://bugs.amahi.org/issues/show/487 version Run dch -v with the version number currently in the makefile. Where you run the command depends on if you are changing hdactl or hda-platform.

# cd deb/ubuntu/karmic/hdactl
OR
# cd deb/ubuntu/karmic/hda-platform

# dch -v <version number>

Add the changes that you made to the system. If you are just updating for a new version state so.

If you are not changing the version number run dch -a. Where you run the command depends on if you are changing hdactl or hda-platform.
# cd deb/ubuntu/karmic/hdactl
OR
# cd deb/ubuntu/karmic/hda-platform

# dch -a

NOTE: If you are just building a .deb for your own testing you can just run make deb or continue to step 2.

2. To build hdactl package, change to 'platform/hdactl' directory and
run 'make deb'.

# cd platform/hdactl
# rm -rf hdactl-hup
# rm -rf platform/hdactl/release
# make deb

NOTE: The removing of hdactl-hup is only needed if it is present.

You will find the .deb file generated under platform/hdactl/release
directory.

NOTE: For ease of use use gdebi to install.

3. To build hda-platform package, change to 'platform/platform' directory and
run 'make deb'.

# cd platform/platform
# make deb

You will find the .deb file generated under platform/platform/release
directory.

=Architecture differences=
*No /etc/sysconfig folder. Instead, configuration is scattered all over the place.
*Requires copying the functions library required by several shellscripts (but works fine)

=Post install gotchas (asp's notes)=

= Known Bugs =
*Debian control script for platform may be missing some dependencies. [http://bugs.amahi.org/issues/show/487 bug 487]
*<s>Passenger does not install see Considerations [http://bugs.amahi.org/issues/show/483 bug 483]</s> This now works in Lucid fine
*<s>HDACTL init scripts do not work [http://bugs.amahi.org/issues/show/484 bug 484]</s> Some do work under Fedora formatting (interesting!). amahi-installer script needs work to run.
=Considerations=
*<s>Apache mod_passenger</s> This has been implemented in the installer since it is now in the default repositories.

'''This page is being edited actively and a lot of sections are missing currently'''

UbuntuPorting

2010-05-24T23:14:04Z

Cale250: Typo!

'''This page is being edited actively and a lot of sections are missing currently'''

=Current state=
We just started porting Amahi to Ubuntu. The support is highly experimental. There are a few important things to be fixed before you can run it with minimal tweaking. Please don't try it on a production server yet. We are using Ubuntu 10.04 LTS (Lucid) Desktop 32 bit for development. We strongly recommend you to use the same for experiments. You can download this version from [http://www.ubuntu.com/getubuntu/download here].

=Requirements=
You may want to have two different installations of Ubuntu.
* A development platform, running Ubuntu 10.04 LTS Desktop 32 bit and/or 64 bit with the recommended development packages installed.
* An Amahi sandbox, running Ubuntu 10.04 LTS Desktop 32 bit '''preferably''' under [http://www.virtualbox.org/ VirtualBox].
Please don't install the Amahi packages on the development platform as this might break your networking.

=Setting up the development platform=
# Install Ubuntu 10.04 LTS Desktop 32 bit.
# Install essential build toolchain.
## sudo apt-get update
## sudo apt-get install build-essential
## sudo apt-get install devscripts
## sudo apt-get install debhelper
## sudo apt-get install fakeroot
## sudo apt-get install lintian
# Install git. # sudo aptitude install git-core
# Read [https://wiki.ubuntu.com/PackagingGuide/Complete Ubuntu packaging guide] to get an idea of other additional packages that you may want to install to create Ubuntu packages. I will list the packages to make your part easier at a later point.

=Setting up the Amahi sandbox=
# Install [http://www.virtualbox.org/ Sun VirtualBox]. # sudo aptitude install virtualbox-ose
# Open VirtualBox and create a new guest platform for Ubuntu and install Ubuntu 10.04 LTS Desktop 32 bit.
# Install VirtualBox guest additions in your Amahi sandbox. # sudo apt-get install virtualbox-ose-guest-utils (do this inside your virtual machine!)
# Setup VirtualBox folder sharing between your development platform and Amahi sandbox.

=Amahi source code=
On your development platform, download Amahi source code from our git repository. Follow these steps to build Ubuntu packages.

Update Changelog

1. If you are repackaging for a newhttp://bugs.amahi.org/issues/show/487 version Run dch -v with the version number currently in the makefile. Where you run the command depends on if you are changing hdactl or hda-platform.

# cd deb/ubuntu/karmic/hdactl
OR
# cd deb/ubuntu/karmic/hda-platform

# dch -v <version number>

Add the changes that you made to the system. If you are just updating for a new version state so.

If you are not changing the version number run dch -a. Where you run the command depends on if you are changing hdactl or hda-platform.
# cd deb/ubuntu/karmic/hdactl
OR
# cd deb/ubuntu/karmic/hda-platform

# dch -a

NOTE: If you are just building a .deb for your own testing you can just run make deb or continue to step 2.

2. To build hdactl package, change to 'platform/hdactl' directory and
run 'make deb'.

# cd platform/hdactl
# rm -rf hdactl-hup
# rm -rf platform/hdactl/release
# make deb

NOTE: The removing of hdactl-hup is only needed if it is present.

You will find the .deb file generated under platform/hdactl/release
directory.

NOTE: For ease of use use gdebi to install.

3. To build hda-platform package, change to 'platform/platform' directory and
run 'make deb'.

# cd platform/platform
# make deb

You will find the .deb file generated under platform/platform/release
directory.

=Architecture differences=
*No /etc/sysconfig folder. Instead, configuration is scattered all over the place.
*Requires copying the functions library required by several shellscripts (but works fine)

=Post install gotchas (asp's notes)=

= Known Bugs =
*Debian control script for platform may be missing some dependencies. [http://bugs.amahi.org/issues/show/487 bug 487]
*Passenger does not install see Considerations [http://bugs.amahi.org/issues/show/483 bug 483]
*<s>HDACTL init scripts do not work [http://bugs.amahi.org/issues/show/484 bug 484]</s> Some do work under Fedora formatting (interesting!). amahi-installer script needs work to run.
=Considerations=
*<s>Apache mod_passenger</s> This has been implemented in the installer since it is now in the default repositories.

'''This page is being edited actively and a lot of sections are missing currently'''

UbuntuPorting

2010-05-24T23:13:13Z

Cale250: Updated to current status of project

'''This page is being edited actively and a lot of sections are missing currently'''

=Current state=
We just started porting Amahi to Ubuntu. The support is highly experimental. There are a few important things to be fixed before you can run it with minimal tweaking. Please don't try it on a production server yet. We are using Ubuntu 10.04 LTS (Lucid) Desktop 32 bit for development. We strongly recommend you to use the same for experiments. You can download this version from [http://www.ubuntu.com/getubuntu/download here].

=Requirements=
You may want to have two different installations of Ubuntu.
* A development platform, running Ubuntu 10.04 LTS Desktop 32 bit and/or 64 bit with the recommended development packages installed.
* An Amahi sandbox, running Ubuntu 10.04 LTS Desktop 32 bit '''preferably''' under [http://www.virtualbox.org/ VirtualBox].
Please don't install the Amahi packages on the development platform as this might break your networking.

=Setting up the development platform=
# Install Ubuntu 9.04 Desktop 32 bit.
# Install essential build toolchain.
## sudo apt-get update
## sudo apt-get install build-essential
## sudo apt-get install devscripts
## sudo apt-get install debhelper
## sudo apt-get install fakeroot
## sudo apt-get install lintian
# Install git. # sudo aptitude install git-core
# Read [https://wiki.ubuntu.com/PackagingGuide/Complete Ubuntu packaging guide] to get an idea of other additional packages that you may want to install to create Ubuntu packages. I will list the packages to make your part easier at a later point.

=Setting up the Amahi sandbox=
# Install [http://www.virtualbox.org/ Sun VirtualBox]. # sudo aptitude install virtualbox-ose
# Open VirtualBox and create a new guest platform for Ubuntu and install Ubuntu 10.04 LTS Desktop 32 bit.
# Install VirtualBox guest additions in your Amahi sandbox. # sudo apt-get install virtualbox-ose-guest-utils (do this inside your virtual machine!)
# Setup VirtualBox folder sharing between your development platform and Amahi sandbox.

=Amahi source code=
On your development platform, download Amahi source code from our git repository. Follow these steps to build Ubuntu packages.

Update Changelog

1. If you are repackaging for a newhttp://bugs.amahi.org/issues/show/487 version Run dch -v with the version number currently in the makefile. Where you run the command depends on if you are changing hdactl or hda-platform.

# cd deb/ubuntu/karmic/hdactl
OR
# cd deb/ubuntu/karmic/hda-platform

# dch -v <version number>

Add the changes that you made to the system. If you are just updating for a new version state so.

If you are not changing the version number run dch -a. Where you run the command depends on if you are changing hdactl or hda-platform.
# cd deb/ubuntu/karmic/hdactl
OR
# cd deb/ubuntu/karmic/hda-platform

# dch -a

NOTE: If you are just building a .deb for your own testing you can just run make deb or continue to step 2.

2. To build hdactl package, change to 'platform/hdactl' directory and
run 'make deb'.

# cd platform/hdactl
# rm -rf hdactl-hup
# rm -rf platform/hdactl/release
# make deb

NOTE: The removing of hdactl-hup is only needed if it is present.

You will find the .deb file generated under platform/hdactl/release
directory.

NOTE: For ease of use use gdebi to install.

3. To build hda-platform package, change to 'platform/platform' directory and
run 'make deb'.

# cd platform/platform
# make deb

You will find the .deb file generated under platform/platform/release
directory.

=Architecture differences=
*No /etc/sysconfig folder. Instead, configuration is scattered all over the place.
*Requires copying the functions library required by several shellscripts (but works fine)

=Post install gotchas (asp's notes)=

= Known Bugs =
*Debian control script for platform may be missing some dependencies. [http://bugs.amahi.org/issues/show/487 bug 487]
*Passenger does not install see Considerations [http://bugs.amahi.org/issues/show/483 bug 483]
*<s>HDACTL init scripts do not work [http://bugs.amahi.org/issues/show/484 bug 484]</s> Some do work under Fedora formatting (interesting!). amahi-installer script needs work to run.
=Considerations=
*<s>Apache mod_passenger</s> This has been implemented in the installer since it is now in the default repositories.

'''This page is being edited actively and a lot of sections are missing currently'''

Ubuntu

2010-05-23T21:47:10Z

Cale250:

==Can I install Amahi on Ubuntu?==

Not yet. We hope to get Ubuntu contributions soon.

The long term goal for Amahi is to be an "easy to use" product rather than "for geeks only."

This is why the Amahi home server is managed through a Web 2.0 browser-based interface and is designed to run headless. Of course file sharing and related activities are supported cross platform - Linux, Windows and Mac.

The underlying distribution that Amahi is currently built on is Fedora.

There are frequent requests to make an Ubuntu version available - but to date there are not enough "truly experienced" Ubuntu developers ready to commit to make this happen. As developers get involved they realize that the underlying distribution does not impact the end user experience.

Amahi is designed to run headless, so porting to Ubuntu has not been a very high priority task (there is a lot of learning, since the developers are more familiar with Fedora). The development time is mostly spent improving Amahi while we gather real Ubuntu contributions.

If you are ready to lead the effort, let us know and the team will help get you started. Please subscribe to the amahi-devel mailing list!

== What To Do ==

NOTE: some [[UbuntuPorting | Ubuntu Porting Notes]]

Here are the rough suggested steps to make Amahi on Ubuntu possible.

# Focus on an installed system first, '''writing down''' (say in a wiki page here) the things needed to get things running. Later focus on the installer, which will have many more platform dependencies.
# Install Ubuntu server
# Install ruby, rails and the appropropriate gems (write down the exact commands needed to do this)
# Make the interface work first. Use RoR in development mode on a base amahi platform tree. This should be platform independent.
# Once the interface is working, install the Amahi control daemon. This will need some hooks to make work under Ubuntu for sure.
# This will complete the two basic things needed to get the ball rolling. The next one will be applications. This is potentially complex.
# After all of this is done, the various parts will need to be packaged as debs and put in a repo for ubuntu
# Finally, testing, testing, testing! :)

Some open questions/topics:

* Can we somehow live with RPMs in the short term (which is what we have today)? Using something that we have today would make it easier right away, i.e. if we can go with a repo that we already have, it would be a massive step to get started.
* Should we start with ubuntu desktop or ubuntu server? - my first impression would be server, which makes more sense. Any gotchas with that?
* How are updates handled in ubuntu?

Throw your ideas around about these at [http://forums.amahi.org/viewtopic.php?f=6&t=1416&p=7161 this forum post.]

Given how there is a lot of learning to be achieved on both sides,
you should probably stop by the [http://webchat.freenode.net/?channels=amahi #amahi irc channel]
at irc.freenode.net. At least one or two of the usuals
there are also interested in Ubuntu.

You can also discuss this in the amahi-devel mailing list.

Ubuntu

2010-05-18T19:48:36Z

Cale250: Added link/line to Talk page. It's a bit more permanent than the mailing list or IRC.

==Can I install Amahi on Ubuntu?==

Not yet. We hope to get Ubuntu contributions soon.

The long term goal for Amahi is to be an "easy to use" product rather than "for geeks only."

This is why the Amahi home server is managed through a Web 2.0 browser-based interface and is designed to run headless. Of course file sharing and related activities are supported cross platform - Linux, Windows and Mac.

The underlying distribution that Amahi is currently built on is Fedora.

There are frequent requests to make an Ubuntu version available - but to date there are not enough "truly experienced" Ubuntu developers ready to commit to make this happen. As developers get involved they realize that the underlying distribution does not impact the end user experience.

Amahi is designed to run headless, so porting to Ubuntu has not been a very high priority task (there is a lot of learning, since the developers are more familiar with Fedora). The development time is mostly spent improving Amahi while we gather real Ubuntu contributions.

If you are ready to lead the effort, let us know and the team will help get you started. Please subscribe to the amahi-devel mailing list!

== What To Do ==

NOTE: some [[UbuntuPorting | Ubuntu Porting Notes]]

Here are the rough suggested steps to make Amahi on Ubuntu possible.

# Focus on an installed system first, '''writing down''' (say in a wiki page here) the things needed to get things running. Later focus on the installer, which will have many more platform dependencies.
# Install Ubuntu server
# Install ruby, rails and the appropropriate gems (write down the exact commands needed to do this)
# Make the interface work first. Use RoR in development mode on a base amahi platform tree. This should be platform independent.
# Once the interface is working, install the Amahi control daemon. This will need some hooks to make work under Ubuntu for sure.
# This will complete the two basic things needed to get the ball rolling. The next one will be applications. This is potentially complex.
# After all of this is done, the various parts will need to be packaged as debs and put in a repo for ubuntu
# Finally, testing, testing, testing! :)

Some open questions/topics:

* Can we somehow live with RPMs in the short term (which is what we have today)? Using something that we have today would make it easier right away, i.e. if we can go with a repo that we already have, it would be a massive step to get started.
* Should we start with ubuntu desktop or ubuntu server? - my first impression would be server, which makes more sense. Any gotchas with that?
* How are updates handled in ubuntu?

Throw your ideas around about these at [[Talk:Ubuntu]]

Given how there is a lot of learning to be achieved on both sides,
you should probably stop by the [http://webchat.freenode.net/?channels=amahi #amahi irc channel]
at irc.freenode.net. At least one or two of the usuals
there are also interested in Ubuntu.

You can also discuss this in the amahi-devel mailing list.

Talk:Ubuntu

2010-05-18T19:45:34Z

Cale250: Created the page with the "open questions in mind"

I'd like to start the open discussion here; here's my take on things:

1. I don't think we should stick with RPMs. While it is a LOT easier to package RPMs, most Ubuntu users have become used to Apt and the Debian style of packaging things. This will also help the updating side [switching to Apt], as they will automatically appear within the Update Manager if the repository is up.

2. The current Fedora version we have runs on a desktop machine. Ubuntu 10.04 is probably light enough, if not easier, on the memory than Fedora 12 on install in the Desktop edition. I also bet that if we develop for the desktop, we'll have fewer questions since there will be a GUI. I love working at the command line, but most do not ;)

3. In Ubuntu, updates are handled through two programs: update-manager and unattended-upgrades. The latter is disabled by default and the user must enable automatic download and install of such updates. We'll probably need to write a script that will change that for the user. The user can always be directed to use update-manager as necessary, however.

[[User:Cale250|Cale250]] 19:45, 18 May 2010 (UTC)