Motivation:

The Gridmap file plugin is redundant because the Multimap Plugin does the same as per Issue #7659 "drop gridmap-file support".

Modification:
remove:
GridMapFilePlugin
GridMapFileParser
GridMapFileParserTest

Edit the documentation and config files accrodingly.

Add a simple script for gridmap > multimap file conversion to the documentation

Result:
Redundant plugins have been removed.
The removal is documented

Fixes: #7659
Target: master

Author: lens161

docs/TheBook/src/main/markdown/config-gplazma.md

@@ -733,24 +733,6 @@ The GP2-AUTHZDB takes a username and maps it to UID+GID using the `storage-authz
    Default: `/etc/grid-security/storage-authzdb`
 
 
-
-##### GridMap
-
-> DEPRECATED: The `grid-mapfile` plug-in is deprecated and will be removed in a future release.  Use the `multimap` plugin instead.
-
-The `grid-mapfile` plug-in takes a GRID DN and maps it username using the **grid-mapfile** file.
-
-
-
-Properties
-
-**gplazma.gridmap.file**
-
-   Path to `grid-mapfile`
-   Default: `/etc/grid-security/grid-mapfile`
-
-
-
 ##### vorolemap
 
 > DEPRECATED: The `vorolemap` plug-in is deprecated and will be removed in a future release.  Use the `multimap` plugin instead.
@@ -1976,27 +1958,14 @@ passwd testuser ae39aec3 read-write 12345 1000 / /
 
 There are many more commands for altering the kpwd-file, see the dcache-script help for further commands available.
 
-### The gridmap plug-in
-
-Two file locations are defined in the policy file for this plug-in:
-
-    # grid-mapfile
-    gridMapFilePath="/etc/grid-security/grid-mapfile"
-    storageAuthzPath="/etc/grid-security/storage-authzdb"
-
-#### Preparing the `grid-mapfile`
-
-The `grid-mapfile` is the same as that used in other applications. It can be created in various ways, either by connecting directly to VOMS or GUMS servers, or by hand.
+### The grid-map plug-in
+The gridmap plug-in has been removed. Please migrate to the multimap plug-in instead.
+For conversion of old gridmap files please use the script below:
 
-Each line contains two fields: a DN (Certificate Subject) in quotes, and the username it is to be mapped to.
-
-Example:
-
-    "/C=DE/O=GermanGrid/OU=DESY/CN=John Doe" johndoe
+```console-user
+sed '/^[# ]*"/s/"\(.*\)" \(.*\)$/dn:"\1" username:\2/' grid-mapfile > multimap-file
+```
 
-When using the `gridmap`, the `storage-authzdb` file must also be
-configured. See [the section called
-“storage-authzdb”](config-gplazma.md#storage-authzdb) for details.
 
 ## gPlazma specific dCache configuration
 

modules/gplazma2-grid/src/main/java/org/dcache/gplazma/plugins/GridMapFileParser.java

@@ -3,10 +3,6 @@
         <name>vorolemap</name>
         <class>org.dcache.gplazma.plugins.VoRoleMapPlugin</class>
     </plugin>
-    <plugin>
-        <name>gridmap</name>
-        <class>org.dcache.gplazma.plugins.GridMapFilePlugin</class>
-    </plugin>
     <plugin>
         <name>authzdb</name>
         <class>org.dcache.gplazma.plugins.AuthzDbPlugin</class>

modules/gplazma2-grid/src/main/java/org/dcache/gplazma/plugins/GridMapFilePlugin.java

@@ -13,7 +13,7 @@
 /**
  * A {@link GPlazmaMappingPlugin} converts {@code user@DOMAIN.COM} to {@link UserNamePrincipal}
  * corresponding to {@code user} ( without domain ).  For more complex mappings, like {@code
- * remte-user@DOMAIN.COM} to {@code local-user}, {@link GridMapFilePlugin} can be used.
+ * remte-user@DOMAIN.COM} to {@code local-user}, {@code GplazmaMultiMapPlugin} can be used.
  * <p>
  * To enable, add following likes into gplazma.conf:
  * <pre>

modules/gplazma2-grid/src/main/resources/META-INF/gplazma-plugins.xml

@@ -137,9 +137,6 @@ gplazma.authz.loginFailure.cache-size-expiry=1
 #         Properties for gPlazma plugins
 #  -----------------------------------------------------------------------
 
-#  ---- Path of the grid-mapfile file
-gplazma.gridmap.file=${dcache.paths.grid-security}/grid-mapfile
-
 #  ---- Path of the multi-map file
 gplazma.multimap.file=${dcache.paths.etc}/multi-mapfile