change port 5000 -> 5002

tomkralidis · tomkralidis · commit 4794c617d3eb · 2025-07-15T11:41:11.000+02:00
diff --git a/workshop/content/docs/advanced/clusters.md b/workshop/content/docs/advanced/clusters.md
@@ -31,7 +31,7 @@ CLASS
 
 !!! example
 
-    - MapServer request: <http://localhost:5000/?map=/etc/mapserver/clusters.map&mode=map&layer=trees>
+    - MapServer request: <http://localhost:5002/?map=/etc/mapserver/clusters.map&mode=map&layer=trees>
     - OpenLayers example: <http://localhost:5001/clusters.html>
 
 ??? JavaScript "clusters.js"
@@ -55,4 +55,4 @@ CLASS
         MAXDISTANCE 50
         REGION "ellipse"
     END
-    ```
+    ```
diff --git a/workshop/content/docs/advanced/sld.md b/workshop/content/docs/advanced/sld.md
@@ -24,10 +24,10 @@ This exercise will focus on the first use case.
 
 !!! example
 
-    - Direct MapServer request: <http://localhost:5000/?map=/etc/mapserver/lines.map&mode=map&layer=roads>
+    - Direct MapServer request: <http://localhost:5002/?map=/etc/mapserver/lines.map&mode=map&layer=roads>
     - Local OpenLayers example: <http://localhost:5001/sld.html>
-    - GetCapabilities request: <http://localhost:5000/?map=/etc/mapserver/sld.map&REQUEST=GetCapabilities&SERVICE=WMS&VERSION=1.3.0>
-    - Request to generate SLD from a Mapfile: <http://localhost:5000/?map=/etc/mapserver/sld.map&REQUEST=GetStyles&SERVICE=WMS&LAYERS=countries&VERSION=1.3.0&sld=http://node:5001/data/sld.xml>
+    - GetCapabilities request: <http://localhost:5002/?map=/etc/mapserver/sld.map&REQUEST=GetCapabilities&SERVICE=WMS&VERSION=1.3.0>
+    - Request to generate SLD from a Mapfile: <http://localhost:5002/?map=/etc/mapserver/sld.map&REQUEST=GetStyles&SERVICE=WMS&LAYERS=countries&VERSION=1.3.0&sld=http://node:5001/data/sld.xml>
 
 ???+ SLD
 
diff --git a/workshop/content/docs/advanced/symbols.md b/workshop/content/docs/advanced/symbols.md
@@ -81,7 +81,7 @@ END
 
 !!! example
 
-    - Direct MapServer request: <http://localhost:5000/?map=/etc/mapserver/railways.map&mode=map&layer=roads>
+    - Direct MapServer request: <http://localhost:5002/?map=/etc/mapserver/railways.map&mode=map&layer=roads>
     - Local OpenLayers example: <http://localhost:5001/railways.html>
 
 ??? JavaScript "railways.js"
