Difference between revisions of "Amahi 8 Install"

From Amahi Wiki
Jump to: navigation, search
 
(106 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{MessageBox|
 +
backgroundcolor = #faa|
 +
image =Warning.png|
 +
heading =WARNING|
 +
message = Amahi 8 for Fedora 21<br />Maintenance Support ONLY!
 +
Please use a supported release!<br />}}
 
__TOC__
 
__TOC__
  
'''NOTE:''' Ensure your system meets the [[Requirements|minimum requirements]] for Amahi before proceeding. Currently there is '''NO''' Express CD/DVD available.
+
'''NOTES:'''
= Download the Fedora DVD =
+
* Ensure your system meets the [http://docs.amahi.org/requirements.html minimum hardware requirements] for Amahi before proceeding.  
 +
* 32-bit installs '''are not''' available nor supported in Amahi 8.
 +
* '''NOT ALL''' apps available in Amahi 7 are fully operational for Amahi 8.  Check the [https://www.amahi.org/apps App Store] before proceeding.
 +
* You must install Fedora 21 Server prior to installing Amahi 8.
 +
 
 +
 
 +
For assistance, visit the [https://forums.amahi.org Amahi Forums] or live support on the [http://talk.amahi.org Amahi IRC channel].
  
'''NOTES:'''
+
= Install Fedora 21 =
* 32-bits '''IS NOT''' available nor supported in Amahi 8
+
 
* You need to install Fedora 21 first (minimal, if headless is desired, which is what we recommend) before installing Amahi 8 on it
+
There are two ways to install Fedora: Minimal (CD), so-called Netinstall, which is recommended, and the [[Fedora_21_Server_Install|Full (DVD) install]] for cases that need additional hardware support.
 +
 
 +
We recommend this method for a quick download and fast installation.
 +
 
 +
* Download the Fedora 21 Netinstall CD for 64 bit (424MB).
 +
** Primary:  [http://download.fedoraproject.org/pub/fedora/linux/releases/21/Server/x86_64/iso/Fedora-Server-netinst-x86_64-21.iso Fedora 21 Netinstall 64-bit] (http)
 +
** Alternate:  [https://dl.fedoraproject.org/pub/fedora/linux/releases/21/Server/x86_64/iso/Fedora-Server-netinst-x86_64-21.iso Fedora 21 Netinstall 64-bit] (http)
 +
 
 +
* Burn the ISO to CD (DVD or [[USB Install|USB]]), insert the media into your server, and reboot the system.
 +
 
 +
* These instructions below will guide you through the Fedora 21 Netinstall CD installation with screen shots and commentary.  Click '''[Expand]''' to show a screen shot and '''[Collapse]''' to hide it.
 +
 
 +
== Boot Screen ==
 +
<ul>
 +
<li>Select ''Install Fedora-Server 21''
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS0-Boot.PNG|600px]]
 +
</div><br></li>
 +
</ul>
 +
== Language Selection ==
 +
<ul>
 +
<li>Choose desired language and select ''Continue''
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
:[[File:SS1-Language.PNG|600px]]
 +
</div><br></li>
 +
</ul>
 +
== Installation Summary ==
 +
<ul>
 +
<li>The '''INSTALLATION SUMMARY''' screen will appear.  It may take a few minutes to finish ''Checking software dependencies''
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS2a-Install.PNG|600px]]
 +
</div><br></li>
 +
<li>Change the '''KEYBOARD''' or '''TIME & DATE''' to match your locale if needed.</li><br>
 +
<li>Once complete, next choose ''INSTALLATION DESTINATION''.  This is where you will select the disk drive to use.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS3a-Install-Disk.PNG|600px]]
 +
</div><br></li>
 +
</ul>
 +
 
 +
== Disk Drive Setup ==
 +
<ul>
 +
<li>Choose the disk drive you want to use for the Fedora installation.  If you have more than one disk drive connected, '''DO NOT''' select them at this time. You will notice a ''check mark'' on the disk drive selected.  Select ''I will configure partitioning'' and then choose ''Done''.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS5-Install-Disk.PNG|600px]]
 +
</div><br></li>
 +
<li>Should you have existing partitions on the disk drive you will be using for the Fedora 23 installation, they will have to be removed.</li>
 +
<ul>
 +
