====== dCore Server & Networking ======
===== Overview =====
dCore may be used as a basic, lightweight home server. A text only server would require <64mb RAM (~42mb) at boot. It can utilize an existing swap partition, if already present. Otherwise create either a swap file or partition as needed. Although a live boot requires only ~20mb drive space (CD, DVD, USB, hard drive), a frugal text only installation (persistent hard drive install) likely requires ~100-200mb drive space, even after installing desired server and networking extensions. The Tiny Core base system, dCore components and server tools can all be managed from command line, no need to install Xorg/graphics.

At a TTY/terminal or terminal emulator, entering 'busybox' or 'busybox --list' outputs all available BusyBox commands. Tab auto-completion is supported. Pressing the Tab key twice lists all current system executables. After loading exensions, these additional executables will also become available. In a TTY or non-scrolling terminal, use Shift-PageUp and PageDown keys to scroll. Running 'executable_name --help' (two dashes) provides basic help and usage information for most commands.

===== iptables =====
Basic dCore iptables setup guide for desktop use. Modify for special need, networking, server or preference. Many ways to accomplish this in dCore, iptables has numerous configuration options. Run  iptables --help  for usage information. This method was tested in dCore-jessie.

Numerous tutorials online, useful references:
  * http://www.netfilter.org/documentation/
  * http://www.howtogeek.com/177621/the-beginners-guide-to-iptables-the-linux-firewall/
  * http://www.thegeekstuff.com/2011/06/iptables-rules-examples/
  * https://wiki.debian.org/iptables
  
The following rules are based on #7.1 - Only Block Incoming Traffic:
  * http://www.cyberciti.biz/tips/linux-iptables-examples.html
 
Designed to drop all incoming/forwarded packets, allow outgoing traffic.

With this basic configuration ping, wget and browsing all work.

Basic iptables setup:

Confirm kernel version:
    uname -r
Install iptables and netfilter onboot:
    sce-import -b iptables
    sce-import -b netfilter-<your_kernel_version>-tinycore
Load these extensions or reboot:
    sce-load iptables
    sce-load netfilter-<your_kernel_version>-tinycore

Check iptables status:
    sudo iptables -L -v
Lock down INPUT and FORWARD networking, disregard OUTPUT (user initiated traffic):
    sudo iptables --policy INPUT DROP
    sudo iptables --policy FORWARD DROP
Recheck status:
    sudo iptables -L -v
