Return to Creating_Domain_Coordinators.tex CVS log

Up to [LON-CAPA] / loncom / html / adm / help / tex

- Document home server restriction which applies to use of add_domain_coordinator_privilege.pl

\label{Creating_Domain_Coordinators}
When LON-CAPA was first installed for a domain, an initial library
server will have been set up, and the command

perl loncom/build/make\_domain\_coordinator.pl will have been run
(as root) in the loncapa-X.Y.Z directory created when the LON-CAPA
tarball was uncompressed. 

This command will have created a new Linux user, who will be filesystem
authenticated when logging into LON-CAPA, and who will have been assigned
the Domain Coordinator role.

A Domain Coordinator can add users to the domain and assign any role
in the domain with the exception of the Domain Coordinator role. To
assign the Domain Coordinator role to other users, someone with root
privileges on a library server in the domain can:

\begin{itemize}
\item run perl make\_domain\_coordinator.pl to create a new user (filesystem
authenticated). make\_domain\_coordinator.pl will fail if:

\begin{itemize}
\item the user already has a Linux account, or 
\item the username is already in use for an existing LON-CAPA user in the
domain.
\end{itemize}
\item assign the Domain Coordinator role to an existing LON-CAPA user by
running the following command in the loncapa-X.Y.Z directory

\begin{itemize}
\item perl loncom/build/add\_domain\_coordinator\_privilege.pl {[}USERNAME:DOMAIN]
{[}DCDOMAIN] 

\begin{itemize}
\item where USERNAME:DOMAIN are the username and domain of an existing user,
who is to be granted Domain Coordinator privileges,
\item DCDOMAIN is the domain to be coordinated. Note: DCDOMAIN must be a
domain for which the server where the command is run is a library
server. Furthermore, the home library server of the user to whom the role is 
to be assigned must be the server where the command is being run.
 
\end{itemize}
\end{itemize}
\end{itemize}