= Login service =
 === Description of parameters used to configure login service ===

server_name – how you access your server externally 

host -  internal server name

port - by default is 5052


 === Example: Orbit parameters: ===

<server_name> => www.orbit-lab.org

<host> =>  internal1.orbit-lab.org

<port> => 5052
These parameters are used in login.yam and to configure apache.

 === login.yaml ===

registration:
        baseURL: 'http://<server_name>/userManagement'

        publicURL: 'http://<server_name>/status/orbit'


 === Apache configuration ===

/etc/apache2/sites-available/default[[BR]]
In order to use proxy you will have to install apache's proxy package and enable it.[[BR]]

{{{
 apt-get install libapache2-mod-proxy-html
 a2enmod proxy
 a2enmod proxy_http

}}}


!ServerName <server_name>

!ProxyPass /status/orbit "http://<host>:<port>/public_html/"

!ProxyPass /userManagement "http://<host>:<port>/login/userManagement"


Note: If you change baseURL and publicURL in login.yaml it is necessary to change corresponding values in apache default file.

/etc/apache2/sites-available/default-ssl

 !ProxyPass /schedule/ http://<host>:<port>/login/ShowScheduler

 !ProxyPass /loginService/ http://<host>:<port>/login/

        <Proxy http://<host>:5052/login/*>

          !AllowOverride None

          order allow,deny

          allow from all

        </Proxy>
       
 === Database ===
To create database run login.sql script file which is attached to this page. Resources table need to be fill out with data manually.

 === Example: ===
INSERT into resources (machid,name,location,rphone,notes,minRes,maxRes) VALUES
('sc1431b400c5f130', 'grid', 'Orbit Facility', '(732) 932-6857', 'Main 400 node grid,30,120)
 * machid – unique resource identifier 
 * name – resource name
 * rphone – phone number
 * notes – resource description
 * minRes – minimal reservation length in minutes
 * maxRes – maximal reservation length in minutes


 === How to access login service ===


1. Scheduler: 
	https://<server_name>/schedule/
	This is how scheduler is mapped in default-ssl. This is not obligatory, so it is possible to change this link. But, it is necessary to keep “/loginService” link name

2. !ControlPanel – for administrators; to View, Approve and Delete reservation, to Administrate Users and Groups etc.
	https://<server_name>/loginService/ControlPanel
	
3. User Registration
	http://<server_name>/userManagement/register
	( userManagement same as one in login.yaml and apache default)
4. !Group/Organization Registration
	http://<server_name>/userManagement/orgReg 
	( userManagement same as one in login.yaml and apache default)


Note:
There is file /usr/share/omf-aggmgr-5.2/omf-aggmgr/public_html/template/ogs_login/orbit_banner.png, used for user management pages. Replace content of that file to show your logo.