Difference between revisions of "Getting started"

From NAS-Central Buffalo - The Linkstation Wiki
Jump to: navigation, search
(Installing an Operating System: no more ubuntu)
 
(47 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
{{Articles|Kurobox}}
 
==Setting up the Kurobox==
 
==Setting up the Kurobox==
 
===Mounting the Hard Drive===
 
===Mounting the Hard Drive===
 
First of all, take a look at the manual that came with your Kurobox, in order to mount your hard drive into it. If yours came with Japanese instructions, the [http://www.kurobox.com/downloads/KuroBoxSG.pdf English version of the manual] is also available. If you have a Kurobox HG WR, the instructions shall be slightly different, but there is no known English manual for the Kurobox HG WR.
 
First of all, take a look at the manual that came with your Kurobox, in order to mount your hard drive into it. If yours came with Japanese instructions, the [http://www.kurobox.com/downloads/KuroBoxSG.pdf English version of the manual] is also available. If you have a Kurobox HG WR, the instructions shall be slightly different, but there is no known English manual for the Kurobox HG WR.
 +
 +
===Changing the boot loader===
 +
While using the manufactuer's bootloader, the Kurobox boots off a proprietary / unknown bootcode, and then loads a stationary kernel, fixed on the flash ROM. This kernel is pre-configured to load a root file system on the hard drive (hda).
 +
 +
By installing U-boot, an open source bootloader, you are able to easily get to the EM mode (EMergency Mode), using a well known rootfs that you can use to mount your hard disk and fix things. You simply press a button during the boot time to choose from available boot options. U-boot is also extremely flexible allowing the owner of the box to determine how to boot their box and what parameters to pass. By using the latest U-boot, you also get support for 2.6.2x kernels, with support for .dtb files, what gives improved portability, allowing the use of multiplataform kernels. For instructions on how to install the latest U-boot, see [[Kurobox support in stock 2.6 kernels]].
 +
 +
===Changing the EM mode===
 +
The Kurobox has am embedded linux image in it that can be used to repair and setup the boxes. The EM mode that ships with Kurobox uses a very old kernel, and that imposes some limitations. The Foonas-em bootloader uses a 2.6 kernel and lots of other gooodies for your Kurobox. See how to install it here : http://foonas.org/index.php/Foonas-em
  
 
===Installing an Operating System===
 
===Installing an Operating System===
 
You have several operating system options for your Kurobox. For a fast start, you can try to run the installer on the CD that came with your Kurobox. That should partition your hard drive and install Revolution's standard OS on it. Note that this install program may not work, is somewhat buggy and the default interface is in Japanese.
 
You have several operating system options for your Kurobox. For a fast start, you can try to run the installer on the CD that came with your Kurobox. That should partition your hard drive and install Revolution's standard OS on it. Note that this install program may not work, is somewhat buggy and the default interface is in Japanese.
  
Note that the Kurobox needs a kernel compiled for it's specific hardware. This means that you can't simply download the PowerPC branch of some distro and use it right away. (The default PowerPC branches are usually targeted at the Apple hardware PMAC). However, the Kurobox community has alrady made images for the most popular distros, with the Kernel compiled for the Kurobox.
+
There is also the [[Kuro Auto Installer]], that will easily allow you to setup the OS on your Kurobox.
  
You can find instructions for installing these operating systems at their Home Pages, by clicking on the Project title listed under the Main Categories heading on the sidebar menu on the left side of all pages in this wiki. The main ones are [[Debian_on_the_Kurobox|Debian]], [[Fedora on the Kurobox|Fedora]], and [[Gentoo on the Kurobox|Gentoo]].
+
You can find instructions for '''manually''' installing these operating systems at their Home Pages, by clicking on the Project title listed under the Main Categories heading on the sidebar menu on the left side of all pages in this wiki. The main ones are [[Debian_on_the_Kurobox|Debian]], [[Fedora on the Kurobox|Fedora]], and [[Gentoo on the Kurobox|Gentoo]].
  
===Changing the boot loader===
+
Note that the Kurobox needs a kernel compiled for it's specific hardware. This means that you can't simply download the PowerPC branch of some distro and use it right away. (The default PowerPC branches are usually targeted at the Apple hardware PMAC). However, the community has alrady made images for the most popular distros, using a kurobox-compatible kernel.
By default, the Kurobox boots off a proprietary / unknown bootcode, and then proceeds to load a stationary kernel, fixed on the flash ROM. This kernel is pre-configured to load a root file system on the hard drive (hda).
+
  
By installing U-boot, you are able to easily get to the EM mode (EMergency Mode), using a well known rootfs that you can use to mount your hdd and fix things. You simply press a button during the boot time, to choose from available boot options. U-boot is also extremely flexible allowing the owner of the box to determine how to boot their box and what parameters to pass. By using the latest U-boot, you also get support for 2.6.2x kernels, with support for .dtb files, what gives improved portability, allowing the use of multiplataform kernels. For instructions on how to install the latest U-boot, see [[Kurobox support in stock 2.6 kernels]].
+
===Controlling Power usage and Noise===
 +
You can [[Fan Control|use a special script control the fan speed]] setting to high when the HD is too hot, and slowing the fan down when it no longer needs cooling.
 +
 
 +
You can use hdparm to [[Debian hdd spindown|set your HD to sleep after inactivity]], saving power and making less noise.
  
 
===Making the Power Button and LEDs work===
 
===Making the Power Button and LEDs work===
Line 20: Line 31:
 
===Installing the Web Interface===
 
===Installing the Web Interface===
 
You can administer your kurobox via the web administration interface.
 
You can administer your kurobox via the web administration interface.
 +
* http://www.kurobox.com/downloads/KuroBoxWWW.zip - for those who use the mnufacturer's OS
 +
* [[Kuro http pages for debian]]
 +
* [http://www.nas-central.org/index.php?title=Webmin_to_remotely_administer_your_LinkStation Webmin]
 +
 +
===Security/Privacy concerns===
 +
You also migh want to install PeerGuardian, a tool that automaticaly updates iptables on blacklisted ip's that are used to spy activities. Also, it's worth taking a look on [http://www.nas-central.org/index.php?title=Basic_security_procedures Basic security procedures].
  
 
==Applications==
 
==Applications==
There is no end to the applications the Kurobox can handle. With a little imagination and some research your Kuro will be doing tricks you never imagined. Here are some examples of what people are doing with their Kurobox. If you have an interesting application, feel free to add to this list.
+
When your Kurobox is properly setup, there is no end to the applications it can handle. With a little imagination and some research your Kuro will be doing tricks you never imagined. Here are some examples of what people are doing with their Kurobox. If you have an interesting application, feel free to add to this list.
  
* [[Network Attached Storage]]
+
* Wireless Access - Connect the Kurobox to a Wireless Network. You can even create a Wireless Access point for your network
* Media file server
+
* WAN Router/Gateway - Share the internet connection with all the devices on the network
* Media player
+
* DHCP Server - Easily setup client machines on the Network
* VOIP server
+
* File Server (Samba) - Share files among the Network
 +
* Printer Server ([http://www.nas-central.org/index.php?title=Printing NAS-Central Wiki - printing])
 +
* Media server - Serve media to other devices on the network such as the linktheather or the slimdevices
 +
* Media player ([[John's Suggested MP3 Player]], [http://www.kurobox.com/revolution/downloads/contest/KuroboxRCAP.txt KuroboxRCAP.txt] ) Music player that can be controled with a PDA.
 +
* Media colector/ripper ([[Kurobox Media Ripper]])
 +
* [[Web Photo Albums]]
 +
* VOIP server ([http://www.kurobox.com/forums/viewtopic.php?t=787 Asterisk ])
 
* Mail server
 
* Mail server
 
* Web server
 
* Web server
 +
* Webcam server ([http://www.nas-central.org/index.php?title=Webcam Webcam on NAS-Central])
 
* FTP server
 
* FTP server
* Network router
+
* P2P Client/Server (Bittorrent, Amule, XBT Client) ([http://www.nas-central.org/index.php?title=Mldonkey_-_multi-network_file-sharing_client Mldonkey])
* Wireless Gateway
+
* Backup Server
* P2P Client/Server (Bittorrent)
+
* PopTop ( [http://www.kurobox.com/revolution/downloads/contest/kurobox_entry_2.txt kurobox_entry_2.txt])
* Printer Server
+
* Security/Alarm System ([[Sekuro-box]])
 +
* DNS server ( [http://www.kurobox.com/forums/viewtopic.php?t=515 From the forums - 'Kuro as DNS Server?'])
 +
* IRC Client (CGI-IRC, has a web interface)
 +
* Dymanic DNS
 +
* NTP server - if you have a fixed IP address, you can [http://www.pool.ntp.org/ become a public NTP server]
 +
* Squid proxy server for your home network.
  
==Extras==
+
==Hardware Modifications==
===Setting up Dymanic DNS===
+
*[[LCDKuro]] - Adding an LCD display
This will allow you to access your kurobox from anywhere.
+
*[[Add Jtag Port]]
 +
*[[Add Serial Port]]
 +
*[[Add USB Port]]
  
 
==Getting help==
 
==Getting help==
 
It is suggested that you browse through the wiki and read through the forums for information on how to setup your Kurobox. When posting to the forums please be sure to post in the correct forum and make sure your posts have useful subjects. You will find that you get a better response to a post with the title "Need help installing Gentoo" than you will with a subject of "Need help".
 
It is suggested that you browse through the wiki and read through the forums for information on how to setup your Kurobox. When posting to the forums please be sure to post in the correct forum and make sure your posts have useful subjects. You will find that you get a better response to a post with the title "Need help installing Gentoo" than you will with a subject of "Need help".
 +
 +
==Keep updated==
 +
New stuff is always being developed at the [http://www.kurobox.com/revolution/contest.html Kurobox Contests].

Latest revision as of 22:42, 27 February 2011

Contents

Setting up the Kurobox

Mounting the Hard Drive

First of all, take a look at the manual that came with your Kurobox, in order to mount your hard drive into it. If yours came with Japanese instructions, the English version of the manual is also available. If you have a Kurobox HG WR, the instructions shall be slightly different, but there is no known English manual for the Kurobox HG WR.

Changing the boot loader

While using the manufactuer's bootloader, the Kurobox boots off a proprietary / unknown bootcode, and then loads a stationary kernel, fixed on the flash ROM. This kernel is pre-configured to load a root file system on the hard drive (hda).

By installing U-boot, an open source bootloader, you are able to easily get to the EM mode (EMergency Mode), using a well known rootfs that you can use to mount your hard disk and fix things. You simply press a button during the boot time to choose from available boot options. U-boot is also extremely flexible allowing the owner of the box to determine how to boot their box and what parameters to pass. By using the latest U-boot, you also get support for 2.6.2x kernels, with support for .dtb files, what gives improved portability, allowing the use of multiplataform kernels. For instructions on how to install the latest U-boot, see Kurobox support in stock 2.6 kernels.

Changing the EM mode

The Kurobox has am embedded linux image in it that can be used to repair and setup the boxes. The EM mode that ships with Kurobox uses a very old kernel, and that imposes some limitations. The Foonas-em bootloader uses a 2.6 kernel and lots of other gooodies for your Kurobox. See how to install it here : http://foonas.org/index.php/Foonas-em

Installing an Operating System

You have several operating system options for your Kurobox. For a fast start, you can try to run the installer on the CD that came with your Kurobox. That should partition your hard drive and install Revolution's standard OS on it. Note that this install program may not work, is somewhat buggy and the default interface is in Japanese.

There is also the Kuro Auto Installer, that will easily allow you to setup the OS on your Kurobox.

You can find instructions for manually installing these operating systems at their Home Pages, by clicking on the Project title listed under the Main Categories heading on the sidebar menu on the left side of all pages in this wiki. The main ones are Debian, Fedora, and Gentoo.

Note that the Kurobox needs a kernel compiled for it's specific hardware. This means that you can't simply download the PowerPC branch of some distro and use it right away. (The default PowerPC branches are usually targeted at the Apple hardware PMAC). However, the community has alrady made images for the most popular distros, using a kurobox-compatible kernel.

Controlling Power usage and Noise

You can use a special script control the fan speed setting to high when the HD is too hot, and slowing the fan down when it no longer needs cooling.

You can use hdparm to set your HD to sleep after inactivity, saving power and making less noise.

Making the Power Button and LEDs work

The LEDs and the Power Button, as well as the button on the back are controlled by the Embedded Microcontroller on the Kurobox. This means that you need to install a special program to monitor the power button and output the right activity to the system leds. It's recommended to install the avr_evtd.

Installing the Web Interface

You can administer your kurobox via the web administration interface.

Security/Privacy concerns

You also migh want to install PeerGuardian, a tool that automaticaly updates iptables on blacklisted ip's that are used to spy activities. Also, it's worth taking a look on Basic security procedures.

Applications

When your Kurobox is properly setup, there is no end to the applications it can handle. With a little imagination and some research your Kuro will be doing tricks you never imagined. Here are some examples of what people are doing with their Kurobox. If you have an interesting application, feel free to add to this list.

Hardware Modifications

Getting help

It is suggested that you browse through the wiki and read through the forums for information on how to setup your Kurobox. When posting to the forums please be sure to post in the correct forum and make sure your posts have useful subjects. You will find that you get a better response to a post with the title "Need help installing Gentoo" than you will with a subject of "Need help".

Keep updated

New stuff is always being developed at the Kurobox Contests.