Difference between revisions of "Amahi 9 Install"

From Amahi Wiki
Jump to: navigation, search
 
(51 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{MessageBox|backgroundcolor = #FBB|
+
{{MessageBox|
 +
backgroundcolor = #faa|
 
image =Warning.png|
 
image =Warning.png|
 
heading =WARNING|
 
heading =WARNING|
message = This is the Development page for Amahi 9 on Fedora 23. <br />It '''IS NOT''' production ready.}}
+
message = Amahi 9 for Fedora 23<br />Maintenance Support ONLY!
 +
Please use a supported release!<br />}}
 
__TOC__
 
__TOC__
 +
  
 
'''NOTES:'''
 
'''NOTES:'''
 
* The only '''officially supported''' install media is Fedora 23 Server.
 
* The only '''officially supported''' install media is Fedora 23 Server.
* Ensure your system meets the [[Requirements|minimum hardware requirements]] for Amahi before proceeding.  
+
* 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 9.
 
* 32-bit installs '''are not''' available nor supported in Amahi 9.
* '''NOT ALL''' apps available in Amahi 8 are fully operational for Amahi 9.  Check the [https://www.amahi.org/apps App Store] before proceeding.
+
* '''NOT ALL''' apps in previous Amahi versions are available for Amahi 9.  Check the [https://www.amahi.org/apps App Store] before proceeding.
 
* You must install Fedora 23 Server prior to installing Amahi 9.
 
* You must install Fedora 23 Server prior to installing Amahi 9.
  
Line 15: Line 18:
 
For assistance, visit the [https://forums.amahi.org Amahi Forums] or live support on the [http://talk.amahi.org Amahi IRC channel].
 
For assistance, visit the [https://forums.amahi.org Amahi Forums] or live support on the [http://talk.amahi.org Amahi IRC channel].
  
= Install Fedora 23 =
+
= Install Fedora 23=
 
+
There are two ways to install Fedora: Minimal (CD), so-called Netinstall, which is recommended, and the [[Fedora_23_Server_Install|Full (DVD) install]] for cases that need additional hardware support.
There are two ways to install Fedora: Minimal (CD), so-called Netinstall, which is recommended, and the Full (DVD) install for cases that need more hardware support.
 
 
 
== Minimal (CD) Install ==
 
  
 
We recommend this method for a quick download and fast installation.
 
We recommend this method for a quick download and fast installation.
  
Download the Fedora 23 Netinstall CD for 64 bit (415MB).
+
* Download the Fedora 23 Netinstall CD for 64 bit (415MB).
 +
** Primary:  [http://download.fedoraproject.org/pub/fedora/linux/releases/23/Server/x86_64/iso/Fedora-Server-netinst-x86_64-23.iso Fedora 23 Netinstall 64-bit]
 +
** Alternate:  [https://dl.fedoraproject.org/pub/fedora/linux/releases/23/Server/x86_64/iso/Fedora-Server-netinst-x86_64-23.iso Fedora 23 Netinstall 64-bit]
  
* [http://download.fedoraproject.org/pub/fedora/linux/releases/23/Server/x86_64/iso/Fedora-Server-netinst-x86_64-23.iso Fedora 23 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 23 Netinstall CD installation with screen shots and commentary.  If you are not an advanced Linux user and know what you are doing, recommend you '''DO NOT''' deviate from the guidance.  Click '''[Expand]''' to show a screen shot and '''[Collapse]''' to hide it.
  
Burn the ISO to CD (or DVD), insert the media into your server, and reboot the system.
+
==Boot Screen==
<ul>
 
<li>These instructions below will guide you through the Fedora 23 Netinstall CD installation with screen shots and commentary.  Click '''[Expand]''' to show and '''[Collapse]''' to hide.<div class="mw-collapsible mw-collapsed"><br>
 
:'''NOTE:'''  Click '''[Expand]''' to show a screen shot and '''[Collapse]''' to hide it.<br>
 
Boot Screen
 
 
<ul>
 
<ul>
 
<li>Select ''Install Fedora 23''
 
<li>Select ''Install Fedora 23''
Line 40: Line 39:
 
</ul>
 
</ul>
  
Language Selection
+
==Language Selection==
 
<ul>
 
<ul>
 
<li>Choose desired language and select ''Continue''
 
<li>Choose desired language and select ''Continue''
Line 48: Line 47:
 
</ul>
 
</ul>
  
Installation Summary
+
==Installation Summary==
 
<ul>
 
<ul>
 
<li>The '''INSTALLATION SUMMARY''' screen will appear. It may take a few minutes to finish ''Checking software dependencies''
 
<li>The '''INSTALLATION SUMMARY''' screen will appear. It may take a few minutes to finish ''Checking software dependencies''
Line 54: Line 53:
 
[[file:F23CD_SS2A.PNG|600px]]   
 
[[file:F23CD_SS2A.PNG|600px]]   
 
</div><br></li>
 
</div><br></li>
</ul>
+
<li>Change the '''KEYBOARD''' or '''TIME & DATE''' to match your locale if needed.</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.
 
<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">
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
[[file:F23CD_SS2B.PNG|600px]]   
 
[[file:F23CD_SS2B.PNG|600px]]   
 
</div><br></li>
 
</div><br></li>
 +
<li> Verify '''NETWORK & HOST NAME''' indicates ''connected''.  Don't make any changes unless you are sure of what you are doing.</li> 
 
</ul>
 
</ul>
  
Disk Drive Setup
+
==Disk Drive Setup==
 +
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #FFB6C1; margin: 3px 3px 1em 3px;">'''WARNING:'''  Amahi staff doesn't recommend using the default ''LVM'' partition scheme.  Doing so will dedicate most of the drive space in the system to the ''/home'' partition.  Amahi does not utilize this space, limiting storage for file shares and web applications.  For best results and maximum storage, use the ''Standard'' partition scheme.</div>
 +
 
 
<ul>
 
<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''.
 
<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''.
Line 70: Line 69:
 
[[file:F23CD_SS3.PNG|600px]]   
 
[[file:F23CD_SS3.PNG|600px]]   
 
</div><br></li>
 
</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>
 
<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>
 
<ul>
Line 76: Line 74:
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
[[file:F23CD_SS3A.PNG|250px]]   
 
[[file:F23CD_SS3A.PNG|250px]]   
</div></li><br>
+
</div><br></li>
 
 
 
<li>Choose it to expand and display the existing partitions for deletion.  Select the first partition in the list followed by the minus (-) sign.
 
<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">
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
[[file:F23CD_SS3C.PNG|250px]]   
 
[[file:F23CD_SS3C.PNG|250px]]   
</div></li><br>
+
</div><br></li>
 
 
 
<li> When prompted Are you sure you want to delete all the data on ..., choose Delete It.
 
<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">
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
[[file:F23CD_SS3B.PNG|400px]]   
 
[[file:F23CD_SS3B.PNG|400px]]   
</div></li><br>
+
</div><br></li>
 
+
<li> Repeat the previous two steps until all the existing partitions on the disk drive are gone.</li>
<li> Repeat the previous two steps until all the existing partitions on the disk drive are gone.</li><br>
 
 
</ul>
 
</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''.
<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">
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
[[file:F23CD_SS4.PNG|600px]]   
 
[[file:F23CD_SS4.PNG|600px]]   
 
</div><br></li>
 
</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 documentation as a guide. Once complete, choose ''Done''
 
<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 documentation as a guide. Once complete, choose ''Done''
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
[[file:F23CD_SS5.PNG|600px]]   
 
[[file:F23CD_SS5.PNG|600px]]   
 
</div><br></li>
 
</div><br></li>
 
 
<li>You will now see '''SUMMARY OF CHANGES''' to the disk drive. Choose ''Accept Changes''
 
<li>You will now see '''SUMMARY OF CHANGES''' to the disk drive. Choose ''Accept Changes''
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
Line 107: Line 99:
 
</ul>
 
</ul>
  
Software Selection
+
==Software Selection==
 
<ul>
 
<ul>
 
<li>Next on the '''INSTALLATION SUMMARY''', select ''SOFTWARE SELECTION''
 
<li>Next on the '''INSTALLATION SUMMARY''', select ''SOFTWARE SELECTION''
Line 120: Line 112:
 
</ul>
 
</ul>
  
Begin Installation
+
==Begin Installation==
 
<ul>
 
<ul>
<li>Back to the '''INSTALLATION SUMMAR'''Y and ready to begin installation. Select ''Begin Installation''
+
<li>Back to the '''INSTALLATION SUMMARY''' and ready to begin installation. Select ''Begin Installation''
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
[[file:F23CD_SS7.PNG|600px]]   
 
[[file:F23CD_SS7.PNG|600px]]   
Line 128: Line 120:
 
</ul>
 
</ul>
  
Initial User Creation
+
==Initial User Creation==
 
<ul>
 
<ul>
 
<li>Installation has begun and we need to create the initial user. '''DO NOT''' set the root password.
 
<li>Installation has begun and we need to create the initial user. '''DO NOT''' set the root password.
Line 141: Line 133:
 
</ul>
 
</ul>
  
Installation Progress
+
==Installation Progress==
 
<ul>
 
<ul>
 
<li>Now all of the configuration steps are complete. Sit back and watch the progress.
 
<li>Now all of the configuration steps are complete. Sit back and watch the progress.
Line 149: Line 141:
 
</ul>
 
</ul>
  
Installation Complete
+
==Installation Complete==
 
<ul>
 
<ul>
 
<li>Installation is complete. Choose ''Reboot'' and remove the installation media.
 
<li>Installation is complete. Choose ''Reboot'' and remove the installation media.
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
<div class="mw-collapsible mw-collapsed" style="width:400px">
 
[[file:F23CD SS13.PNG|600px]]   
 
[[file:F23CD SS13.PNG|600px]]   
</div><br></li>
+
</div><br></li></ul>
</ul>
+
 
</ul>
+
= Install Amahi 9 =
 +
 
 +
Next, we will install Amahi 9 proper on top of Fedora 23.
 +
 
 +
When you reboot you will see a black screen with no graphics and a "localhost login" text prompt. Login into that that console directly with the user you created in the Fedora 23 installation. (You can also use SSH to login remotely from a client if you know how.)
 +
 
 +
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 (logged in with the user created in the Fedora 23 installation), become ''root'' for the Amahi installation.  When prompted for a password, it's your user password you set in the Fedora 23 install.<br />
 +
 
 +
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left">
 +
  sudo su -
 +
</div>
 +
 
 +
After that, type these three separate commands (one per line) 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://f23.amahi.org/noarch/hda-release-6.9.0-1.noarch.rpm</nowiki>
 +
  dnf -y install hda-ctl
 +
  hda-install YOUR-INSTALL-CODE
 +
</div>
  
== Full (DVD) Install ==
+
What this does is installs the Amahi F23 repo, gets the mariadb base packages to avoid dependency conflicts, and installs base Amahi packages (that part should install several packages).
  
This is only recommended for cases where the [[Amahi_9_Install#Minimal_.28CD.29_Install|Minimal (CD) Install]] does not work well (e.g. if your hardware needs extra drivers).
+
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]).
  
Download the Fedora 23 Server DVD for 64 bit (2.0 GB), preferably using torrents
+
If all goes well, it should tell you to reboot. Go ahead and reboot!
  
* [https://download.fedoraproject.org/pub/fedora/linux/releases/23/Server/x86_64/iso/Fedora-Server-DVD-x86_64-23.iso Fedora 23 Server 64-bit] (http)
+
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!
* [https://torrent.fedoraproject.org/torrents/Fedora-Server-DVD-x86_64-23.torrent Fedora 23 Server 64-bit] (torrent)
 
  
 +
Next you need to transition your network to use it!
  
Burn the ISO to DVD, insert the media into your server, reboot the system, and follow the [[Fedora 23 Server Install]] instructions.
+
= Transitioning to your Amahi server =
  
== USB Install ==
+
Once installed, you will want to transition your network to using your Amahi server. Here are some of the things you should know:
  
You may follow the [[USB Install]] guidance for USB installs using one of the ISO images above if needed.
+
* 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.
 +
* 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.
  
 
= Troubleshooting =
 
= Troubleshooting =
Line 182: Line 200:
  
  
Go back to [[Amahi 9]] page.
+
Go back to [http://docs.amahi.org Amahi Docs] page.

Latest revision as of 03:04, 12 November 2018

Warning.png WARNING
Amahi 9 for Fedora 23
Maintenance Support ONLY!

Please use a supported release!



NOTES:

  • The only officially supported install media is Fedora 23 Server.
  • Ensure your system meets the minimum hardware requirements for Amahi before proceeding.
  • 32-bit installs are not available nor supported in Amahi 9.
  • NOT ALL apps in previous Amahi versions are available for Amahi 9. Check the App Store before proceeding.
  • You must install Fedora 23 Server prior to installing Amahi 9.


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

Install Fedora 23

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 23 Netinstall CD installation with screen shots and commentary. If you are not an advanced Linux user and know what you are doing, recommend you DO NOT deviate from the guidance. Click [Expand] to show a screen shot and [Collapse] to hide it.

Boot Screen

  • Select Install Fedora 23

    F23CD SS0.PNG


Language Selection

  • Choose desired language and select Continue

    F23CD SS1.PNG


Installation Summary

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

    F23CD SS2A.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.

    F23CD SS2B.PNG


  • Verify NETWORK & HOST NAME indicates connected. Don't make any changes unless you are sure of what you are doing.

Disk Drive Setup

WARNING: Amahi staff doesn't recommend using the default LVM partition scheme. Doing so will dedicate most of the drive space in the system to the /home partition. Amahi does not utilize this space, limiting storage for file shares and web applications. For best results and maximum storage, use the Standard partition scheme.
  • 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.

    F23CD SS3.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.

      F23CD SS3A.PNG


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

      F23CD SS3C.PNG


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

      F23CD SS3B.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.

    F23CD SS4.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

    F23CD SS5.PNG


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

    F23CD SS3D.PNG


Software Selection

  • Next on the INSTALLATION SUMMARY, select SOFTWARE SELECTION

    F23CD SS12.PNG


  • Select Minimal Install and then choose Done

    F23CD SS6.PNG


Begin Installation

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

    F23CD SS7.PNG


Initial User Creation

  • Installation has begun and we need to create the initial user. DO NOT set the root password.

    F23CD SS8A.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. Note that a weak password may require you to select Done twice.

    F23CD SS10.PNG


Installation Progress

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

    F23CD SS11.PNG


Installation Complete

  • Installation is complete. Choose Reboot and remove the installation media.

    F23CD SS13.PNG


Install Amahi 9

Next, we will install Amahi 9 proper on top of Fedora 23.

When you reboot you will see a black screen with no graphics and a "localhost login" text prompt. Login into that that console directly with the user you created in the Fedora 23 installation. (You can also use SSH to login remotely from a client if you know how.)

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 (logged in with the user created in the Fedora 23 installation), become root for the Amahi installation. When prompted for a password, it's your user password you set in the Fedora 23 install.

 sudo su -

After that, type these three separate commands (one per line) in the console:

  rpm -Uvh http://f23.amahi.org/noarch/hda-release-6.9.0-1.noarch.rpm
  dnf -y install hda-ctl
  hda-install YOUR-INSTALL-CODE

What this does is installs the Amahi F23 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.
  • 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.


Go back to Amahi Docs page.