WIP: Add OMV section

Update mkdocs material
This commit is contained in:
Gauthier Provost 2017-12-03 22:53:43 +08:00
parent 845722b446
commit a420660ad6
18 changed files with 159 additions and 47 deletions

View file

@ -2,10 +2,10 @@
### Debian Jessie ### Debian Jessie
[![Debian Jessie](/img/os/debian2.png)](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.96.img.xz)<br> [![Debian Jessie](/img/os/debian2.png)](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.102.img.xz)<br>
*Build date : 09/11/1017<br> *Build date : 29/11/1017<br>
Size : 192.2 MB<br> Size : 191.8 MB<br>
MD5SUM : ccb4f043ac74cd87e2f2ed764f25381d* MD5SUM : 1234cb83398b3a2b1aa796f607d36a7b*
### Debian Strech ### Debian Strech
@ -14,11 +14,11 @@ MD5SUM : ccb4f043ac74cd87e2f2ed764f25381d*
### OpenMediaVault ### OpenMediaVault
[![OMV](/img/os/omv.png)](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.96-OMV_3.0.91.img.xz)<br> [![OMV](/img/os/omv.png)](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.102-OMV_3.0.93.img.xz)<br>
*Build date : 09/11/1017<br> *Build date : 29/11/1017<br>
Size : 273.6 MB<br> Size : 276.6 MB<br>
MD5SUM : db76e9cfaa362b73d8840a0eacaa70c8* MD5SUM : 89456299a548003d77ff3737db5b2a86*
### Syncloud ### Syncloud
@ -29,5 +29,7 @@ MD5SUM : db76e9cfaa362b73d8840a0eacaa70c8*
Filename | Download | MD5 Filename | Download | MD5
---------|----------|---- ---------|----------|----
**Helios4_Debian_Jessie_4.4.102.img.xz**<br>Debian Jessie (Kernel 4.4.102)<br>Build date : 29/11/1017<br>Size : 191.8 MB|[Download](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.102.img.xz)|1234cb83398b3a2b1aa796f607d36a7b
**Helios4_Debian_Jessie_4.4.102-OMV_3.0.93.img.xz**<br>Debian Jessie (Kernel 4.4.102) with OMV 3.0.93<br>Build date : 29/11/1017<br>Size : 276.6 MB|[Download](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.102-OMV_3.0.93.img.xz)|89456299a548003d77ff3737db5b2a86
**Helios4_Debian_Jessie_4.4.96.img.xz**<br>Debian Jessie (Kernel 4.4.96)<br>Build date : 09/11/1017<br>Size : 192.2 MB|[Download](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.96.img.xz)|ccb4f043ac74cd87e2f2ed764f25381d **Helios4_Debian_Jessie_4.4.96.img.xz**<br>Debian Jessie (Kernel 4.4.96)<br>Build date : 09/11/1017<br>Size : 192.2 MB|[Download](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.96.img.xz)|ccb4f043ac74cd87e2f2ed764f25381d
**Helios4_Debian_Jessie_4.4.96-OMV_3.0.91.img.xz**<br>Debian Jessie (Kernel 4.4.96) with OMV 3.0.91<br>Build date : 09/11/1017<br>Size : 273.6 MB|[Download](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.96-OMV_3.0.91.img.xz)|db76e9cfaa362b73d8840a0eacaa70c8 **Helios4_Debian_Jessie_4.4.96-OMV_3.0.91.img.xz**<br>Debian Jessie (Kernel 4.4.96) with OMV 3.0.91<br>Build date : 09/11/1017<br>Size : 273.6 MB|[Download](https://cdn.kobol.io/files/Helios4_Debian_Jessie_4.4.96-OMV_3.0.91.img.xz)|db76e9cfaa362b73d8840a0eacaa70c8

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 21 KiB

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 90 KiB

After

Width:  |  Height:  |  Size: 68 KiB

BIN
docs/img/omv/disk-wipe1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

BIN
docs/img/omv/disk-wipe2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 37 KiB

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

BIN
docs/img/sd.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 407 B

View file

@ -66,6 +66,9 @@ $ dd bs=4M if=Helios4_Debian_Jessie_4.4.96.img of=/dev/sdX conv=fsync
**Now you can plug-in / power-up the AC adapter.** **Now you can plug-in / power-up the AC adapter.**
!!! warning
Always proceed with caution when manipulating 110/220V appliance.
## **Step 4** - Connect to Helios4 serial console ## **Step 4** - Connect to Helios4 serial console
### Under Windows ### Under Windows
@ -73,10 +76,10 @@ $ dd bs=4M if=Helios4_Debian_Jessie_4.4.96.img of=/dev/sdX conv=fsync
1. [Download PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) and install it on your computer. 1. [Download PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) and install it on your computer.
2. Select connection type **serial**.<br> 2. Select connection type **serial**.<br>
![Putty connect](/img/install/putty_connect.png) ![Putty connect](/img/install/putty_config.png)
3. Setup serial port settings (Serial line : **COM1** and Speed : **115200**), then press **'Open'**<br> 3. Setup serial port settings (Serial line : **COM1** and Speed : **115200**), then press **'Open'**<br>
![Putty config](/img/install/putty_config.png) ![Putty config](/img/install/putty_connect.png)
!!! note !!! note
If you computer already has a serial port then COM1 might not be the correct serial line to connect to Helios4. Check this [link](https://tnp.uservoice.com/knowledgebase/articles/172101-determining-the-com-port-of-a-usb-to-serial-adapte) to learn how to determine the right COM port. If you computer already has a serial port then COM1 might not be the correct serial line to connect to Helios4. Check this [link](https://tnp.uservoice.com/knowledgebase/articles/172101-determining-the-com-port-of-a-usb-to-serial-adapte) to learn how to determine the right COM port.

View file

@ -8,7 +8,7 @@
* 2× 70mm PWM ball bearing FAN * 2× 70mm PWM ball bearing FAN
* 4× SATA Data Cable * 4× SATA Data Cable
* 2× Molex to dual SATA Power Cable * 2× Molex to dual SATA Power Cable
* AC Adapter (12V/8A) + AC Cable * AC/DC Adapter (Input:100-240VAC 50/60Hz, Output: DC 12V/8A) + AC Cable
![Kit Assembly](/img/kit/assembly_pic1.jpg) ![Kit Assembly](/img/kit/assembly_pic1.jpg)
@ -216,7 +216,7 @@
## What to do next ? ## What to do next ?
**AWESOME !!! You have completed Helios4 Kit Assembly.** AWESOME !!! You have completed Helios4 Kit Assembly.
**Now you can jump to the [install section](/install).** **Now you can jump to the [install section](/install).**

View file

@ -1,7 +1,9 @@
!!! info !!! info
Wiki edition in progress Wiki edition in progress
## Connect to OpenMediaVault Control Panel This is a basic guide to help you setting up Helios4 NAS with [OpenMediaVault](https://www.openmediavault.org/) (**OMV**). OMV offers a large collection of features that we don't cover here. We invite you to look online for the existing OMV guides or go on the [OMV forum](https://forum.openmediavault.org/).
## Connect to OpenMediaVault (OMV) Control Panel
Open your web browser and go to the one of the following addresses : Open your web browser and go to the one of the following addresses :
@ -19,8 +21,71 @@ Open your web browser and go to the one of the following addresses :
![OMV Dashboard](/img/omv/dashboard.png) ![OMV Dashboard](/img/omv/dashboard.png)
*Dashboard View* *Dashboard View*
## Configure a RAID ## Wipe Disk (Optional)
If you are using HDD which aren't blank or brand new you might need to wipe them first before being able to setup an RAID array.
> Go to **Physical Disks** menu.
> Select an HDD and click **Wipe**.
!!! note
HDD should be device starting with **/dev/sdX**
![OMV HDD Wipe](/img/omv/disk-wipe1.png)
> Choose **Quick** wipe method.
![OMV HDD Wipe](/img/omv/disk-wipe2.png)
> Repeat this step for each HDD you want to use for your RAID array.
## Create a RAID array
In this guide we chose to create a RAID10 for the following reasons :
- A
- B
- C
You can choose to go for RAID5 or RAID6 but take in consideration that the syncing will take up to 3 times the syncing time of RAID10.
> Go to **Physical Disks** menu.
> Click **Create**.
> Select RAID level and the devices you want to be used for the RAID array.
> Give it a name and press **Create**.
![OMV RAID 10](/img/omv/create-raid10.png)
> You can see the ongoing re-syncing process and get a finish estimated time.
![OMV RAID Syncing](/img/omv/syncing-raid10.png)
!!! important
While you could carry on with some part of OMV configuration during the RAID re-syncing process, we strongly advice to let this process complete first. You should see the following in the RAID state once re-syncing is complete : **active**.
![OMV RAID Clean](/img/omv/raid10-active.png)
!!! info
Whenever you change some settings in OMV, the following banner will appear. You can immediately apply the configuration by clicking **Apply** or you can carry on with your configuration and apply the changes at a later stage.
![OMV Save Settings](/img/omv/save_settings.png)
## Create a LVM Logical Volume ## Create a LVM Logical Volume
## Configure Share drive *First you need to install OMV LVM Plugin.*
## Format and Mount Volume
## Create User
## Create Shared Folder
## Configure Windows Share (SMB/CIFS)

View file

@ -15,6 +15,7 @@ copyright: 'Copyright &copy; Kobol Team 2017'
# Documentation and theme # Documentation and theme
theme: theme:
name: 'material' name: 'material'
language: 'en'
favicon: './img/favicon.png' favicon: './img/favicon.png'
logo: './img/helios4_logo.png' logo: './img/helios4_logo.png'
custom_dir: 'theme' custom_dir: 'theme'
@ -25,9 +26,9 @@ theme:
text: 'Roboto' text: 'Roboto'
code: 'Roboto Mono' code: 'Roboto Mono'
# Options # Options
extra: extra:
logo: './img/helios4_logo.png'
social: social:
- type: 'home' - type: 'home'
link: 'https://kobol.io/helios4' link: 'https://kobol.io/helios4'
@ -37,6 +38,8 @@ extra:
link: 'https://facebook.com/kobol.io' link: 'https://facebook.com/kobol.io'
- type: 'rss-square' - type: 'rss-square'
link: 'https://blog.kobol.io' link: 'https://blog.kobol.io'
sd_release:
latest: '29/11/2017'
# Google Analytics # Google Analytics
google_analytics: google_analytics:
@ -49,7 +52,7 @@ markdown_extensions:
- codehilite(guess_lang=false) - codehilite(guess_lang=false)
- toc(permalink=true) - toc(permalink=true)
# Page naming
pages: pages:
- Introduction: 'index.md' - Introduction: 'index.md'
- Hardware: 'hardware.md' - Hardware: 'hardware.md'

View file

@ -3,14 +3,10 @@
<div class="md-flex"> <div class="md-flex">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<a href="{{ config.site_url | default(nav.homepage.url, true) }}" title="{{ config.site_name }}" class="md-header-nav__button md-logo"> <a href="{{ config.site_url | default(nav.homepage.url, true) }}" title="{{ config.site_name }}" class="md-header-nav__button md-logo">
{% if config.extra.logo %} {% if config.theme.logo.icon %}
{% if config.extra.logo.icon %} <i class="md-icon">{{ config.theme.logo.icon }}</i>
<i class="md-icon">{{ config.extra.logo.icon }}</i>
{% else %}
<img src="{{ base_url }}/{{ config.extra.logo }}" width="24" height="24">
{% endif %}
{% else %} {% else %}
<i class="md-icon md-icon--home"></i> <img src="{{ base_url }}/{{ config.theme.logo }}" width="24" height="24">
{% endif %} {% endif %}
</a> </a>
</div> </div>
@ -18,30 +14,19 @@
<label class="md-icon md-icon--menu md-header-nav__button" for="drawer"></label> <label class="md-icon md-icon--menu md-header-nav__button" for="drawer"></label>
</div> </div>
<div class="md-flex__cell md-flex__cell--stretch"> <div class="md-flex__cell md-flex__cell--stretch">
<span class="md-flex__ellipsis md-header-nav__title"> <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
{% block site_name %} {% block site_name %}
{% if page %} {% if config.site_name == page.title %}
{% for parent in page.ancestors %} {{ config.site_name }}
<span class="md-header-nav__parent"> {% else %}
{{ parent.title }} <span class="md-header-nav__topic">
</span> {{ config.site_name }}
{% endfor %} </span>
<span class="md-header-nav__topic">
{{ page.title }}
</span>
{% endif %} {% endif %}
{{ page.title | default(config.site_name, true) }}
{% endblock %} {% endblock %}
</span>
</div>
<div class="md-flex__cell md-flex__cell--shrink">
<div class="md-header-nav__source">
<a href="/download" title="Go to Download" class="md-source">
<i class="md-icon" style="font-size: 1.8em; text-align: center;">sd_storage</i>
<div class="md-source__repository">
Download IMG
<ul class="md-source__facts">
<li class="md-source__fact">Latest build : 09/11/2017</li>
</ul>
</div>
</a>
</div> </div>
</div> </div>
{% if config.repo_url %} {% if config.repo_url %}
@ -51,10 +36,27 @@
</div> </div>
</div> </div>
{% endif %} {% endif %}
<div class="md-flex__cell md-flex__cell--shrink">
<div class="md-header-nav__source">
<a href="/download" title="Go to Download" class="md-source">
<div class="md-source__icon" style="vertical-align:middle; display:inline-block; height:100%">
<img src="/img/sd.png" style="position:relative; left:10px;">
</div>
<div class="md-source__repository">
Download IMG
<ul class="md-source__facts">
<li class="md-source__fact">Latest build : {{ config.extra.sd_release.latest }}</li>
</ul>
</div>
</a>
</div>
</div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
{% block search_box %} {% block search_box %}
<label class="md-icon md-icon--search md-header-nav__button" for="search"></label> {% if "search" in config["plugins"] %}
{% include "partials/search.html" %} <label class="md-icon md-icon--search md-header-nav__button" for="search"></label>
{% include "partials/search.html" %}
{% endif %}
{% endblock %} {% endblock %}
</div> </div>
</div> </div>

37
theme/partials/nav.html Normal file
View file

@ -0,0 +1,37 @@
<nav class="md-nav md-nav--primary" data-md-level="0">
<label class="md-nav__title md-nav__title--site" for="drawer">
<span class="md-nav__button md-logo">
{% if config.theme.logo.icon %}
<i class="md-icon">{{ config.theme.logo.icon }}</i>
{% else %}
<img src="{{ base_url }}/{{ config.theme.logo }}" width="24" height="24">
{% endif %}
</span>
{{ config.site_name }}
</label>
{% if config.repo_url %}
<div class="md-nav__source">
{% include "partials/source.html" %}
</div>
{% endif %}
<div class="md-nav__source">
<a href="/download" title="Go to Download" class="md-source">
<div class="md-source__icon">
<img src="/img/sd.png" style="position:relative; left:8px; top:8px">
</div>
<div class="md-source__repository">
Download IMG
<ul class="md-source__facts">
<li class="md-source__fact">Latest build : {{ config.extra.sd_release.latest }}</li>
</ul>
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
{% for nav_item in nav %}
{% set path = "nav-" + loop.index | string %}
{% set level = 1 %}
{% include "partials/nav-item.html" %}
{% endfor %}
</ul>
</nav>