<li> You should see the existing partition about half way down the screen.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:DSS1.PNG|300px]] 
 +
</div></li><br>
 +
<li>Choose it to expand and display the existing partitions for deletion.  Select the first partition in the list followed by the minus (-) sign.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:DSS2.PNG|300px]]
 +
</div></li><br>
 +
<li> When prompted Are you sure you want to delete all the data on ..., choose Delete It.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:DSS3.PNG|400px]] 
 +
</div></li><br>
 +
<li> Repeat the previous two steps until all the existing partitions on the disk drive are gone.</li><br>
 +
</ul>
 +
<li>Ensure the ''New mount points will use the following partitioning scheme:'' is changed to reflect '''Standard partition'''.  Then select ''Click here to create them automatically''. We '''STRONGLY''' advise against use of LVM or setting a /home partition.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS6-Install-Disk.PNG|600px]]
 +
</div><br></li>
 +
<li>The disk drive partition should look similar to this setup.  For most users, then default partitioning scheme used will suffice.  However, you can manually change it using the [[Hard_Drive_Partition_Scheme|hard drive partition scheme]] documentation as a guide.  Once complete, choose ''Done''
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS7-Install-Disk.PNG|600px]]
 +
</div><br></li>
 +
<li>You will now see '''SUMMARY OF CHANGES''' to the disk drive.  Choose ''Accept Changes''
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS8-Install-Disk.PNG|600px]]
 +
</div><br></li>
 +
</ul>
  
 +
== Software Selection ==
 +
<ul>
 +
<li>Next on the '''INSTALLATION SUMMARY''', select ''SOFTWARE SELECTION''
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS9a-Install.PNG|600px]]
 +
</div><br></li>
 +
<li>Scroll down and select ''Minimal Install'' and then choose ''Done''
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS10a-Install.PNG|600px]]
 +
</div><br></li>
 +
</ul>
 +
== Begin Installation ==
 +
<ul>
 +
<li>Back to the '''INSTALLATION SUMMARY''' and ready to begin installation.  Select ''Begin Installation''
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS11a-Install.PNG|600px]]
 +
</div><br></li>
 +
</ul>
 +
== Root Password/User Creation ==
 +
<ul>
 +
<li>Installation has begun, but we need to configure the users.  You '''MUST''' set the ''root'' password.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS10-User.PNG|600px]]
 +
</div><br></li>
 +
<li>Enter the desired password and choose ''Done''.  You may have to select ''Done'' twice if your password is weak.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS11-Root.PNG|600px]]
 +
</div><br></li>
 +
<li>You '''MUST''' create the initial user and password (This will be your HDA Login, also called the First Admin User). Ensure you select ''Make this user administrator'' check box. Once complete, choose ''Done''.  Just as in the previous step, a weak password may require you to select ''Done'' twice.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS12-User.PNG|600px]]
 +
</div><br></li>
 +
</ul>
 +
== Installation Progress ==
 +
<ul>
 +
<li>Now all of the configuration steps are complete.  Sit back and watch the progress.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
[[File:SS13-Install.PNG|600px]]
 +
</div><br></li>
 +
</ul>
 +
== Installation Complete ==
 +
<ul>
 +
<li>Installation is complete.  Choose ''Reboot'' and remove the installation media.
 +
<div class="mw-collapsible mw-collapsed" style="width:400px">
 +
:[[File:SS14-Finished.PNG|600px]]
 +
</div><br></li>
 +
</ul>
  
First, download the Fedora 21 Server DVD for 64 bit (1.91GB), preferably using torrents
+
== Post Install ==
  