Attempt to access internet, ping domain, network (should fail, that's good!)
    ping -c3 www.google.com
Set up special rules, this allows INPUT for user initiated requests (eg. web browser):
    sudo iptables -A INPUT -m state --state NEW,ESTABLISHED -j ACCEPT
Save configuration state (only appeared to work in /home or /opt):
    sudo /sbin/iptables-save > /home/tc/iptables-rules
Append this line to /opt/bootlocal.sh so iptables-rules load at boot:
    /sbin/iptables-restore < /home/tc/iptables-rules
Backup for persistence:
    backup
Reboot system:
    sudo reboot
Verify iptables configuration persistence:
    sudo iptables -L -v
Repeat process as desired to modify rules

===== NTFS =====
For NTFS file system read-write capability utilize the [[https://en.wikipedia.org/wiki/NTFS-3G|ntfs-3g]] package.

By default NTFS partitions are mounted read-only (ro), example:
    tc@box:~$ cat /etc/fstab | grep sda1
    /dev/sda1       /mnt/sda1       ntfs     noauto,users,exec,ro,umask=000 0 0 # Added by TC

Prior to using ntfs-3g ensure no NTFS partitions are already mounted read-only, run and confirm:
    mount | grep sd

Unmount any NTFS partitions using a method below, first two commands may fail, /dev/sda1 example:
    sudo umount /dev/sda1
    sudo umount --force /dev/sda1  #if above fails, attempt forced umount
    sudo reboot                    #last resort to unmount NTFS partition(s)

Import //ntfs-3g// preferably to load at boot:
    sce-import -b ntfs-3g

Reboot or load:
    sce-load ntfs-3g

Mount desired NTFS partition using the ''ntfs-3g'' command, example:
    sudo ntfs-3g /dev/sda1 /mnt/sda1

The NTFS partition will now be accessible read-write as user 'tc'.

To unmount, reboot or use for example:
    sudo umount /dev/sda1
    
===== Samba =====
[[https://en.wikipedia.org/wiki/Samba_(software)|Samba]] is a free software re-implementation of the SMB/CIFS networking protocol that provides file and print services for various Microsoft Windows clients. It is useful to connect Linux and Windows systems and access shared storage on most Windows-world ISP-provided routers. Numerous full featured file managers provide built-in network browsing support, such as Caja and PCManFM. Configuration is similar to any other Linux distribution, brief usage outlined below.

Import Samba to load at boot:
<code>
sce-import -b samba
</code>

Optional install of smbclient, provides useful ''smbtree'' command when setting up network:
<code>
sce-import -b smbclient
</code>

Optional install of gvfs-backends, if not already included in the full-featured file manager of choice, to enable built-in network browsing functionality:
<code>
sce-import -b gvfs-backends
</code>

Reboot system or manually load above using the [[http://wiki.tinycorelinux.net/dcore:sce-load_command|dCore sce-load Command]]:
<code>
sce-load samba smbclient gvfs-backends
</code>
Copy sample /usr/share/smb.conf file to /etc/samba/:
<code>
sudo cp /usr/share/smb.conf /etc/samba/
</code>

Modify smb.conf file as desired, typically the trickiest part of setting up a Samba network. It may be easiest to modify an existing smb.conf file from a networked system or web search for sample configurations. Sometimes hardware and router reboots are helpful during initial setup, as well as stopping and restarting Samba between configuration changes.

Run ''testparm'' command to check smb.conf utilization and integrity:
<code>
testparm
</code>

Add //smb.conf// file to /opt/.filetool.lst:
<code>
echo "etc/samba/smb.conf" >> /opt/.filetool.lst
</code>

Backup this file before reboot:
<code>
backup #or filetool.sh -b
</code>

Restart Samba if it was already running before adding custom configuration (''top'' command will show //nmbd// and //smbd// running). If starting services manually, //nmbd// is usually started before //smbd//. If Samba does not start at boot, add the appropriate startup command(s) to /opt/bootlocal.sh. Useful commands to control Samba:
<code>
sudo service samba start
sudo service samba stop
sudo service samba restart
sudo service nmbd start
sudo service smbd start
sudo service nmbd stop
sudo service smbd stop
</code>

Confirm Samba network shares:
<code>
sudo smbstatus
smbtree #if smbclient installed
</code>

Temporary disable firewall or ensure the required ports are open for Samba functionality before testing.

===== smbclient =====
[[http://linux.die.net/man/1/smbclient|smbclient]] is an ftp-like client to access SMB/CIFS resources on servers.

This guide installs and utilizes only //smbclient//, not the entire Samba suite.

On a multi-system LAN, a USB storage device (ie. USB drive, USB memory stick) connected directly to a DSL router server is a convenient central location to retrieve and share files without seting up [[https://en.wikipedia.org/wiki/Peer-to-peer|peer to peer networking]].

This //smbclient// method provides a command line interface only to 'put' and 'get' files. It is simple to set up and does not require special configuration, such as modifying //iptables// or /etc/fstab, using a Samba configuration file (smb.conf), creating mount points or adding files to /opt/.filetool.lst.

Most routers are provided by the ISP and security can not be assured. The shared data will become always available, protected solely by the router's firewall. This method should, therefore, only be used to store and share non-sensitive data. It is prudent to review and tighten security and firewall settings from within the router's web interface before proceeding (eg. typical vs minimum security, disable wireless if not used, stronger password).

To determine the router's IP address using built-in tools, run //route// and //route -n//, example:
  tc@box:~$ route
  Kernel IP routing table
  Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
  default         telus.home      0.0.0.0         UG    0      0        0 eth0
  127.0.0.1       *               255.255.255.255 UH    0      0        0 lo
  192.168.1.0     *               255.255.255.0   U     0      0        0 eth0


  tc@box:~$ route -n
  Kernel IP routing table
  Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
  0.0.0.0         192.168.1.254   0.0.0.0         UG    0      0        0 eth0
  127.0.0.1       0.0.0.0         255.255.255.255 UH    0      0        0 lo
  192.168.1.0     0.0.0.0         255.255.255.0   U     0      0        0 eth0

The 'Flags' UG mean 'Gateway' (ie. the router) is 'Up'. From the //route// command the gateway is telus.home and the //route -n// command confirms that the gateway's IP address is 192.168.1.254. Different ISPs/routers will use different gateway addresses.

This example uses a D-Link router server, attached 16Gb USB stick, running dCore-jessie.

Most modern routers have USB storage capability, attach USB storage device to back of router.

Using the router's administator name and password, login to router and enable 'Shared Storage'. Review router's 'network overview' or 'services' to confirm 'Shared Storage' or 'File Server' enabled, including the type and size of storage device attached.

Import and load //smbclient//, OnDemand unless using at every boot:
    sce-import -o smbclient
    sce-load smbclient

Use smbclient to list available router shares, use the router's IP address, example:
    smbclient -L 192.168.1.254

<code>
tc@box:~$ smbclient -L 192.168.1.254
smbclient: Can't load /etc/samba/smb.conf - run testparm to debug it
Enter tc's password: 
dos charset 'CP850' unavailable - using ASCII
Domain=[JUNK] OS=[Unix] Server=[Samba 3.0.28]

        Sharename       Type      Comment
        ---------       ----      -------
        A               Disk      Generic USB Flash Disk (Rev: 0.00)
        IPC$            IPC       IPC Service (Telus File Server)
Domain=[JUNK] OS=[Unix] Server=[Samba 3.0.28]

        Server               Comment
        ---------            -------
        TELUS                Telus File Server

        Workgroup            Master
        ---------            -------
        JUNK                 TELUS
</code>

In the example above, the server is 'TELUS' and USB Flash Disk Sharename is 'A'. Ignore all /etc/samba/smb.conf warnings, a smb.conf file is not required.

Connect to the USB storage device. Note double slashes used as escapes, no capitalization required, simply press Enter at 'tc's password:' prompt if not using a user password. Example:
    smbclient \\\\telus\\a

<code>
tc@box:~$ smbclient \\\\telus\\a
smbclient: Can't load /etc/samba/smb.conf - run testparm to debug it
Enter tc's password: 
dos charset 'CP850' unavailable - using ASCII
Domain=[JUNK] OS=[Unix] Server=[Samba 3.0.28]
smb: \>
</code>

A Samba prompt is now available (smb: \>), successful connection!

Basic usage:
  *Enter '?' to view commands.
  *To list files use 'ls'.
  *To place files use 'put', can only 'put' files from working directory.
  *To retrieve files use 'get', files copied to working directory.
  *To exit use 'exit'.

<code>
smb: \> ls
  .                                   D        0  Thu Jul 21 07:15:13 2016
  ..                                  D        0  Wed Jan  1 00:00:14 2003
  07.22-07.28.pdf                     A 25548096  Thu Jul 21 06:23:10 2016
  home                                D        0  Wed Jul 13 20:12:48 2016
  hp7610_manual                       A 12074424  Thu Jul 14 20:01:08 2016
  hp7610_poster                       A  1890153  Thu Jul 14 20:00:26 2016
  hp7610_quick_guide                  A  6995973  Thu Jul 14 20:00:02 2016

                15713248 blocks of size 1024. 15667168 blocks available
</code>

===== SSH =====
The OpenSSH-server package does not run "out of the box" because the SSH-keys must be created manually once and then included in 'mydata.tgz'.

==== Preparations ====
  - After loading the extension for the first time, issue ''sudo ssh-keygen -A'' in order to have the necessary keys generated. This will populate '/etc/ssh/' with private and public keys.
  - Set a password for user "tc" by ''sudo passwd tc''. The traditional password is "tcuser".
  - Add "etc/ssh/" as well as "etc/shadow" to '/opt/.filetool.lst' and issue ''backup''.

In principal it should not be necessary to set a password as there is the option //PermitEmptyPasswords// in '/etc/ssh/sshd_config'. However, this does not work at least on Ubuntu Xenial.


==== Running ====
Start the server via ''sudo /etc/init.d/ssh start'' or ''sudo service ssh start'' (on Ubuntu).

**[[http://wiki.tinycorelinux.net/dcore:welcome|> Return to the dCore Wiki Welcome page]]**