aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorCharadon <dev@iotib.net>2022-10-08 22:23:17 -0400
committerCharadon <dev@iotib.net>2022-10-08 22:23:17 -0400
commit7013bbd6e8d0c81c6b0d4ccc3ba12afa1341ad63 (patch)
tree6e4e9bf584453bf5bebbc9c084e8a450c205ada3
parent52facfe07f82aa1639f9fb7e4141ccd902a28c74 (diff)
downloaddscip-7013bbd6e8d0c81c6b0d4ccc3ba12afa1341ad63.tar.gz
docs/manual.tex: Moved to docs
-rw-r--r--docs/manual.tex (renamed from manual.tex)74
1 files changed, 37 insertions, 37 deletions
diff --git a/manual.tex b/docs/manual.tex
index 7913e1d..0a7b542 100644
--- a/manual.tex
+++ b/docs/manual.tex
@@ -225,28 +225,8 @@ work. If not, see:
Once MSYS2 is installed, run setup.sh (@command{setup.sh -h} for
more info.).
@item
- Next, we'll need to set it up as a service since Windows doesn't
- really have cronjobs. I recommend using @url{https://nssm.cc, NSSM}
- to create a service for Windows.
- @item
- Edit config.sh and set @env{DSCIP_DAEMON} to true, and set
- @env{DSCIP_DAEMON_FORK} to false.
- @item
- Next, create a batch/powershell script to launch MSYS2 to run the
- dscip script. Here's an example batch script:
- @example
-set MSYSTEM=MINGW64
-"C:\Users\builder.DESKTOP-U8KQJI1\scoop\apps\msys2\current\usr\bin\bash" -l -c "path/to/dscip"
- @end example
- @item
- Next, run @command{nssm install <name of service>} and set follow
- it's instructions. You can also use
- @url{https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/sc-create,
- sc.exe} if you'd rather not use NSSM.
- @item
- Then you just open services.msc and run it, or use @command{nssm
- start name-of-service}, if you went with NSSM.
-
+ Now we'll need a way to run it regularly. I recommend using the Task Scheduler
+ that comes with Windows. Here's a step-by-step guide: @xref{Task Scheduler}
@end enumerate
@node Only Bash
@@ -263,27 +243,47 @@ set MSYSTEM=MINGW64
the command prompt or powershell. Once in Bash, run setup.sh
(@command{setup.sh -h} for more info.) and install dscip.
@item
- Once installed, you'll need to set up a service for it. I recommend
- using @url{https://nssm.cc, NSSM} for an easier time.
- @item
- Open config.sh and change @env{DSCIP_DAEMON} to true, and set
- @env{DSCIP_DAEMON_FORK} to false.
+ Now we'll need a way to run it regularly. I recommend using Task Scheduler
+ that comes with Windows. Here's a step-by-step guide: @xref{Task Scheduler}
+ @end enumerate
+ @node Task Scheduler
+ @subsection Using Task Scheduler
+ @cindex Windows: Using Task Scheduler
+ Once you have DSCIP installed, you'll need to have it run on a regular basis.
+ For this, Windows has the Task Scheduler. Using it is very simple, and i'll go
+ over a basic set up with it. Also, you should always use an unpriviledged user.
+ @enumerate
@item
- Create a Batch or Powershell script, here's an example batch script:
- @*
+ Create a batch/powershell script that runs bash on the DSCIP script. This script should
+ be located somewhere that the unpriviledged user can run it.@*
+ Here is an a batch example:@*
@example
- bash "C:\path\to\dscip"
+set MSYSTEM=MINGW64 :: If you're using MSYS2
+C:\Users\Build\scoop\apps\msys2\current\usr\bin\bash -l -c "/home/Build/project/dscip"
@end example
@item
- Once the script is done being made, you can use NSSM to create the
- service, or
- @url{https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/sc-create,
- sc.exe}.
+ Log in as an Administrator user and open Task Scheduler by press Win+R, and typing taskschd.msc into the Run Dialog.
+ @item
+ Right click on @command{Task Scheduler Library} and click @command{Create Task}
+ @item
+ Under Security Options, change the User to an unpriviledged user, and set to 'Run whether user is logged on or not.'
@item
- Now just open services.msc or @command{nssm start <name-of-service>}
- to start it.
+ Go to 'Triggers' and click the 'New...' button. A new window will pop up with options
+ to schedule when the task will execute. First thing you should do is click the 'Begin the Task'
+ drop-down menu and select 'At startup', this will ensure that the task will run with every reboot.
+ As for schedule settings, I recommend going down to advanced and checking the box 'Repeat task every:' and
+ putting in '1 minute' into the box, and then selecting 'Indenfinitely' in the 'for a duration of' box.
+ Now click the 'OK' button to save your settings.
+ @item
+ Go to the 'Actions' tab and click the 'New...' button at the bottom. In the 'New Action' dialog that will pop up,
+ select the Batch/Powershell script you made earlier. There's no need to select a 'Start In' location, as the script
+ by default tries to change directory into the directory where the script is stored at.
+ @item
+ From here, you can configure any options you want, but if you have no further configuration needs, click the 'Ok' button
+ to close out of the 'Create Task' window. Now just reboot the machine.
@end enumerate
-
+ @noindent
+ And that should be it, it will now run DSCIP every minute.
@node Packaging
@section Packaging