Wiki source code of Guide d'installation Windows

Last modified by jhurst on 2021/04/21 10:01
Show last authors
1 DigDash Enterprise installation can be done in two different ways on Windows:
2
3 * Install for manual launch
4 * Install as a Windows service
5
6 This document describe how to install DigDash on Windows in both modes.
7
8 To install on Linux, read document __[[install_guide_linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome]]__.
9
10 To update an existing install, read document [[upgradeDDE>>doc:Digdash.deployment.installation.upgrade_dde.WebHome]].
11
12 {{ddtoc/}}
13
14 = INSTALLATION =
15
16 Unzip the archive file **install_dd_20xx.zip** in the folder of your choice, preferably **/user/share/install_dd_20xx.zip**. DigDash Enterprise files are now installed on your computer.
17
18 Digdash Enterprise install can also be installed by DigDash setup (read document [[setup_en.pdf>>path:/C:/workspace_ent/digdash_enterprise_install/documentation/en/setup_en.pdf]]).
19
20 = Tomcat Parameters =
21
22 Some paramters like tomcat memory allocation and network ports may have to be modified to install DigDash Enterprise.
23
24 This chapter describes how to modify three of the most important parameters at install time: Tomcat memory allocation, network ports and Windows service (if an install as a Windows service is needed).
25
26 A more complete list of parameters is in the document [[digdash_enterprise_guide_avance_systeme>>doc:Digdash.deployment.configuration.advanced_system_guide.WebHome]].
27
28 == Allocated memory ==
29
30 1. Open the folder **<install DDE>\apache-tomcat\bin** then edit the file **setenv.bat**
31 1. Modify values of **JVMMS** and **JVMMX** defined at the beginning of the file.
32 Example: **set JVMMS=4096** and **set JVMMX=4096** to increase allocated memory to 4GB.
33
34 == Network ports ==
35
36 If one or more port mandatory to Tomcat are already in use by another process, then it will not start. It is important to check for the availability of the network ports on the system. By default the three following ports are needed: 8005, 8080 and 8009.
37 Follow the following steps to modify them :
38
39 1. Open the folder **<install DDE>\apache-tomcat\bin** then edit the file **server.xml**
40 1. Find and replace all port values 8005, 8080 and 8009 by number of available ports on the system.
41
42 == Name of the Tomcat Windows service ==
43
44 In some cases it is interesting to modify the Windows service name that will be created when installing as a service (next chapter). For instance, another service already exists with the same name.
45
46 1. Open the folder **<install DDE>\configure** then edit the file **servers_install_service_64.bat**
47 1. Find and replace the value of the variable **SERVICE_NAME** at the beginning of the file. Example: **set SERVICE_NAME=Tomcat7_DEV**
48
49 = DigDash Enterprise manual Start And Stop =
50
51 When DigDash enterprise is not installed as a Windows service.
52
53 == Starting DigDash Enterprise ==
54
55 Open the DigDash Enterprise installation folder and then double click the **start_tomcat.bat **file.
56
57 Wait until the servers starts (starting the server can take several minutes the first time).
58
59 == Stopping DigDash Enterprise ==
60
61 Open the DigDash Enterprise installation folder and then double click the **stop_tomcat.bat **file.
62
63 = Installing as a Windows service =
64
65 Install as a service must be done with a user with administration rights on the Windows system.
66
67 Make sure you modified the parameters specified previously in this document, if needed, //before// you install the service.
68
69 1. Start the command line prompt as an administrator (right-click on cmd icon in Start menu and select “Run as an administrator” option)
70 1. Get into the folder **<install DDE>\configure** then enter the command **servers_install_service_64.bat** on Windows 64 bits or **servers_install_service.bat** on Windows 32 bits. The service « Apache Tomcat7 » is installed (or another previously spécified name).
71 1. The service is installed in manual start mode by default. To change that behavior start the Windows Service Manager and change the properties of the new service. You can also check in this dialog that the service will be started with the correct user.
72
73