@@ -141,24 +141,25 @@ To build the WAR file, type
141
141
cd <project-root>
142
142
mvn clean install -Pprod
143
143
144
- You can run the WAR file in 3 ways:
144
+ This will install the required JAR files in your local Maven repository (normally
145
+ at ` ~/.m2/repository ` ). You can run the WAR file in 3 ways:
145
146
146
- 1 . directly from the ** command-line** , using:
147
-
148
- ```
149
- java -jar deployment/target/deployment-<version>.war [--port <port>] [--silent] [--debug] [--help]
150
- ```
151
-
152
- This will start the service at ` http://localhost:<port>/mapcode ` . If ` <port> ` is not specified, the
153
- default value is ` 8080 ` . If it is ` 0 ` , the server will choose any free port.
154
-
155
- 2 . directly from ** Maven** using:
147
+ 1 . Directly from ** Maven** using:
156
148
157
149
```
158
150
cd deployment
159
151
mvn jetty:run
160
152
```
161
-
153
+
154
+ 2 . Or directly from the ** command-line** , using:
155
+
156
+ ```
157
+ java -jar deployment/target/deployment-<version>.war [--port <port>] [--silent] [--debug] [--help]
158
+ ```
159
+
160
+ This will start the service at ` http://localhost:<port>/mapcode ` . If ` <port> ` is not specified, the
161
+ default value is ` 8080 ` . If it is ` 0 ` , the server will choose any free port.
162
+
162
163
This will start the service at ` http://localhost:8080/mapcode ` .
163
164
164
165
3 . in a ** Tomcat server** , deploying the file ` deployment/target/deployment-<version>.war ` into
@@ -167,6 +168,9 @@ your Tomcat instance.
167
168
The first method, running the WAR file from the command-line, using ` java ` only is particularly
168
169
useful if you wish use the XML services, for example, in a Microsoft Excel spreadsheet.
169
170
171
+ ** Important:** If the service does not start, some files may be missing from your ` external-resources `
172
+ directory. To fix this, read on.
173
+
170
174
### Missing ` mapcode-secret.properties ` and ` log4j.xml ` Files
171
175
172
176
The service requires 2 files called ` mapcode-secret.properties ` and ` log4j.xml ` to be present on the
@@ -351,6 +355,12 @@ self-hosting this service.
351
355
352
356
## Release Notes
353
357
358
+ ### 2.4.14.4
359
+
360
+ * Changed ` groupId ` to ` com.mapcode.rest ` .
361
+
362
+ * Updated ` README.md ` with correct instructions to create WAR file.
363
+
354
364
### 2.4.14.3
355
365
356
366
* Updated dependencies.
0 commit comments