10.2.3 Running services on Windows

10.2.3.1 Installing the windows services

Installation of the services is done via a batch script, provided in the services directory of either your daisy data directory or your daisy wiki data directory:

In case you have no services directory, see the service installation instructions.

10.2.3.1.1 Daisy Repository

To install the daisy repository as windows service, simply run the batch file install-daisy-repository-server-service.bat inside the directory service below your daisy data directory:

C:\>cd C:\Path\to\your\daisy\datadir\service
C:\Path\to\your\daisy\datadir\service>install-daisy-repository-server-service.bat
wrapper  | Daisy CMS Repository Server installed.

Alternatively, you can point your Windows-Explorer to the directory service below your daisy data directory and double click on the file install-daisy-repository-server-service.bat in order to launch the installation.

10.2.3.1.2 Daisy Wiki

To install the daisy wiki as windows service, run the batch file install-daisy-wiki-service.bat inside the directory service below your daisywiki data directory:

C:\>cd C:\Path\to\your\daisy\wikidatadir\service
C:\Path\to\your\daisy\wikidatadir\service>install-daisy-wiki-service.bat
wrapper  | Daisy CMS Wiki Web Application installed.

Alternatively, the batch file can be started via double click inside the Windows Explorer, like explained above.

Please note that after each change of the wrapper configuration files, you have to reinstall the wrapper services in order to take the changes effect.

10.2.3.2 Starting, stopping and restarting the services

Starting, stopping or restarting of the services is done via batch scripts, provided in the services directory of either your daisy data directory or your daisy wikidata directory:

10.2.3.2.1 Daisy Repository

To startup the daisy repository as windows service, simply run the batch file start-daisy-repository-server-service.bat inside the directory service below your daisy data directory:

C:\>cd C:\Path\to\your\daisy\datadir\service
C:\Path\to\your\daisy\datadir\service>start-daisy-repository-server-service.bat
Daisy CMS Repository Server will be launched...
Daisy CMS Repository Server was launched successfully.

Alternatively, you can point your Windows-Explorer to the directory service below your daisy data directory and double click on the file install-daisy-repository-server-service.bat in order to launch the installation.

For stopping or restarting the daisy repository service, simply use the files start-daisy-repository-server-service.bat or start-daisy-repository-server-service.bat, respectively.

If the name of your MySQL service is different from MySQL, you will end up with system error 1075, complaining about the fact that a dependent service does not exist. In that case simply adjust the value of the property wrapper.ntservice.dependency.1 inside the config file  daisy-repository-server-service.conf to the name of your MySQL service (e.g. MySQL5).

10.2.3.2.2 Daisy Wiki

To startup the daisy wiki as windows service, simply run the batch file start-daisy-wiki-service.bat inside the directory service below your daisy wikidata directory:

C:\>cd C:\Path\to\your\daisy\wikidatadir\service
C:\Path\to\your\daisy\wikidatadir\service>start-daisy-wiki-service.bat
Daisy CMS Wiki Web Application will be launched...
Daisy CMS Wiki Web Application was launched successfully.

Alternatively, the batch file can be started via double click inside the Windows Explorer, like explained above.

For stopping or restarting the daisy wiki service, simply use the files start-daisy-wiki-service.bat or start-daisy-wiki-service.bat, respectively.

10.2.3.3 Uninstalling the windows services

Deinstallation of the services is done via a batch script, provided in the services directory of either your daisy data directory or your daisy wiki data directory:

10.2.3.3.1 Daisy Repository

To uninstall the daisy repository as windows service, simply run the batch file uninstall-daisy-repository-server-service.bat inside the directory service below your daisy data directory:

C:\>cd C:\Path\to\your\daisy\datadir\service
C:\Path\to\your\daisy\datadir\service>uninstall-daisy-repository-server-service.bat
wrapper  | Daisy CMS Repository Server removed.

Alternatively, you can point your Windows-Explorer to the directory service below your daisy data directory and double click on the file uninstall-daisy-repository-server.service.bat in order to launch the deinstallation.

You may also use the Windows Service console in order to start, stop or restart the daisy repository service or change the characteristics of that service. In order to invoke that console, goto Start|Run and enter “services.msc” or invoke the console from the system panel.

10.2.3.3.2 Daisy Wiki

To uninstall the daisy wiki as windows service, run the batch file uninstall-daisy-wiki-service.bat inside the directory service below your daisywiki data directory:

C:\>cd C:\Path\to\your\daisy\wikidatadir\service
C:\Path\to\your\daisy\wikidatadir\service>uninstall-daisy-wiki-service.bat
wrapper  | Daisy CMS Wiki Web Application removed.

Alternatively, the batch file can be started via double click inside the Windows Explorer, like explained above.

You may also use the Windows Service console in order to start, stop or restart the wiki service. Invokation of that console is described above.

10.2.3.4 Testing and debugging the service scripts

In case of problems or startup failures of the services, you may have a look at the log files daisy-repository-server-service.log and daisy-wiki-service.log which can be found in the logs directory of either your daisy data directory or your daisy wiki data directory.
Also, you may start the wrapper scripts interactively, so that the output of the process is redirected to the console. This is explained below:

10.2.3.4.1 Daisy Repository

In order to debug the daisy repository, simply run the batch file daisy-repository-server-service.bat inside the directory service below your daisy data directory:

C:\>cd C:\Path\to\your\daisy\datadir\service
C:\Path\to\your\daisy\datadir\service>daisy-repository-server-service.bat
wrapper  | --> Wrapper staretd as console
wrapper  | --> Launching a JVM...
jvm 1    | Wrapper (Version 3.2.3) http://wrapper.tanukisoftware.org
jvm 1    |   Copyright 1999-2006 Tanuki Software, Inc.  All Rights Reserved.
... console output will follow here 

Make sure that the %JAVA_HOME% variable is set as system variable and not as user variable. Otherwise you may end up with an system error 1067 while starting up the repository via the service script.

10.2.3.4.2 Daisy Wiki

In order to debug the daisy wiki, simply run the batch file daisy-wiki-service.bat inside the directory service below your daisy data directory:

C:\>cd C:\Path\to\your\daisy\datadir\service
C:\Path\to\your\daisy\datadir\service>daisy-wiki-service.bat
wrapper  | --> Wrapper staretd as console
wrapper  | --> Launching a JVM...
jvm 1    | Wrapper (Version 3.2.3) http://wrapper.tanukisoftware.org
jvm 1    |   Copyright 1999-2006 Tanuki Software, Inc.  All Rights Reserved.
... console output will follow here