Revert "Merge of latest changes into RTD theme to enable multi-language support (#604)"

This reverts commit 186f1e02b8.
This commit is contained in:
Kevin Putnam
2019-07-10 15:20:53 -07:00
committed by GitHub
parent 186f1e02b8
commit f2a5c5a46b
407 changed files with 2660 additions and 2918 deletions
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/
+131
View File
@@ -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