@@ -114,4 +114,4 @@ END
 ## Further Reading
 
 - [Cartographical Symbol Construction with MapServer](https://mapserver.org/mapfile/symbology/construction.html)
-- [MapServer Symbology Exchange](https://github.com/MapServer/MapServer/wiki/SymbologyExchangeVector)
+- [MapServer Symbology Exchange](https://github.com/MapServer/MapServer/wiki/SymbologyExchangeVector)
diff --git a/workshop/content/docs/inputs/databases.md b/workshop/content/docs/inputs/databases.md
@@ -78,7 +78,7 @@ Online example not available as no PostGIS installation on the server
 
 !!! example "Exercise Links"
 
-    - MapServer request: <http://localhost:5000/?map=/etc/mapserver/postgis.map&mode=map&layer=water>
+    - MapServer request: <http://localhost:5002/?map=/etc/mapserver/postgis.map&mode=map&layer=water>
     - OpenLayers example: <http://localhost:5001/postgis.html>
 
 ??? JavaScript "postgis.js"
@@ -97,7 +97,7 @@ Online example not available as no PostGIS installation on the server
 
 1. Try and load another dataset into the database using the `ogr2ogr` approach above.
 2. Now add a new layer to the Mapfile to display the layer. You can make a direct request to MapServer in the form:
-  <http://localhost:5000/?map=/etc/mapserver/postgis.map&mode=map&layers=water%20NEWLAYERNAME>.
+  <http://localhost:5002/?map=/etc/mapserver/postgis.map&mode=map&layers=water%20NEWLAYERNAME>.
 3. Now update the JS file so the layer is visible as part of the interactive map, through WMS:
 
     ```js
@@ -106,4 +106,4 @@ Online example not available as no PostGIS installation on the server
           params: { 'LAYERS': 'water,NEWLAYERNAME', 'STYLES': '' },
           ratio: 1
       }),
-    ```
+    ```
diff --git a/workshop/content/docs/inputs/raster.md b/workshop/content/docs/inputs/raster.md
@@ -86,7 +86,7 @@ A [COMPOSITE](https://mapserver.org/mapfile/composite.html) block is used on the
 
 !!! example
 
-    - MapServer request: <http://localhost:5000/?map=/etc/mapserver/raster.map&mode=map&layer=dtm>
+    - MapServer request: <http://localhost:5002/?map=/etc/mapserver/raster.map&mode=map&layer=dtm>
     - OpenLayers example: <http://localhost:5001/raster.html>
 
 ??? JavaScript "raster.js"
@@ -105,4 +105,4 @@ A [COMPOSITE](https://mapserver.org/mapfile/composite.html) block is used on the
 
 1. Try different settings for layer `OPACITY` to see its effect on the output in `raster.map`.
 2. Change the `COLOR` of the first `CLASS` in `terrain.include` to highlight which pixels have values in this range. 
-   Cyan (`COLOR 0 255 255`) is a good colour for highlighting.
+   Cyan (`COLOR 0 255 255`) is a good colour for highlighting.
diff --git a/workshop/content/docs/inputs/vector.md b/workshop/content/docs/inputs/vector.md
@@ -38,7 +38,7 @@ than a huge GeoTIFF file.
 
 !!! example
 
-    - MapServer request: <http://localhost:5000/?map=/etc/mapserver/stars.map&mode=map&layer=constellations>
+    - MapServer request: <http://localhost:5002/?map=/etc/mapserver/stars.map&mode=map&layer=constellations>
     - OpenLayers example: <http://localhost:5001/stars.html>
 
 ??? JavaScript "stars.js"
diff --git a/workshop/content/docs/introduction/commandline.md b/workshop/content/docs/introduction/commandline.md
@@ -21,7 +21,7 @@ INPUT=POSTGIS INPUT=OGR INPUT=GDAL INPUT=SHAPEFILE INPUT=FLATGEOBUF
 When run through a web server, data is passed to the `mapserv` application, which generates output that is then sent back through the web server.
 All web requests can be recreated and tested on the command line, this makes it a handy debugging tool. 
 
-To test a URL such as <http://localhost:5000/?map=/etc/mapserver/countries.map&mode=map> run the following command:
+To test a URL such as <http://localhost:5002/?map=/etc/mapserver/countries.map&mode=map> run the following command:
 
 ```bash
 mapserv "QUERY_STRING=map=/etc/mapserver/countries.map&mode=map"
diff --git a/workshop/content/docs/introduction/docker.md b/workshop/content/docs/introduction/docker.md
@@ -10,15 +10,15 @@ MapServer runs on the Apache web server - see the [Apache page](../advanced/apac
 
 It uses the Apache [mod_fcgid module](https://httpd.apache.org/mod_fcgid/), module that provides FastCGI support.
 
-MapServer runs on port 80 on the Docker container, which is mapped to port 5000 on the local machine, as can be seen in the Docker compose file
+MapServer runs on port 80 on the Docker container, which is mapped to port 5002 on the local machine, as can be seen in the Docker compose file
 located at `workshop\exercises\docker-compose.yml`:
 
 ```yaml
   mapserver:
     image: camptocamp/mapserver:8.4-gdal3.10
     container_name: mapserver
     ports:
-      - 5000:80
+      - 5002:80
     environment:
       MAPSERVER_CONFIG_FILE: "/etc/mapserver/mapserver.conf"
     volumes:
@@ -55,7 +55,7 @@ A second container that serves the JavaScript example pages is also run using Do
   # start docker in detached mode
   docker compose up -d
   # the following URLs should now be available
-  # http://localhost:5000
+  # http://localhost:5002
   # http://localhost:5001
 
   # stop docker
@@ -73,4 +73,4 @@ A second container that serves the JavaScript example pages is also run using Do
 ```bash
 # to remove a container named db
 docker rm db
-```
+```
diff --git a/workshop/content/docs/introduction/introduction.md b/workshop/content/docs/introduction/introduction.md
@@ -56,13 +56,13 @@ setup provided to you is actually working. The configuration file for Docker Com
     docker compose up
     ```
 
-    2. Open <http://localhost:5000> in your browser, you should see an error message!
+    2. Open <http://localhost:5002> in your browser, you should see an error message!
     3. Close by pressing `CTRL-C`
 
 # Displaying your First Map
 
-- Ensure that you have MapServer setup and running at <http://localhost:5000>.
-- Now try opening the following MapServer URL in your browser - <http://localhost:5000/?map=/etc/mapserver/countries.map&mode=map>
+- Ensure that you have MapServer setup and running at <http://localhost:5002>.
+- Now try opening the following MapServer URL in your browser - <http://localhost:5002/?map=/etc/mapserver/countries.map&mode=map>
 
 
 !!! note
@@ -72,7 +72,7 @@ setup provided to you is actually working. The configuration file for Docker Com
     ```bash
     docker compose up -d
     docker container ls  # verify that the mapserver container is running
-    # visit http://localhost:5000 in your browser
+    # visit http://localhost:5002 in your browser
     docker logs --follow mapserver  # view logs
     docker compose stop
     ```
diff --git a/workshop/content/docs/mapfile/labels.md b/workshop/content/docs/mapfile/labels.md
@@ -41,7 +41,7 @@ GEOMTRANSFORM (centerline(densify([shape], 0.1)))
 
 !!! example
 
-    - Direct MapServer request: <http://localhost:5000/?map=/etc/mapserver/lakes.map&mode=map&layer=lakes&layer=lake-labels>
+    - Direct MapServer request: <http://localhost:5002/?map=/etc/mapserver/lakes.map&mode=map&layer=lakes&layer=lake-labels>
     - Local OpenLayers example: <http://localhost:5001/lakes.html>
 
 ??? JavaScript "lakes.js"
@@ -76,4 +76,4 @@ GEOMTRANSFORM (centerline(densify([shape], 0.1)))
 
 # workaround for https://github.com/MapServer/MapServer/issues/7058
 
--->
+-->
diff --git a/workshop/content/docs/mapfile/lines.md b/workshop/content/docs/mapfile/lines.md
@@ -64,7 +64,7 @@ END
 
 !!! example
 
-    - Direct MapServer request: <http://localhost:5000/?map=/etc/mapserver/lines.map&mode=map&layer=roads>
+    - Direct MapServer request: <http://localhost:5002/?map=/etc/mapserver/lines.map&mode=map&layer=roads>
     - Local OpenLayers example: <http://localhost:5001/lines.html>
 
 !!! tip
diff --git a/workshop/content/docs/mapfile/points.md b/workshop/content/docs/mapfile/points.md
@@ -65,7 +65,7 @@ END
 
 !!! example
 
-    - Direct MapServer request: <http://localhost:5000/?map=/etc/mapserver/points.map&mode=map&layer=pois>
+    - Direct MapServer request: <http://localhost:5002/?map=/etc/mapserver/points.map&mode=map&layer=pois>
     - Local OpenLayers example: <http://localhost:5001/points.html>
 
 ??? JavaScript "points.js"
@@ -119,4 +119,4 @@ If SVG symbols are not appearing, ensure they have a width and height set. You c
     <path fill="currentColor" d="M7.743 21.8h3.485v22.4h5.229V25h5.229v19.2h5.228...
 </svg>
 ```
--->
+-->
diff --git a/workshop/content/docs/mapfile/polygons.md b/workshop/content/docs/mapfile/polygons.md
@@ -50,7 +50,7 @@ CLASS
 
 !!! example
 
-    - Direct MapServer request: <http://localhost:5000/?map=/etc/mapserver/polygons.map&mode=map&layer=buildings>
+    - Direct MapServer request: <http://localhost:5002/?map=/etc/mapserver/polygons.map&mode=map&layer=buildings>
     - Local OpenLayers example: <http://localhost:5001/polygons.html>
 
 !!! tip
diff --git a/workshop/content/docs/outputs/ogcapi-features.md b/workshop/content/docs/outputs/ogcapi-features.md
@@ -76,9 +76,9 @@ The OGC API - Features can be viewed as HTML pages, which are rendered using tem
 
 The services use hierarchical URLs for example:
 
-* The root of the service is at <http://localhost:5000/ogcapi-features/ogcapi/>
-* The feature collections are listed at <http://localhost:5000/ogcapi-features/ogcapi/collections?f=html>
-* The Polygon feature collection is available at <http://localhost:5000/ogcapi-features/ogcapi/collections/pois_polygon?f=html>
+* The root of the service is at <http://localhost:5002/ogcapi-features/ogcapi/>
+* The feature collections are listed at <http://localhost:5002/ogcapi-features/ogcapi/collections?f=html>
+* The Polygon feature collection is available at <http://localhost:5002/ogcapi-features/ogcapi/collections/pois_polygon?f=html>
 
 ## Adding OGC API - Features to OpenLayers
 
@@ -101,8 +101,8 @@ new VectorLayer({
 
 !!! example
 
-    - Direct MapServer request: <http://localhost:5000/ogcapi-features/ogcapi/>
-    - Direct MapServer request: <http://localhost:5000/ogcapi-features/ogcapi/collections/pois/items?f=html>    
+    - Direct MapServer request: <http://localhost:5002/ogcapi-features/ogcapi/>
+    - Direct MapServer request: <http://localhost:5002/ogcapi-features/ogcapi/collections/pois/items?f=html>    
     - Local OpenLayers example: <http://localhost:5001/ogcapi-features.html>
 
 ??? JavaScript "ogcapi-features.js"
@@ -135,7 +135,7 @@ new VectorLayer({
         You need to add `TEMPLATE "void"` to each of the layers you want to make available through the OGC API - Features. 
         [TEMPLATE](https://mapserver.org/mapfile/layer.html#mapfile-layer-template) is a left-over from when HTML templates were used to return features, and allows the layer to be queried. 
 
-    Once setup correctly you should be able to browse the OGC API - Features at <http://localhost:5000/railways/ogcapi/>.
+    Once setup correctly you should be able to browse the OGC API - Features at <http://localhost:5002/railways/ogcapi/>.
 
 ## Possible Errors
 
diff --git a/workshop/content/docs/outputs/tiles.md b/workshop/content/docs/outputs/tiles.md
@@ -45,8 +45,8 @@ new TileLayer({
 
 !!! example
 
-    - Direct MapServer request: <http://localhost:5000/?map=/etc/mapserver/points.map&mode=map&layer=pois>
-    -  MapServer request: <http://localhost:5000/?map=/etc/mapserver/tiles.map&MODE=tile&TILE=0+0+0&LAYERS=countries&TILEMODE=gmap>
+    - Direct MapServer request: <http://localhost:5002/?map=/etc/mapserver/points.map&mode=map&layer=pois>
+    -  MapServer request: <http://localhost:5002/?map=/etc/mapserver/tiles.map&MODE=tile&TILE=0+0+0&LAYERS=countries&TILEMODE=gmap>
     - Local OpenLayers example: <http://localhost:5001/tiles.html>
 
 ??? JavaScript "tiles.js"
diff --git a/workshop/content/docs/outputs/wcs.md b/workshop/content/docs/outputs/wcs.md
@@ -9,22 +9,22 @@ https://mapserver.org/ogc/wcs_format.html
 We'll be using [WCS 2.0](https://mapserver.org/ogc/wcs_server.html#wcs-2-0) for this tutorial.
 
 # GetCapabilities
-http://localhost:5000/?map=/etc/mapserver/wcs.map&SERVICE=WCS&REQUEST=GetCapabilities
+http://localhost:5002/?map=/etc/mapserver/wcs.map&SERVICE=WCS&REQUEST=GetCapabilities
 
 # DescribeCoverage 2.0
-http://localhost:5000/?map=/etc/mapserver/wcs.map&SERVICE=WCS&VERSION=2.0.1&REQUEST=DescribeCoverage&COVERAGEID=dtm
+http://localhost:5002/?map=/etc/mapserver/wcs.map&SERVICE=WCS&VERSION=2.0.1&REQUEST=DescribeCoverage&COVERAGEID=dtm
 
 # GetCoverage 2.0 image/tiff full
-http://localhost:5000/?map=/etc/mapserver/wcs.map&SERVICE=WCS&VERSION=2.0.1&REQUEST=GetCoverage&COVERAGEID=dtm&FORMAT=image/tiff
+http://localhost:5002/?map=/etc/mapserver/wcs.map&SERVICE=WCS&VERSION=2.0.1&REQUEST=GetCoverage&COVERAGEID=dtm&FORMAT=image/tiff
 
 ```bash
 gdalinfo /etc/mapserver/data/raster/54752_dtm_1m.tif
 ```
 
 NoData Value=-9999
-Size is 5000, 5000
+Size is 5002, 5002
 
-curl "http://localhost:5000/?map=/etc/mapserver/wcs.map&SERVICE=WCS&REQUEST=GetCapabilities"
+curl "http://localhost:5002/?map=/etc/mapserver/wcs.map&SERVICE=WCS&REQUEST=GetCapabilities"
 
 !!! tip
 
@@ -47,4 +47,4 @@ gdalinfo output.tif
 
 <!--
 https://openlayers.org/workshop/en/cog/
--->
+-->
diff --git a/workshop/content/docs/outputs/wms.md b/workshop/content/docs/outputs/wms.md
@@ -49,7 +49,7 @@ More details are in [the documentation](https://www.mapserver.org/ogc/wms_server
 
 A sample request for the legend for the `polygons.map` is as follows:
 
-- <http://localhost:5000/?map=/etc/mapserver/polygons.map&service=wms&version=1.3.0&request=GetLegendGraphic&layer=buildings&format=image/png&SLD_VERSION=1.1.0>
+- <http://localhost:5002/?map=/etc/mapserver/polygons.map&service=wms&version=1.3.0&request=GetLegendGraphic&layer=buildings&format=image/png&SLD_VERSION=1.1.0>
 
 !!! tip
 
@@ -63,8 +63,8 @@ A sample request for the legend for the `polygons.map` is as follows:
 
 ## Exercises
 
-1. If you've read this far you deserve to discover one of MapServer's Easter eggs. Try changing the output format to `&format=image/txt`. We'll use the `polygons.map` for the request: <http://localhost:5000/?map=/etc/mapserver/polygons.map&service=wms&version=1.3.0&request=GetMap&layers=buildings&format=image/txt>
+1. If you've read this far you deserve to discover one of MapServer's Easter eggs. Try changing the output format to `&format=image/txt`. We'll use the `polygons.map` for the request: <http://localhost:5002/?map=/etc/mapserver/polygons.map&service=wms&version=1.3.0&request=GetMap&layers=buildings&format=image/txt>
 2. Create a `GetLegendGraphic` request, but for the `points.map` for the `layer=poi`.
-3. Run a [GetCapabilities](http://localhost:5000/?map=/etc/mapserver/polygons.map&service=wms&version=1.3.0&request=GetCapabilities) request for the `polygon.map`. 
+3. Run a [GetCapabilities](http://localhost:5002/?map=/etc/mapserver/polygons.map&service=wms&version=1.3.0&request=GetCapabilities) request for the `polygon.map`. 
    Add various `METADATA` pairs listed in the [Web Object Metadata](https://mapserver.org/ogc/wms_server.html#web-object-metadata) and check its output
    in the `GetCapabilities` response.
diff --git a/workshop/content/docs/setup.md b/workshop/content/docs/setup.md
@@ -67,8 +67,6 @@ Some installation notes for different operating systems:
 ### Mac
 
 * If you are using [Homebrew](https://brew.sh), consider using the [brew Docker formula](https://formulae.brew.sh/formula/Docker)
-* On MacOS Monterey, there is an issue with the port 5000 that is already used and therefore conflicting to the default one used by MapServer. 
-  If you are facing with this error `OSError: [Errno 48] Address already in use` then you need to can disable the *Airplay Receiver* from `System Preference->Sharing` of your MacOS (detailed description in this blog [post](https://progressstory.com/tech/port-5000-already-in-use-macos-monterey-issue/)).
 
 ### Linux
 
@@ -108,7 +106,7 @@ cd /home/getting-started-with-mapserver/workshop/exercises/
 sudo docker compose up
 
 # Test the following URLs in a browser
-# http://localhost:5000
+# http://localhost:5002
 # http://localhost:5001/lines.html
 ```
 
@@ -149,7 +147,7 @@ docker compose down
 ```
 
 Once the containers are downloaded you can test they are running and you can connect to them. Open a web browser
-and navigate to <http://localhost:5000/>. You should see the following message:
+and navigate to <http://localhost:5002/>. You should see the following message:
 
 ```bash
 loadParams(): Web application error. No query information to decode. QUERY_STRING is set, but empty.
@@ -167,4 +165,4 @@ by another program trying to update Ubuntu. Rebooting may fix this, or you can t
 * `docker-desktop : Depends: docker-ce-cli but it is not installable` - you are attempting to install Docker Desktop, but have not yet installed the Docker Engine.
 * `unable to get image 'node:lts-slim': error during connect: in the default daemon configuration on Windows, the docker client must be 
    run with elevated privileges to connect: Get "http://%2F%2F.%2Fpipe%2Fdocker_engine/v1.50/images/node:lts-slim/json": open //./pipe/docker_engine: The system cannot find the file specified.`
-   - you will need 
+   - you will need 
diff --git a/workshop/exercises/README.md b/workshop/exercises/README.md
@@ -10,7 +10,7 @@ navigate to the `workshop/exercises` folder and run the following command:
 docker compose up -d
 ```
 
-This will start a Docker container with MapServer (reachable from the browser at <http://localhost:5000/>), and
+This will start a Docker container with MapServer (reachable from the browser at <http://localhost:5002/>), and
 a Docker container with an OpenLayers development environment (reachable from the browser at <http://localhost:5001/>).
 
 To stop, use the command:
@@ -24,4 +24,4 @@ To connect to the containers to use bash commands you can use the following comm
 ```bash
 docker exec -it mapserver bash
 docker exec -it node bash
-```
+```
diff --git a/workshop/exercises/app/.env b/workshop/exercises/app/.env
@@ -1,4 +1,4 @@
-VITE_MAPSERVER_BASE_URL=http://localhost:5000/?
-VITE_MAPSERVER_OGC_BASE_URL=http://localhost:5000/
+VITE_MAPSERVER_BASE_URL=http://localhost:5002/?
+VITE_MAPSERVER_OGC_BASE_URL=http://localhost:5002/
 VITE_MAPFILES_PATH=map=/etc/mapserver/
-VITE_APP_URL=http://node:5001/
+VITE_APP_URL=http://node:5001/
diff --git a/workshop/exercises/docker-compose.yml b/workshop/exercises/docker-compose.yml
@@ -32,7 +32,7 @@ services:
     image: camptocamp/mapserver:8.4-gdal3.10
     container_name: mapserver
     ports:
-      - 5000:80
+      - 5002:80
     environment:
       MAPSERVER_CONFIG_FILE: "/etc/mapserver/mapserver.conf"
     volumes:
@@ -55,4 +55,4 @@ services:
       sh -c "npm install && npm start"
 
 networks:
-  mynetwork:
+  mynetwork:
diff --git a/workshop/exercises/docker-db-compose.yml b/workshop/exercises/docker-db-compose.yml
diff --git a/workshop/exercises/mapfiles/points.map b/workshop/exercises/mapfiles/points.map
diff --git a/workshop/exercises/mapfiles/wfs.map b/workshop/exercises/mapfiles/wfs.map
