mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-09-06 13:51:40 +00:00
Revert "Merge of latest changes into RTD theme to enable multi-language support (#604)"
This reverts commit 186f1e02b8.
This commit is contained in:
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 52 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 105 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 42 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 28 KiB |
@@ -0,0 +1,80 @@
|
||||
.. _smb-desktop:
|
||||
|
||||
Connect to Windows\* shared location from |CL-ATTR| desktop
|
||||
###########################################################
|
||||
|
||||
This tutorial explains how to access an existing shared drive on
|
||||
Windows\* via Server Message Block (SMB) / Common Internet File System (CIFS)
|
||||
from the |CL| GNOME desktop. CIFS filesystem is generally used to access
|
||||
shared storage locations, or share files.
|
||||
|
||||
Prerequisites
|
||||
*************
|
||||
|
||||
* You have already `set up a shared location on Windows`_
|
||||
|
||||
Connect to Windows shared location with Nautilus
|
||||
************************************************
|
||||
|
||||
#. From the desktop, select :guilabel:`Files` from the application menu.
|
||||
|
||||
.. note::
|
||||
|
||||
GNOME Files is also known as `Nautilus`.
|
||||
|
||||
#. In :guilabel:`Files`, select :guilabel:`Other Locations`.
|
||||
|
||||
.. figure:: figures/smb-desktop-1.png
|
||||
:scale: 100%
|
||||
:alt: Files, Other Locations
|
||||
|
||||
Figure 1: Files, Other Locations
|
||||
|
||||
#. In the lower taskbar, beside :guilabel:`Connect to Server`,
|
||||
enter the file-sharing address using the Windows sharing schema:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
smb://servername/Share
|
||||
|
||||
.. figure:: figures/smb-desktop-2.png
|
||||
:scale: 100%
|
||||
:alt: Connect to Server
|
||||
|
||||
Figure 2: Connect to Server
|
||||
|
||||
#. Optional: If there are issues with DNS, you can use an IP address in
|
||||
place of the `servername` above. You must still specify the share.
|
||||
|
||||
#. Optional: On the Windows machine, in a CLI, retrieve the IP address by
|
||||
entering the command:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ifconfig
|
||||
|
||||
.. note::
|
||||
|
||||
If using the IP address, assure that it is accessible and secure.
|
||||
|
||||
#. Select :guilabel:`Connect`.
|
||||
|
||||
#. The server will request authentication, as shown in Figure 3.
|
||||
|
||||
.. figure:: figures/smb-desktop-3.png
|
||||
:scale: 100%
|
||||
:alt: Authentication
|
||||
|
||||
Figure 3: Authentication
|
||||
|
||||
#. Log in with the same Windows system credentials for which you granted
|
||||
access to the share.
|
||||
|
||||
#. Select the appropriate checkbox to save your credentials. Consider
|
||||
carefully the security risks as a result of your selection.
|
||||
|
||||
|
||||
.. _set up a shared location on Windows: https://www.howtogeek.com/176471/how-to-share-files-between-windows-and-linux/
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,131 @@
|
||||
.. _clear-samba-share-to-Windows:
|
||||
|
||||
Enable simple file sharing with a Windows\* machine using Samba\*
|
||||
#################################################################
|
||||
|
||||
This tutorial describes how to enable simple file sharing from a system
|
||||
running |CL-ATTR| to a Windows machine using Samba. For more advanced sharing,
|
||||
refer to the `Samba guide`_.
|
||||
|
||||
Prerequisites
|
||||
*************
|
||||
|
||||
This tutorial assumes you have installed |CL| on your host system. For
|
||||
detailed instructions, follow the steps in :ref:`bare-metal-install-desktop`.
|
||||
|
||||
Before you install any new packages, update |CL| with the following command:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo swupd update
|
||||
|
||||
|
||||
Set up file sharing
|
||||
*******************
|
||||
|
||||
#. Log in and get root privileges.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo -s
|
||||
|
||||
#. Add the storage-utils bundle, which includes the Samba binaries.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
swupd bundle-add storage-utils
|
||||
|
||||
.. note::
|
||||
|
||||
The os-clr-on-clr bundle also includes the Samba binaries.
|
||||
|
||||
#. Create a configuration file called :file:`/etc/samba/smb.conf`. In this
|
||||
example, `[Downloads]` enables a folder share with a specific user.
|
||||
`[Documents]` enables a folder share with any user. The example assumes that a
|
||||
user account `clearlinuxuser` already exists.
|
||||
|
||||
If `valid users` is not specified, then anyone with a user account on the
|
||||
machine and with their Samba password already set can access the folder.
|
||||
However, the account is only able to access files and folders for which
|
||||
they have appropriate permissions.
|
||||
|
||||
Use :command:`chown` or :command:`chmod` to change either the owner of the
|
||||
file or the permissions to allow other users to access the file.
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
[Global]
|
||||
map to guest = bad user
|
||||
|
||||
[Downloads]
|
||||
path=/home/clearlinuxuser/Downloads
|
||||
read only = no
|
||||
guest ok = no
|
||||
valid users = clearlinuxuser
|
||||
|
||||
[Documents]
|
||||
path=/home/clearlinuxuser/Documents
|
||||
read only = no
|
||||
browsable = yes
|
||||
guest ok = yes
|
||||
|
||||
#. Enable the Samba daemon to start every time.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
systemctl enable smb
|
||||
systemctl start smb
|
||||
|
||||
#. Use :command:`smbpasswd` to add the initial password for the user
|
||||
account to access the share. Be aware that Samba maintains its own list of
|
||||
passwords for user accounts. The Samba password list can be different than
|
||||
the password used to log in.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
smbpasswd -a clearlinuxuser
|
||||
|
||||
Setup is complete and a Windows machine on the same network can access the
|
||||
shares. Windows uses the format :file:`\\\\[server IP or hostname]\\folder` to
|
||||
access shares. Access the shares directly with Windows Explorer or by
|
||||
mapping a network drive.
|
||||
|
||||
Use the IP address of the |CL| machine for an easy access method. If the
|
||||
|CL| machine is behind an Active Directory domain controller or a DNS server,
|
||||
use the hostname of the |CL| machine. For other ways to access shares using a
|
||||
hostname instead of an IP address, see `Chapter 7 of the Samba guide`_.
|
||||
|
||||
|
||||
Map |CL| drive in Windows
|
||||
*************************
|
||||
|
||||
#. Open Windows Explorer and click on the left sidebar on :guilabel:`This PC`
|
||||
to change the options available at the top.
|
||||
|
||||
#. Click the :guilabel:`Map Network Drive` icon and enter the path in the
|
||||
format: :file:`\\\\[server IP or hostname]\\[shared folder]`
|
||||
|
||||
#. Check the box :guilabel:`Connect using different credentials`. Enter
|
||||
the Samba user `clearlinuxuser` and the password created with
|
||||
:command:`smbpasswd`. See Figure 1 for details.
|
||||
|
||||
.. figure:: figures/smb-1.png
|
||||
:scale: 70%
|
||||
:alt: Map a network drive in Windows Explorer
|
||||
|
||||
Figure 1: Map a network drive in Windows Explorer.
|
||||
|
||||
When complete, Windows Explorer displays the share drive as shown in Figure 2.
|
||||
|
||||
.. figure:: figures/smb-2.png
|
||||
:scale: 70%
|
||||
:alt: View a share drive in Windows Explorer
|
||||
|
||||
Figure 2: View a share drive in Windows Explorer.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. _Samba guide: https://www.samba.org/samba/docs/using_samba/ch00.html
|
||||
.. _Chapter 7 of the Samba guide: https://www.samba.org/samba/docs/using_samba/ch07.html
|
||||
Reference in New Issue
Block a user