Configuration Tutorial

From Unraid | Docs
Jump to: navigation, search
(Created page with '<br> == Instructions == <br> This guide is intended to get you from a completed and working flash drive to a usable array. Note: written for version 4.56 Note: These instruc...')
 
Line 110: Line 110:
 
** Recommend leaving this as yes.
 
** Recommend leaving this as yes.
 
** Good information available [http://lime-technology.com/forum/index.php?topic=4782.0;wap2 here].
 
** Good information available [http://lime-technology.com/forum/index.php?topic=4782.0;wap2 here].
 +
If you made any changes here, click Apply.  At this point it is recommended that you reboot the server.  To do so, click Main then click the reboot button to restart the server.
 +
 +
== Install UnMENU and Screen ==
 +
The next step is to install [[UnRAID_Add_Ons#UnMENU|UnMENU]] and screen to allow preclearing the hard drives remotely without leaving a telnet connection open.  You should have already copied the required files to your flash drive earlier.  For this step your server must have access to the internet to download some files.  It is '''NOT''' recommended that you connect your UnRAID server directly to the internet (especially at this stage) as it is not secure.
 +
<br><br>
 +
'''Step 1''' Using a telnet client establish a connection to your UnRAID server and login as root.
 +
'''Step 2''' At the prompt type
 +
cd /boot/unmenu
 +
'''Step 3''' At the prompt type
 +
./unmenu_install  -i -d /boot/unmenu
 +
The script will download the files needed and place them in the appropriate location.
 +
<br><br>
 +
'''Step 4''' To start UnMENU, at the prompt type
 +
./uu
 +
You will be dumped right back to a prompt, this is normal.
 +
<br><br>
 +
'''Step 5''' To enable UnMENU to run on reboot, at the prompt type
 +
echo "/boot/unmenu/uu" >> /boot/config/go
 +
'''Step 6''' Now, leave the telnet session open and open a web browser and navigate to
 +
//tower:8080
 +
''Substitute your server's name or IP address for tower.''
 +
<br><br>
 +
'''Step 7''' At the top of the screen select ''Pkg Manager''.
 +
<br>
 +
'''Step 8''' Scroll down (close to the bottom) and click ''Select screen-4.03-i486-1.tgz''.
 +
<br>
 +
'''Step 9''' Click ''Download screen-4.03-i486-1.tgz''.  The status will change to "Package downloaded, but not yet installed".
 +
<br>
 +
'''Step 10''' Click ''Install screen-4.03-i486-1.tgz''.  You will see a report of the commands run and the status will change to "screen-4.0.3-i486-1.tgz is now installed".
 +
<br>
 +
'''Step 11''' Click ''Enable Re-Install on Re-Boot'' so screen will be started on every reboot.
 +
<br>
 +
== Preclear Hard Drives ==
 +
== Add Drives to the Array ==
 +
== Create User Sharese ==
 +
== Copy Files to the Array ==
 +
== Users and Security ==

Revision as of 01:07, 28 October 2010


Instructions


This guide is intended to get you from a completed and working flash drive to a usable array.

Note: written for version 4.56
Note:  These instructions assume the use of a Windows computer,
but if you don't have access to one, the instructions are basically 
the same for Linux or Unix-based operating systems.

Pre Boot

Before booting your unRAID system you need to copy a few files to your flash drive. The preclear_disk.sh script will enable you to prep your disks for the array and the unmenu_install script will install UnMENU.

Step 1 From a non unRAID system download the preclear_disk.sh script from this forum post.

  • The download is at the bottom of the first post
  • You must be logged into the forum to see the file

Unzip the file and copy preclear_disk.sh to the root of your flash drive.

Step 2 Download the unmenu_install script from the Google Code website and unzip the file. Create a folder named unmenu in the root of your flash drive. Copy unmenu_install to the unmenu folder on your flash drive.

First Boot

Now that you have the required files on your flash drive, use it to boot your UnRAID system. When the system has been booted you will be greeted with a prompt similar to

Welcome to Linux 2.6.32.9-unRAID (tty1)
Tower login:

Type root and press enter to log into the system. The prompt should change to

root@Tower:~#

which is hereafter referred to as the prompt.

Verifying Network Connectivity

To verify that your UnRAID system is connected to the network, at the prompt type enter

ifconfig eth0

This will present quite a bit of information, however, the only line we are interested in is the one containing

inet addr:192.168.1.123

The IP address (numbers) after inet addr will almost certainly be different, but anything that has 192.168.x.x or 10.x.x.x means your UnRAID server received an IP address from a DHCP server and is connected to the network and is ready to go. If there is nothing after inet addr make sure your network cable is connected, and you have a router or other DHCP server on your network. If you do not have a DHCP server you need to set your network settings manually. Note your IP address now, you may need it shortly.

Verifying Hard Drives are Detected

Note: This section assumes all SATA hard drives!

To verify that your hard drives are detected, at the prompt type

dmesg|grep SATA|grep link

You should get a listing of each SATA controller, its link status, and its speed. The output will look similar to

ata1: SATA link up 3.0 Gbps (SStatus 123 SControl 300)
ata2: SATA link up 3.0 Gbps (SStatus 123 SControl 300)
ata3: SATA link up 3.0 Gbps (SStatus 123 SControl 300)
ata4: SATA link down (SStatus 0 SControl 300)
ata5: SATA link up 3.0 Gbps (SStatus 123 SControl 300)
ata6: SATA link up 3.0 Gbps (SStatus 123 SControl 300)

In this example there are 6 SATA controllers with 5 drives connected at 3.0 Gbps. Make sure your output matches your hardware ie if you have 5 drives connected, make sure you see 5 drives here and the link speeds are correct.

Configuration With the Server Management Utility

Now that you have verified your UnRAID server can see the network and its hard drives are connected correctly it's time to log into the web interface and continue setup.

Using another system that is connected to your network, open a web browser and in the address bar type

//tower

This should take you to the server management page. If it does not try entering

//IP_ADDRESS

where IP_ADDRESS is the IP address you noted earlier. There are more details available in the Un-official manual.

Navigate to the settings page by clicking settings in the navigation bar at the top of the server management page.

Identification

  • Server Name - This is the name that your server will be known as on the network. It must be a unique name not in use on your network.
    • Set yours to whatever makes you happy.
  • Comments - The comments entered here will show up next to the server name under My Network Places.
    • Again, whatever makes you happy.
  • Share security - this is the security model used to control access to the server.
    • Leave as Simple for now. Security will be covered later in the tutorial.
  • Workgroup - This is the Windows Workgroup your server will belong to.
    • Set this to the same name Workgroup that your Windows computers belong to.
  • Local master - If set to yes UnRAID will attempt to become the local browse master
    • Probably un-necessary on a small, single subnet network. Set to No unless you have problems browsing to your server
    • More information from Wikipedia and from Microsoft

If you have made any changes to these settings click apply. If you changed the server name and were connected to the Server Management Utility using //tower you may need to type //NEW_SERVER_NAME to re-connect.

Network Settings

  • Obtain IP ASddress Automatically - When set to yes the server will obtain an IP address from a DHCP server on the network. This has the benefit of set it and forget it but the IP address may change between reboots.
    • Set to yes unless you know you need to assign a static IP address to your server.
  • IP Address - Set a static IP address for the server. Not available unless Obtain IP Address Automatically is set to No.
    • Set as appropriate for your network.
  • Netmask - Subnet information. Not available unless Obtain IP Address Automatically is set to No.
    • Set as appropriate for your network.
  • Gateway - Default gateway/router. Not available unless Obtain IP Address Automatically is set to No.
    • Set as appropriate for your network.
  • Obtain DNS Server Address - Get DNS servers from DHCP or not.
    • If you have Obtain IP Address Automatically set to yes, you probably want this set to yes as well. If not you need to manually assign your DNS servers.
  • DNS Server 1..3 - You can assign up to 3 DNS servers for name resolution. Not available unless Obtain DNS Server Address is set to No.

If you have made any changes to these settings click apply. If you changed the IP address you will need to reconnect to your server using the new IP address. If you are using Windows and were connected using //tower (or a new name if changed) open a command prompt and type

ipconfig /flushdns

to clear the resolver cache and force the computer to re-query the network for the new name.

Date and time

  • Time zone - Sets the time zone for the server.
    • Set as appropriate for your location.
  • Use NTP - Use network time protocol to set the server time based on a remote time server.
    • Highly recommended to set this to yes.
  • NTP Server 1..3 - You can configure UnRAID to use specific time servers. These options are only available if Use NTP is set to Yes.
  • Current date & time - Set the current date and time.
    • If Use NTP is set to Yes, this is irrelevant and NTP will set everything.
    • IF you are not using NTP you need to set your time and date here in UTC time (FIX ME IF I'M WRONG!!!!!)

If you made any changes here, click Apply. One thing I noticed was that the time did not update and display correctly until after I rebooted the server so if things don't look quite right, wait until after the next reboot to panic.

Disk Settings

  • Default spin down delay - Set the amount of time without activity to wait before spinning down disks to save power.
    • Tweak as appropriate for your environment. If set to short you will find yourself waiting for disk spinups. If set to long you will waste power.
  • Force NCQ disabled - Disable native command queuing.
    • Recommend leaving this as yes.
    • Disable NCQ on all disk devices that support NCQ. This typically results in much better write throughput. A setting called "Force NCQ disabled [yes/no]" is also available in the Disk section of the Settings page of the System Management Utility to override this new behavior. That is, if this setting is 'yes', then we force NCQ off; if setting is 'no', we leave NCQ queue_depth as-is, ie, whatever linux driver sets it to. Source
  • Enable spinup groups - Allow disks to be spun up/down in appropriate groups.
    • Recommend leaving this as yes.
    • Good information available here.

If you made any changes here, click Apply. At this point it is recommended that you reboot the server. To do so, click Main then click the reboot button to restart the server.

Install UnMENU and Screen

The next step is to install UnMENU and screen to allow preclearing the hard drives remotely without leaving a telnet connection open. You should have already copied the required files to your flash drive earlier. For this step your server must have access to the internet to download some files. It is NOT recommended that you connect your UnRAID server directly to the internet (especially at this stage) as it is not secure.

Step 1 Using a telnet client establish a connection to your UnRAID server and login as root. Step 2 At the prompt type

cd /boot/unmenu

Step 3 At the prompt type

./unmenu_install  -i -d /boot/unmenu

The script will download the files needed and place them in the appropriate location.

Step 4 To start UnMENU, at the prompt type

./uu

You will be dumped right back to a prompt, this is normal.

Step 5 To enable UnMENU to run on reboot, at the prompt type

echo "/boot/unmenu/uu" >> /boot/config/go

Step 6 Now, leave the telnet session open and open a web browser and navigate to

//tower:8080

Substitute your server's name or IP address for tower.

Step 7 At the top of the screen select Pkg Manager.
Step 8 Scroll down (close to the bottom) and click Select screen-4.03-i486-1.tgz.
Step 9 Click Download screen-4.03-i486-1.tgz. The status will change to "Package downloaded, but not yet installed".
Step 10 Click Install screen-4.03-i486-1.tgz. You will see a report of the commands run and the status will change to "screen-4.0.3-i486-1.tgz is now installed".
Step 11 Click Enable Re-Install on Re-Boot so screen will be started on every reboot.

Preclear Hard Drives

Add Drives to the Array

Create User Sharese

Copy Files to the Array

Users and Security