Set up a map server

The following sample procedure describes how to install and configure a map server using the open-source Java Runtime Environment (JRE) and an open source map server called GeoServer. The procedure is intended only as an example to show the typical workflows to configure a web-based map server. You can use these products or other open source or commercial products as your local map server to save map data that will be shown by the MapApp.

After you have set up your local map server and saved your desired source maps to it, you must configure the MapApp map sources to point to the maps' locations on the local server, not to the original providers' web sites. See Map provider properties for information on defining map sources.

Note: For users to be able to view map data when connecting from another domain, you must enable Cross-Origin Resource Sharing (CORS) on the map server. CORS allows a JavaScript on one server to access resources on another server. This can be a security risk, so most servers disable CORS to reduce the likelihood of malicious scripts accessing resources on the server. Be sure to consider all of the security implications of enabling CORS before deciding whether to do so.

To configure a map server

This is a sample procedure only. You can use any available map server product that fits your needs.

1. Install a 64-bit version of Java Runtime Environment (JRE).

2. Install GeoServer and locate the folder path to the JRE.

   

3. Accept the default data directory.

   C:\Program Files (x86)\GeoServer 2.15.0\data_dir

4. Set the username and password of the GeoServer administrator.

   The default administrator username and password are admin and geoserver.

5. Set the GeoServer web server port, which is 8080 by default.

6. Select the Run manually option for the type of installation.

7. Select Install to start installing the map server.

8. Select Finish to end the installation procedure.

9. Start GeoServer.

   You can find the Start GeoServer option in the Windows Start Menu, or you can run startup.bat in the GeoServer folder(such as C:\Program Files (x86)\GeoServer 2.15.0\bin).

10. Open a web browser and log on to the GeoServer administrator page using your administrator credentials.

    http://localhost:8080/geoserver/web

    

11. Select Users, Groups, Roles from the Security area in the left column of the administrator page.

12. Select Add new user from the Users, Groups, and Roles page.

13. Add a new user who is a member of a credential group and save your changes.

    

14. Move the available roles assigned to the credential user to the Selected Roles field.

    

15. Select Authentication from the Security area of the administrator web page.

16. Select default from the Filter Chains area of the Authentication web page.

    

    The Filter chain web page opens.

17. Move anonymous” to the Available list.