---
name: "sge_usermapping"
section: "5"
platform: "linux"
package: "gridengine-common"
version: "6.2u5-7.1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/sge_usermapping"
---

# sge\_usermapping(5)

user mapping entry file format

## NAME

usermapping - user mapping entry file format

## DESCRIPTION

A usermapping entry is used to define alias names for a cluster  user. The user's name known by the scheduling system is known as the cluster user. If the cluster user doesn't match the user account name on an execution host, the usermapping feature can solve the problem.

Each line in the usermapping entry file specifies a user name and the host(s) where he has an account.

A list of currently configured user mapping entries can be displayed  via the [*qconf*(1)](/qconf/1.md) **-sumapl** option. The contents of each enlisted user mapping entry  can be shown via the **-sumap** switch. The output follows the *usermapping* format description. New user entries can be created and existing can be modified via the **-aumap**, **-mumap** and **-dumap** options to [*qconf*(1)](/qconf/1.md).

## FORMAT

A user mapping entry contains two parameters:

### cluster\_user

The cluster\_user keyword defines the cluster user name. The rest of the textline after the keyword "cluster\_user" will be taken as cluster user value.

### remote\_user

The user name on an execution host. Please note that the value for this attribute might be overwritten for a certain hostgroups or single host. Find an example below.

## EXAMPLE

This is a typical user mapping entry for a cluster user mapping:

cluster\_user   peter

remote\_user    peter,\[@linux=pet1\],\[fangorn=peter1\]

The entry will map the user peter which is defined in the cluster system to the user peter on all hosts in the cluster except for all hosts which are referenced in the hostgroup @linux. For all these hosts the user will be mapped to pet1. For the host fangorn the remote user will be peter1. *hostgroup*(5) to obtain for more information about that.

## SEE ALSO

[*qconf*(1)](/qconf/1.md), *hostgroup*(5).

## COPYRIGHT

See [*sge\_intro*(1)](/sge_intro/1.md) for a full statement of rights and permissions.