* Torrents:
+
'''NOTE: This is only for advanced users that every need to use SSH to remotely connect to the command line in Linux.'''
** Primary: [https://torrent.fedoraproject.org/torrents/Fedora-Server-DVD-x86_64-21.torrent Fedora 21 Server 64-bit] (torrent)
 
** Alternate: [http://dl.amahi.org/isos/Fedora-Server-DVD-x86_64-21.torrent Fedora 21 Server 64-bit] (torrent)
 
  
* Direct http download:
+
Due to Fedora 21 upstream updates, please execute the steps below from the console prior to installing Amahi 8:
** Primary: [https://admin.fedoraproject.org/mirrormanager/mirrors/Fedora/21/x86_64 Fedora 21 Server 64-bit] (http)
 
** Alternate: [http://dl.amahi.org/isos/Fedora-Server-DVD-x86_64-21.iso Fedora 21 Server 64-bit] (http)
 
  
= Install =
 
== Fedora ==
 
* Boot, choose Install Fedora, choose language
 
* Choose the [[Hard_Drive_Partition_Scheme|hard drive partitioning scheme]]
 
* This is important. '''ONLY''' select one drive, and avoid LVM
 
* '''DON'T''' change the hostname (it may create issues)
 
* Click on ''Begin Installation'' and the installer will proceed
 
* Create a user with a password. Make sure it's an admin user. Recommend creating a root password.
 
* Once install completes, don't forget to remove the DVD after installing and before rebooting.
 
* Upon reboot, login with the user and become root for the Amahi installation
 
 
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
 
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
  sudo su -
+
su -
 +
chmod 600 /etc/ssh/ssh_host_ecdsa_key
 +
chmod 600 /etc/ssh/ssh_host_ed25519_key
 +
chmod 600 /etc/ssh/ssh_host_rsa_key
 +
systemctl restart sshd
 
</div>
 
</div>
  
== Install Amahi 8 ==
+
 
 +
Ref:  [https://bugs.amahi.org/issues/1871 Amahi Bug #1871]
 +
 
 +
= Install Amahi 8 =
 +
 
 
Next, install Amahi 8 proper on top of Fedora 21.
 
Next, install Amahi 8 proper on top of Fedora 21.
  
 
You need to obtain an install code (denoted YOUR-INSTALL-CODE below) from the [https://www.amahi.org/users Amahi control panel] after configuring a profile for the system you are installing, with '''proper network configuration''' for your network.
 
You need to obtain an install code (denoted YOUR-INSTALL-CODE below) from the [https://www.amahi.org/users Amahi control panel] after configuring a profile for the system you are installing, with '''proper network configuration''' for your network.
 +
 +
From text console or using SSH, login with the user created in the Fedora 21 installation and become ''root'' for the Amahi installation<br />
 +
 +
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
 +
  su -
 +
</div>
  
 
After that, type these commands in the console:
 
After that, type these commands in the console:
  
 +
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
 
   <nowiki>rpm -Uvh http://f21.amahi.org/noarch/hda-release-6.9.0-1.noarch.rpm</nowiki>
 
   <nowiki>rpm -Uvh http://f21.amahi.org/noarch/hda-release-6.9.0-1.noarch.rpm</nowiki>
 
   yum -y install mariadb-libs mariadb-server
 
   yum -y install mariadb-libs mariadb-server
 +
  yum -y install rsyslog avahi
 
   yum -y install hda-ctl hda-platform
 
   yum -y install hda-ctl hda-platform
 
   hda-install YOUR-INSTALL-CODE
 
   hda-install YOUR-INSTALL-CODE
 +
</div>
 +
What this does is this: Installs the Amahi F21 repo, gets the mariadb base packages to avoid dependency conflicts, and installs base Amahi packages (that part should install several packages).
 +
 +
If there are no errors, install Amahi (replace ''YOUR-INSTALL-CODE'' above with install code you got when creating a profile at [https://www.amahi.org/users your Amahi control panel]).
 +
 +
If all goes well, it should tell you to reboot. Go ahead and reboot!
 +
 +
Once it comes back from the reboot, you should have a fully functional home server using the IP address you set up in your network!
 +
 +
Next you need to transition your network to use it!
 +
 +
= Transitioning to your Amahi server =
  
What this does is this: Installs the Amahi F21 repo, gets the mariadb base packages to avoid dependency conflicts, installs base Amahi packages (that part should install several packages).
+
Once installed, you will want to transition your network to using your Amahi server. Here are some of the things you should know:
  
If there are no errors, install Amahi (replace ''YOUR-INSTALL-CODE'' above with install code from the [https://www.amahi.org/users your Amahi control pane]).
+
* Your server will boot with the static IP you pre-configured in the Amahi control panel
 +
* This is a headless server, therefore it will boot to a text console.  There is no desktop user interface.
 +
* It's strongly recommended you follow the [[transition to Amahi]] HDA guide to get your network fully working properly
 +
* You can verify if the dashboard is available by accessing it from any client using the IP address of your server '''<nowiki>http://IPADDRESS/</nowiki>''' or '''<nowiki>http://hda/</nowiki>''' (in most Windows clients this works even without DNS from your HDA)
 +
* The first time it will initialize, ask you to login, and enter a dashboard password. This is the First Admin User created earlier in the Fedora 21 installation.
 +
* Once you reach your [[Setup|dashboard]], you should [[Storage_and_file_sharing|create shares]] as needed, [[Adding_a_second_hard_drive_to_your_HDA|add more drives]], install apps, etc., etc.
 +
* Optionally refer to [[Greyhole#Amahi_7.2F8|Greyhole]] to install/configure storage pooling.
  
If all goes well, it should tell you to reboot!
+
= Troubleshooting =
  
Once it comes back, you should have a fully functional home server. Next you need to transition your network to use it!
+
Visit the [[troubleshooting]] page if you find yourself in trouble.
  
= Expectations =
+
= Reference =
* It will boot with the static IP you pre-configured in the Amahi control panel
+
Refer to the [[HDA Admin How To]] page for Amahi Server administrator guidance.
* You can verify if the dashboard is available by accessing from any client using the IP address of your server '''<nowiki>http://IPADDRESS/</nowiki>''' or '''<nowiki>http://hda/</nowiki>''' (in some windows clients)
 
* It's strongly recommended that you turn off the previous DHCP server and let Amahi handle DHCP so that DNS falls into place
 
* Reboot all the clients (or turn off network and turn it back on) to get them to use DHCP leases from your Amahi server
 
* Your Amahi dashboard should be available at '''<nowiki>http://hda</nowiki>'''
 
* The first time it will initialize, ask you to login, and enter a dashboard password for the admin user created earlier
 
* Optionaly refer to [[Greyhole#Amahi_7|Greyhole]] to install/configure storage pooling.
 

Latest revision as of 03:05, 12 November 2018

Warning.png WARNING
Amahi 8 for Fedora 21
Maintenance Support ONLY!

Please use a supported release!


NOTES:

  • Ensure your system meets the minimum hardware requirements for Amahi before proceeding.
  • 32-bit installs are not available nor supported in Amahi 8.
  • NOT ALL apps available in Amahi 7 are fully operational for Amahi 8. Check the App Store before proceeding.
  • You must install Fedora 21 Server prior to installing Amahi 8.


For assistance, visit the Amahi Forums or live support on the Amahi IRC channel.

Install Fedora 21

There are two ways to install Fedora: Minimal (CD), so-called Netinstall, which is recommended, and the Full (DVD) install for cases that need additional hardware support.

We recommend this method for a quick download and fast installation.

  • Burn the ISO to CD (DVD or USB), insert the media into your server, and reboot the system.
  • These instructions below will guide you through the Fedora 21 Netinstall CD installation with screen shots and commentary. Click [Expand] to show a screen shot and [Collapse] to hide it.

Boot Screen

  • Select Install Fedora-Server 21

    SS0-Boot.PNG


Language Selection

  • Choose desired language and select Continue
    SS1-Language.PNG

Installation Summary

  • The INSTALLATION SUMMARY screen will appear. It may take a few minutes to finish Checking software dependencies

    SS2a-Install.PNG


  • Change the KEYBOARD or TIME & DATE to match your locale if needed.

  • Once complete, next choose INSTALLATION DESTINATION. This is where you will select the disk drive to use.

    SS3a-Install-Disk.PNG


Disk Drive Setup

  • Choose the disk drive you want to use for the Fedora installation. If you have more than one disk drive connected, DO NOT select them at this time. You will notice a check mark on the disk drive selected. Select I will configure partitioning and then choose Done.

    SS5-Install-Disk.PNG


  • Should you have existing partitions on the disk drive you will be using for the Fedora 23 installation, they will have to be removed.
    • You should see the existing partition about half way down the screen.

      DSS1.PNG


    • Choose it to expand and display the existing partitions for deletion. Select the first partition in the list followed by the minus (-) sign.

      DSS2.PNG


    • When prompted Are you sure you want to delete all the data on ..., choose Delete It.

      DSS3.PNG


    • Repeat the previous two steps until all the existing partitions on the disk drive are gone.

  • Ensure the New mount points will use the following partitioning scheme: is changed to reflect Standard partition. Then select Click here to create them automatically. We STRONGLY advise against use of LVM or setting a /home partition.

    SS6-Install-Disk.PNG


  • The disk drive partition should look similar to this setup. For most users, then default partitioning scheme used will suffice. However, you can manually change it using the hard drive partition scheme documentation as a guide. Once complete, choose Done

    SS7-Install-Disk.PNG


  • You will now see SUMMARY OF CHANGES to the disk drive. Choose Accept Changes

    SS8-Install-Disk.PNG


Software Selection

  • Next on the INSTALLATION SUMMARY, select SOFTWARE SELECTION

    SS9a-Install.PNG


  • Scroll down and select Minimal Install and then choose Done

    SS10a-Install.PNG


Begin Installation

  • Back to the INSTALLATION SUMMARY and ready to begin installation. Select Begin Installation

    SS11a-Install.PNG


Root Password/User Creation

  • Installation has begun, but we need to configure the users. You MUST set the root password.

    SS10-User.PNG


  • Enter the desired password and choose Done. You may have to select Done twice if your password is weak.

    SS11-Root.PNG


  • You MUST create the initial user and password (This will be your HDA Login, also called the First Admin User). Ensure you select Make this user administrator check box. Once complete, choose Done. Just as in the previous step, a weak password may require you to select Done twice.

    SS12-User.PNG


Installation Progress

  • Now all of the configuration steps are complete. Sit back and watch the progress.

    SS13-Install.PNG


Installation Complete

  • Installation is complete. Choose Reboot and remove the installation media.
    SS14-Finished.PNG

Post Install

NOTE: This is only for advanced users that every need to use SSH to remotely connect to the command line in Linux.

Due to Fedora 21 upstream updates, please execute the steps below from the console prior to installing Amahi 8:

su -
chmod 600 /etc/ssh/ssh_host_ecdsa_key
chmod 600 /etc/ssh/ssh_host_ed25519_key
chmod 600 /etc/ssh/ssh_host_rsa_key
systemctl restart sshd


Ref: Amahi Bug #1871

Install Amahi 8

Next, install Amahi 8 proper on top of Fedora 21.

You need to obtain an install code (denoted YOUR-INSTALL-CODE below) from the Amahi control panel after configuring a profile for the system you are installing, with proper network configuration for your network.

From text console or using SSH, login with the user created in the Fedora 21 installation and become root for the Amahi installation

 su -

After that, type these commands in the console:

  rpm -Uvh http://f21.amahi.org/noarch/hda-release-6.9.0-1.noarch.rpm
  yum -y install mariadb-libs mariadb-server
  yum -y install rsyslog avahi
  yum -y install hda-ctl hda-platform
  hda-install YOUR-INSTALL-CODE

What this does is this: Installs the Amahi F21 repo, gets the mariadb base packages to avoid dependency conflicts, and installs base Amahi packages (that part should install several packages).

If there are no errors, install Amahi (replace YOUR-INSTALL-CODE above with install code you got when creating a profile at your Amahi control panel).

If all goes well, it should tell you to reboot. Go ahead and reboot!

Once it comes back from the reboot, you should have a fully functional home server using the IP address you set up in your network!

Next you need to transition your network to use it!

Transitioning to your Amahi server

Once installed, you will want to transition your network to using your Amahi server. Here are some of the things you should know:

  • Your server will boot with the static IP you pre-configured in the Amahi control panel
  • This is a headless server, therefore it will boot to a text console. There is no desktop user interface.
  • It's strongly recommended you follow the transition to Amahi HDA guide to get your network fully working properly
  • You can verify if the dashboard is available by accessing it from any client using the IP address of your server http://IPADDRESS/ or http://hda/ (in most Windows clients this works even without DNS from your HDA)
  • The first time it will initialize, ask you to login, and enter a dashboard password. This is the First Admin User created earlier in the Fedora 21 installation.
  • Once you reach your dashboard, you should create shares as needed, add more drives, install apps, etc., etc.
  • Optionally refer to Greyhole to install/configure storage pooling.

Troubleshooting

Visit the troubleshooting page if you find yourself in trouble.

Reference

Refer to the HDA Admin How To page for Amahi Server administrator guidance.