Overhaul docs for Windows filemon install
sheesh, hopefully this is "most" of it..although definitely still not all we need yet..
This commit is contained in:
parent
aa24c669a5
commit
47fb1e451a
24 changed files with 799 additions and 252 deletions
77
docs/base/install/windows/user.rst
Normal file
77
docs/base/install/windows/user.rst
Normal file
|
|
@ -0,0 +1,77 @@
|
|||
|
||||
============
|
||||
Windows User
|
||||
============
|
||||
|
||||
In some cases, in particular if you want to use the Rattail File
|
||||
Monitor, then you may need to consider which Windows user account the
|
||||
service will run as.
|
||||
|
||||
|
||||
Why It Matters
|
||||
==============
|
||||
|
||||
Rattail File Monitor does "one thing" - it watches some folder(s) and
|
||||
when new files appear it takes action(s) on them.
|
||||
|
||||
Most often the "action" is just to copy (or move) the file elsewhere,
|
||||
for further processing. In some cases it may be to "copy" the file
|
||||
directly to a printer port, e.g. LPT1.
|
||||
|
||||
Most often the "destination" for files being copied, is actually a
|
||||
Linux server, which runs the "real" Rattail-based app(s). This server
|
||||
exposes a CIFS share via Samba, and the filemon on Windows is able to
|
||||
copy files to the CIFS share easily enough.
|
||||
|
||||
But usually the CIFS share will have some sort of user security in
|
||||
place, so not just anyone on the network can access it. So we must
|
||||
run the filemon service as a particular user, which *does* have access
|
||||
to the share(s), and/or any other pertinent resources.
|
||||
|
||||
|
||||
Choosing a Username
|
||||
===================
|
||||
|
||||
It is recommended to use the default username of ``rattail`` unless
|
||||
you have reasons to do otherwise.
|
||||
|
||||
However there is no magic about that username, the main advantage to
|
||||
going with it is that all Rattail docs will use it, so you won't need
|
||||
to adjust any commands etc. when setting things up.
|
||||
|
||||
Keep in mind that this user account will need to exist on the Windows
|
||||
machine (see below) but also may effectively need to exist within
|
||||
Samba on the Linux side. Configuration of the latter is not our focus
|
||||
here, but just know that this may be more of a "network-wide" user
|
||||
account - depending on your use case.
|
||||
|
||||
|
||||
Active Directory
|
||||
================
|
||||
|
||||
As of this writing no AD integration has been attempted.
|
||||
|
||||
Only "local machine" user accounts are supported thus far.
|
||||
|
||||
Note that CIFS behavior is such that if you create a "local" Windows
|
||||
user with the username of ``rattail`` and password ``rattailpass``,
|
||||
and then configure a Samba user account with the same credentials,
|
||||
then things should work. (Please use a different password of course,
|
||||
that is just for example.)
|
||||
|
||||
|
||||
Creating the Account
|
||||
====================
|
||||
|
||||
You probably already know how to create a user account, but if you
|
||||
prefer you can tell Rattail to do it for you. In an admin console
|
||||
(right-click ``cmd.exe``, run as administrator) do:
|
||||
|
||||
.. code-block:: sh
|
||||
|
||||
rattail make-user --system windows rattail
|
||||
|
||||
This will create a "local machine" Windows account, with username
|
||||
``rattail`` and the password you specify (which you will be prompted
|
||||
for). This account will be suitable for use with the Rattail File
|
||||
Monitor service.
|
||||
Loading…
Add table
Add a link
Reference in a new issue