UM : Deployment Process

Prerequisites

1. Download A-StackPrime from build server. Build Server : http://builds.atomiton.com:443/fid-buildserverui/index.html#/dashboard
2. Check out User Management package from TQLModels/Products/frameworks/usermanagement (REL-1.1.7).
3. Download application on which user management will be used.

Setup steps

1. Install latest A-Stack Prime. 
   Unzip A-Stack Prime package. Change below fields in sff.local.config.xml :

   Update sff.local.config.xml

   <sff.server.port>9090</sff.server.port>
   <sff.tls.truststore.file>/lib/security/cacerts</sff.tls.truststore.file>
   <sff.local.deploy>;resources/hellotql/deploy;resources/usermanagement/deploy;</sff.local.deploy>

   sff.server.port : <port_number on while application will run>, e.g <9090>
   sff.tls.truststore.file : provide the cacerts path, /lib/security/cacerts
   sff.local.deploy : ;resources/<app_name>/deploy;resources/usermanagement/deploy;

2. Put usermanagement and application package inside /resources folder. And, update sff.local.config.xml, provide exact application name in sff.local.deploy. Note : application should deploy first.

3. Update config in usermanagement and provide application details.

   usermanagement.config

   <Configuration>
   	<ApplicationList>
   		<Application>
   			<appId>HelloTQL</appId>
   			<appName>HelloTQL</appName>
   			<appfacetIdName>M3KDILWXAAAAUCYMFBCDBGNY</appfacetIdName>
   			<appWSFacetIdName>M3KDILWXAAAAUCYMFBCDBGNYWS</appWSFacetIdName>
   			<appKey>M3KDILXXAAAAUCYMFDONNFDG</appKey>
   			<appServer></appServer>
   			<appPort></appPort>
   		</Application>
   	</ApplicationList>
   </Configuration>

4. Update GenericTQLInterface mqp file for application. Use the custom mqp file provided in usermanagement package.

5. Update config in application and provide usermanagement details :

   application.config

   <Configuration>
   	<UM>
   		<appId>UM</appId>
   		<appName>UserManagement</appName>
   		<appServer>localhost</appServer>
   		<appPort>9090</appPort>
   		<proxyFacetID>UserManagement</proxyFacetID>
   	</UM>
   	<Application>
   		<appName>HelloTQL</appName>
   	</Application>
   </Configuration>

6. Put initializeCacheModierForApp.mc.xml file inside application macro folder. 

7. Add hidden model inside application's models file

   hidden model

   	<DataModel Name="HiddenModel">
         <Sid Name="Id"/>
         <String Name="Name"/>
       </DataModel>

8. Start A-Stack by following commands :
   tql -engine -start Path=<path of  A-stack>

Verification

• By default 1 admin user will be created with all ReadWrite access. Login with below credential on : https://{server}:{port}/fid-Authentication/login
  UserName : Admin
  Password : Pass@123