diff options
| -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 |