Jump to content

RUT955 USB Tools: Difference between revisions

no edit summary
No edit summary
 
(26 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Summary==
{{Template: Networking_rutos_manual_usb_tools_rut2_rut9
 
<!------------------------DEVICE----------------------->
This chapter is an overview of the <b>USB Tools</b> service in RUT955 routers.
| name   = RUT955
 
| series = RUT9
==Network Shares==
}}
 
The <b>Network Shares</b> section is used to manage Network-attached storage (NAS) such as USB drives, SD cards and hard drives. The router supports the following file system architectures:
<ul>
    <li><b>FAT32</b><span class="asterisk">*</span></li>
    <li><b>NTFS</b><span class="asterisk">**</span></li>
</ul>
<span class="asterisk">*</span> supports SD cards with a capacity of up to <b>32 GB</b><br>
<span class="asterisk">**</span> NTFS support available from FW version <b>RUT9XX_R_00.05.02</b> and newer
 
===Mounted File Systems===
----
The <b>Mounted File Systems</b> tab displays information on mounted USB drives and SD cards. To view an attached drive, connect it to the router and click the Refresh button:
 
[[File:Rut955 webui services usb tools network shares mounted file systems v2.png]]
 
<table class="nd-othertables">
    <tr>
        <th style="width: 250px">field name</th>
      <th style="width: 1450px">description</th>
    </tr>
    <tr>
      <td>Filesystem</td>
      <td>Name of the Linux filesystem. For better clarity, lets take a closer look at the filesystem name from the example above:
            <ul>
                <li><b>/dev</b> - the directory of device files. Everything in the Linux filesystem is either a file or a directory; /dev is the location of device files. Every device is represented by a file in the /dev directory</li>
                <li><b>sd</b> - identifies block devices<span class="asterisk">*</span> (capable of carrying data)</li>
                <li><b>a</b> - the letter immediately after sd signifies the order in which the device was first found (a, b, c, ...)</li>
                <li><b>1</b> - signifies the partition on the device</li>
            </ul>So the full string <b>/dev/sda1</b> denotes the first partition of the first block device<br><span class="asterisk">*</span> SD cards will be identified as MultiMediaCard (MMC) devices and the identifier will begin with the <b>mmcblk</b> string instead of sd
        </td>
    </tr>
    <tr>
      <td>Mount Point</td>
      <td>A mount point is a directory in the currently accessible filesystem on which an additional filesystem is mounted (i.e., logically attached). The <b>/mnt</b> directory and its subdirectories are intended for use as the temporary mount points for mounting storage devices. The mount point becomes the root directory of the newly added filesystem, and that filesystem becomes accessible from that directory</td>
    </tr>
    <tr>
    <td>Available</td>
        <td>Amount of available memory in the mounted drive. This column also displays the total capacity of the drive</td>
    </tr>
    <tr>
    <td>Used</td>
        <td>Amount of used memory in the mounted drive</td>
    </tr>
    <tr>
    <td>Safely Remove Disk</td>
        <td>Unmounts the drive so that it becomes safe to disconnect from the router</td>
    </tr>
</table>
 
====SSH commands====
----
Devices can be mounted or unmounted manually by using SSH commands.
=====Mounting=====
----
The <b>mount</b> command attaches a filesystem to the file hierarchy. The basic syntax for the command is:
 
mount -t type device dir
 
Where:
<ul>
    <li><b>-t</b> - the filesystem type. If this value is omitted, the command will try to determine the type automatically</li>
    <li><b>device</b> - file name of the device. Refer to section [[RUT955_USB_Tools#Mounted_File_Systems|2.1]] for examples</li>
    <li><b>dir</b> - directory that will be used as the mount point for the device. Refer to section [[RUT955_USB_Tools#Mounted_File_Systems|2.1]] for examples</li>
</ul>
 
<b>Example command</b>:
 
mount -t ntfs /dev/sda1 /mnt/sda1
 
=====Unmounting=====
----
The <b>umount</b> command detaches filesystem from the file hierarchy. he basic syntax for the command is:
 
umount device
 
<b>Example command</b>:
 
umount /dev/sda1
 
Using the umount command is analogous to clicking the "Safely Remove Disk" button. Therefore, the attached drive can be safely disconnected after using umount to detach it.
 
===Samba===
----
<b>Samba</b> is a software solution for using the Server Message Block (SMB) networking protocol, which provides shared file access between nodes on a computer network. The Samba tab in RUT955's WebUI is used to configure network access (look to section [[RUT955_USB_Tools#Shared_Directories|2.2.1]] for details) to storage devices connected to the router's MicroSD slot or USB connector.
 
[[File:Rut955 webui services usb tools network shares samba v1.png]]
 
<table class="nd-mantable">
    <tr>
        <th>field name</th>
      <th>value</th>
      <th>description</th>
    </tr>
    <tr>
      <td>Enable</td>
      <td>yes {{!}} no; Default: '''no'''</td>
      <td>Toggles Samba ON or OFF</td>
    </tr>
    <tr>
      <td>Hostname</td>
      <td>string; Default: '''Router_Share'''</td>
      <td>Name of the Samba server</td>
    </tr>
    <tr>
    <td>Description</td>
        <td>string; Default: '''Teltonika_Router_Share'''</td>
        <td>Short server description</td>
    </tr>
    <tr>
    <td>Workgroup</td>
        <td>string; Default: '''WORKGROUP'''</td>
        <td>Name of the server's workgroup</td>
    </tr>
</table>
 
====Shared Directories====
----
The <b>Shared Directories</b> section is used to configure access to connected storage drives or individual directories contained in those drives. A shared directory must be added before it can be configured:
 
[[File:Rut955 webui services usb tools network shares samba shared directories v2.png]]
 
<table class="nd-mantable">
    <tr>
        <th>field name</th>
      <th>value</th>
      <th>description</th>
    </tr>
    <tr>
      <td>Name</td>
      <td>string; Default: <b>none</b></td>
      <td>Name of the shared directory. </td>
    </tr>
    <tr>
      <td>Path</td>
      <td>file path; Default: <b>none</b></td>
      <td>Path to the shared directory.<br>To share an entire drive, choose an automatically generated path from this drop-down box (for example, /mnt/sda1).<br>To share a specific directory on the drive, specify the full path to that directory (for example, /mnt/sda1/shared/video)</td>
    </tr>
    <tr>
    <td>Allow guests</td>
        <td>yes {{!}} no; Default: <b>no</b></td>
        <td>Enables guest access, which allows anonymous connections to the shared directory</td>
    </tr>
    <tr>
    <td>Allowed users</td>
        <td>string; Default: " "</td>
        <td>Defines which users can access the shared directory. Users can be created from the Samba user tab (refer to section [[RUT955_USB_Tools#Samba_Users|2.3]] for details).<br>If Allow guests is checked, this field becomes inactive</td>
    </tr>
    <tr>
    <td>Read-only</td>
        <td>yes {{!}} no; Default: <b>no</b></td>
        <td>When enabled, leaves only the option the view files in the shared directory</td>
    </tr>
</table>
 
===Samba Users===
 
This page is used to add new '''Samba users'''.
 
[[Image:Services network shares samba users.PNG]]
 
<table class="nd-mantable">
    <tr>
        <th>field name</th>
      <th>value</th>
      <th>description</th>
    </tr>
    <tr>
      <td>Username</td>
      <td>string; Default: " "</td>
      <td>Name of the new user</td>
    </tr>
    <tr>
      <td>Password</td>
      <td>string; Default: " "</td>
      <td>Password of the new user</td>
    </tr>
</table>
 
==Printer Server==
 
The '''Printer Server''' function allows you to configure and use a printer that is connected to the RUT955 device.
 
[[File:Services usb tool printer server.png]]
 
You can enable or disable the support for your printer with this panel. In order to add another printer, type in a name and click the '''Add''' button. To configure a printer, click '''Edit''' next to the printer in question.
 
[[File:Services usb tool printer server configuration.png]]
 
<table class="nd-mantable">
    <tr>
        <th>field name</th>
      <th>value</th>
      <th>description</th>
    </tr>
    <tr>
      <td>Enable</td>
      <td>yes {{!}} no; Default: '''no'''</td>
      <td>Toggles printer support ON or OFF</td>
    </tr>
    <tr>
      <td>Device</td>
      <td>Default: " "</td>
      <td>Chooses the printer</td>
    </tr>
    <tr>
    <td>Port</td>
        <td>integer [9100..9109]; Default: '''9100'''</td>
        <td>TCP listener port</td>
    </tr>
    <tr>
    <td>Bidirectional mode</td>
        <td>yes {{!}} no; Default: '''no'''</td>
        <td>Toggles bidirectional mode ON or OFF</td>
    </tr>
</table>
 
==Supported USB modems==
 
RUT955 also supports the following USB modems:
* Huawei MS2131i-8