Installation and Deployment

This section explains on how to install and deploy the Syncfusion User Management Server.

Download Setup

You can get the User Management Server setup from {Deployed_Location}\Dashboard Server\DashboardServer.Web\UserManagementServer

By default, the Syncfusion Dashboard Server is deployed in C:\Syncfusion.
For example: C:\Syncfusion\Dashboard Server\DashboardServer.Web\UserManagementServer

Installation

This topic details the steps required to install the User Management Server.

To learn about the system requirements needed to deploy the User Management Server in your business environment, see System Requirements.

Run the User Management Server Installer in Run as administrator mode.

Installation Step 1

You can check the License Agreement of User Management Server by clicking on the License Terms and Conditions.

After you read the license agreement, click on Next to select the installation server type, location and the port number on where the user management server has to be hosted.

We have provided the user management Server to be hosted into the following two web server types

  1. IIS Express
  2. IIS

IIS Express

Installation Location and IIS Port Changes

IIS

Need to provide the Port number, Location and Site Name to host the User Management Server into the IIS.

Installation Location, IIS Port Changes and Site Name

User Management Server will be installed with the below components in the mentioned installation location.

  • User Management Server web application
  • Scheduling Service

After click on Next, you could check the additional tasks as shown below, which the setup would like to perform while installing, in the last screen and click on Install.

Additional Settings while install

Once you clicked Install, installation of User Management Server will start like below,

User Management Server Installation

Once the installation completes you can start the User Management Server by checking the Start User Management Server and click on finish.

Start User Management Server

Or you can also start the user management server from the shortcuts available in the desktop.

Desktop shortcuts will be provided for starting and stopping the user management server.

NOTE

User Management Server does not support multiple versions installed on the same machine.

NOTE

User Management Server cannot be downgraded to the previous version.

Deployment

  • User Management Server web application opens in your default browser with the specified port number at http://localhost:[port_number]/

We have shipped two utilities with the User Management Server to host the application in IIS and in IIS Express.

Host as website in IIS Express

  1. Run the program ConfigureUserManagementServerIISExpress.exe from the following deployed location to host the user management server in IIS Express.

    C:\Syncfusion\UMS\Utilities\UserManagementServerIISExpress\ConfigureUserManagementServerIISExpress.exe

    Host UMS in IIS

    Note: By default, it will show a random port number. An unused port can also be chosen to host in that port.

  2. Click Submit and this program will host the application in IIS Express and User Management Server application will be launched in browser.

Host as website in IIS

User Management Server can also be hosted in IIS by following the below steps.

  1. Run the program ConfigureUserManagementServerIIS.exe from the following deployed location to host the user management server in IIS

    C:\Syncfusion\UMS\Utilities\UserManagementServerIIS\ConfigureUserManagementServerIIS.exe

    Host UMS in IIS

  2. Type in a unused port for the User Management Server as like in the above image. This program will host the application in IIS and the User Management Server can be opened from the browse button in the IIS.

    Host UMS in IIS

Host as Application in IIS

User Management Server can also be hosted as Application in IIS by following the below steps.

Add User Management Server as application

Right click the Website hosted in IIS and choose Add Application as below figure.

Host UMS as application in IIS - Add Application

And Fill the following details as below figure

  1. Alias name
  2. Application pool
  3. Physical path

Host User Management Server as application in IIS - Add Application

Convert the sub folders as application

We have the following folders to be converted as application.

  1. API
  2. WindowsAuthentication

Right click the folder and choose Convert to Application as below figure

Host User Management Server as application in IIS - Convert to sub Application

SSL

To enable SSL for the User Management Server application, you will need a valid SSL certificate. Please check the below link on how to Obtain an SSL certificate and install it to a website in IIS.

http://www.iis.net/learn/manage/configuring-security/how-to-set-up-ssl-on-iis

NOTE

If you want to access User Management Server from a different machine to the one it’s installed on, use the URL http://machine_name:[port_number] or http://machine_ip_address:[port_number]