Dime.Scheduler

Dime.Scheduler

  • Overview
  • User
  • Administrator
  • Setup
  • Plugins
  • Back Office
  • Developer
  • Guides
  • News
  • Languages iconEnglish
    • Deutsch

›Installer

Overview

  • Quick start
  • Introduction
  • Download package
  • Activate license

Requirements

  • Server
  • Security
  • Client
  • Back office

Installer

  • All-in-one installer
  • Prerequisites
  • Azure
  • Installation
  • Configuration

Hosting

  • Hyper-V environment
  • Dime.Scheduler on Azure
  • Scaling

Legacy Exchange Connector

  • Overview
  • Installation
  • License
  • Configuration
  • Office 365 Connector Installation

NAV Connector

  • Overview
  • Installation
  • FastTrack

Business Central Connector

  • Overview
  • Installation
  • FastTrack

CRM Connector

  • Overview
  • Setup

Troubleshooting

  • Troubleshooting
  • Installer
  • Exchange connector
  • Planning application
  • Service bus
  • Back office
  • Microsoft Dynamics 365 Business Central
  • Azure
  • Database
  • FAQ

Install Dime.Scheduler

⚠️ Don't forget about the prerequisites and upgrade guide before runnning the installer.

Deployment overview

For this edition of the installer, it is necessary to run the application on the virtual machine itself in order to install Dime.Scheduler. Copy the compressed file to a folder on the target machine. We recommend that you use a short path like C:\ds to avoid any long file path issues down the road.

If you install Dime.Scheduler for the first time on this machine, there is very little you need to do. The default parameters are set according to the best practices, so unless you have a good reason, you can leave them as they are. Or, if you are doing an update, you could load a preconfigured configuration file.

Sections

There are five sections in this installation tab. They are all related to the deployment but they're split up by application.

Installer installation tab

There's one exception: the general section. Cross-cutting configuration elements such as service accounts and ancillary installation steps are gathered here.

Modules

It is our sincere hope that - by the way the user interface is designed - you understand that the installer is modular; you only install what you want to install. In each section, you will find a modules section:

Modules

Depending on the node, some checkboxes are ticked by default. For example, we assume that you want to install the planning application and the connector to Microsoft Dynamics 365 Business Central or Dynamics NAV. The settings can easily be overwritten by changing their values, or by simply loading a preconfigured installation file to overwrite all installation settings.

The subsequent fields and groups are targeted towards the installation of that particular node, and that usually means we need to know about database names, web site names, installation paths and service account names.

Parameters

The deployment areas - more or less - correspond to the following categories:

  • Web site
  • Database
  • Windows Service

General installation parameters

As mentioned in the introduction of this article, there are a few general fields which are used throughout the setup. They can be found in the general tab:

Modules

These fields are picked up by the installers of the applications. For example, instead of copying the database server for each database, you need to fill it out only once. Likewise for the service account: one service account is used to run all Windows Services. This is not mandatory but it facilitates the deployment process dramatically.

Installation folder

This is the path where the Windows Services will be deployed to.

Database server

For on-premise deployments, we have never encountered anyone who has deployed the different Dime.Scheduler databases on different servers. Because of this, you only need to enter the database server once.

Windows Services

Modules

Service account

For on-premise deployments, our advice remains the same: we recommend that you use a service account to run the Windows Services. For cloud-based instances (Azure SQL and Microsoft Dynamics 365 Business Central on Azure), the local administrator account will do just fine. You can use the same credentials as the ones you submitted in the Azure deployment step.

It is important to know that you must use the full name of the user, that is, with the domain. In other words, use this format: VM NAME\USER NAME. For example: ds-iis-vm\dimescheduler.

In addition, you can opt to use the service account to host the web applications as well. Finally, if you hadn't already done so yourself, we can grant logon as rights to the service account so it can be used to host the Windows services.

To deploy the application successfully, you need to modify the following configuration items in this section:

  • Service account credentials
Use service account to host web applications

When set to true, the service account will be used to host the application pool instead of the traditional ApplicationPoolIdentity.

Grant service account Logon As right

When set to true, the service account will be granted the "Logon As" permission on this computer.

Other configuration

Install Google Chrome

To make local internet access easier and faster, we provide the option to install Google Chrome on this machine. Obviously, this option is entirely optional. But we prefer Google Chrome to our fallen hero, Internet Explorer 11, on the server.

Deploy planning application

The parameters are divided in the following distinct areas:

Installer installation tab

To deploy the application successfully, you need to modify the following configuration items:

  • The database connection strings in case you use Azure SQL databases, or the database server and database names in case of on-premise SQL databases.

Obviously, the other fields may be modified too. However, leaving them unmodified will not necessarily fail the installation.

The website section is mainly concerned with getting Dime.Scheduler deployed to an IIS website. In addition, it also has two static configuration items: environment and the website base URI.

Modules

If this module is selected, the installer will handle the entire website deployment process, that involves the installation of the web deploy framework, creation of event log sources, IIS application pool, IIS Website, and the planning web application itself.

Website

Planning application IIS Website name

This is the name of the IIS website and application pool.

Environment

This value sets the environment variable of this deployment. The environment variable allows for multiple instances of the Dime.Scheduler planning applications on the same machine. With this variable, the back office knows what to do.

Planning application website port

This is the port of the planning web application.

Add inbound firewall rule for planning application

When set to true, an inbound firewall rule will be added for the port.

Planning application website folder

The absolute path of the website directory.

Enable IIS Windows Authentication

When this switch is turned on, Windows Authentication for the website will be switched on:

Windows Authentication

If necessary, the script will automatically adjust the feature delegation of "Authentication - Windows" to Read/Write:

Read/Write Windows authentication

Remove default website port bindings

This flag is particulary useful for brand new web servers. By defualt, the "Default Web Site" uses the :80 port. By switching on this flag, the installer will remove the :80 port binding from any website that uses this and will assign them to the Dime.Scheduler website that you are about to deploy.

Database

If this module is selected, the installer will automatically download and install the bits and bytes to deploy databases (i.e. SQLPackage).

You have two options here: you either use Azure SQL databases or use an on-premise database server.

Azure SQL configuration

After deploying the database, a default login will be created to access Dime.Scheduler [1]. Use the following credentials to log in:

  • Username: admin
  • Password: Admin!1

Warning: Mind the casing if your SQL database has a case sensitive collation.

Azure SQL

If you decide to use Azure SQL databases, make sure you don't forget to tick the checkbox in the Azure SQL database header; otherwise the local database option will be used. The only values you need to provide here are the database connection strings. To do this, head back to the portal, locate your resource group and select a database.

Click the 'Show database connection strings' link:

Azure SQL connection string

Copy the connection string to your clipboard. However, this connection string is not yet complete: make sure to replace the {your_password} with the password of the administrator credentials that you submitted in the Azure deployment step.

Azure VM DNS name

Paste the connection string in the corresponding text field in the installer. If you used the default database names, then you can paste the same connection string in both text fields. You only need to modify the catalog: the first text field should indicate 'ds-sqldb' whereas the second should show 'ds-sqldb'.

If you used the Azure deployment installer, you don't need to do any security configuration: the virtual machine is able to connect to the Azure SQL databases.

Dedicated SQL server

If you select the on-premise database option, we will create the connection string for you. Provided that you filled out the database server and the database name, we'll take care of the rest.

Deploy back office

Both back office and most other plugins have the same setup. Both applications are plugins to back office systems and as such they also have the same installation procedure.

Modules

If this module is selected, the installer will handle the entire website deployment process, that involves the installation of the web deploy framework, installation of the ASP.NET Core Windows Hosting Bundle, creation of event log sources, IIS application pool, IIS Website, and the back office web application itself.

Website

Back Office IIS Website name

This is the name of the IIS website and application pool.

Back Office website port

This is the port of the back office web application.

Add inbound firewall rule for Back Office

When set to true, an inbound firewall rule will be added for the port.

Back Office website folder

The absolute path of the website directory.

Database

If this module is selected, the installer will automatically download and install the bits and bytes to deploy databases (i.e. SQLPackage). You have two options here: you either use Azure SQL databases or use an on-premise database server.

Azure SQL configuration

After deploying the database, a default login will be created to access this plugin [1]. Use the following credentials to log in:

  • Username: backoffice@dimescheduler.com
  • Password: Admin!1

Warning: Mind the casing if your SQL database has a case sensitive collation.

Azure SQL

If you decide to use Azure SQL databases, make sure you don't forget to tick the checkbox in the Azure SQL database header; otherwise the local database option will be used. The only values you need to provide here are the database connection strings. To do this, head back to the portal, locate your resource group and select a database.

Click the 'Show database connection strings' link:

Azure SQL connection string

Copy the connection string to your clipboard. However, this connection string is not yet complete: make sure to replace the {your_password} with the password of the administrator credentials that you submitted in the Azure deployment step.

Azure VM DNS name

Paste the connection string in the corresponding text field in the installer. If you used the default database names, then you can paste the same connection string in both text fields. You only need to modify the catalog: the first text field should indicate 'ds-sqldb' whereas the second should show 'ds-bo-sqldb'.

If you used the Azure deployment installer, you don't need to do any security configuration: the virtual machine is able to connect to the Azure SQL databases.

Dedicated SQL server

If you want to use your own on-premise SQL database, the procedure is almost the same: we just need the database server and database names and we'll assemble the connection string for you. The database server can be found in the general section.

Deploy Exchange connector

This tab is only concerned with the Office 365 Exchange connector. The on-premise Exchange connector still needs to be deployed separately.

This tab is an extension of the main installation tab and as such, it is included in the installation process. The look and feel is identical: it is divided in a modules section and parameters section.

Before the Office 365 Exchange connector can be deployed, the administrator must ensure that an application is registered on Azure AD with Calendar Read/Write permissions of the Graph API. Only then will the administrator be able to obtain the application's id and secret. If Azure AD authentication is used for Dime.Scheduler, the same application can be used.

This guide walks you through the process of creating an application on Azure. However, this tutorial demonstrates the setup of Azure AD authentication; make sure to select "Calendars.Read/Write" instead of "User Read".

Exchange modules

What is selected in the modules determine which values in the parameters section are picked up and used during the deployment.

There are three elements in the Exchange connector: a web application, database and windows service:

Exchange configuration

Exchange parameters

The subsequent parameter groups also reflect this architecture:

Exchange configuration

The following configuration parameters are available in the installer:

SectionNameDefault valueIs default value compatible
WebsiteIIS Website nameDime.Scheduler.Exchange✔️
WebsiteWebsite port82✔️
WebsiteAdd inbound firewall rule✔️✔️
WebsiteWebsite folderC:\inetpub\wwwroot\DimeSchedulerExchange✔️
DatabaseDime.Scheduler Exchange database nameDime.Scheduler.Exchange✔️
DatabaseDime.Scheduler Exchange connection stringEmpty✔️
❌ when Azure SQL is selected
Windows ServiceClient IDEmpty❌
Windows ServiceTenant IDEmpty❌
Windows ServiceClient SecretEmpty❌
Windows ServiceUse categoryfalse✔️
Windows ServiceCategory presetEmpty❌

Exchange website and database

The configuration is almost identical to the other plugins. See here for more information.

Bi-directional synchronization: Dime.Scheduler to Exchange

To notify Exchange of changes in Dime.Scheduler, we need the following information:

  • The client id of the Azure AD application
  • The client secret of the Azure AD application
  • The tenant id

These items are boilerplate and are necessary for most Azure AD applications.

In addition, you can pick a category to label appointments from Dime.Scheduler. If the "Use Dime.Scheduler category" checkbox is checked, the value in the "Category preset" will be used to mark Dime.Scheduler appointments:

Exchange category

Load and save installation parameters

In the installation tab, you will find two buttons in the top right corner of the window:

Save and load

These buttons allow you to save and load installation files. For example, if you installed Dime.Scheduler for the first time with your new customer, you can save the settings to a file and use those settings the next time you do an update of the application.

Save and load

⚠️ The configuration files are stored in plain text. This includes passwords and other sensitive information.


  1. We cannot urge you enough to change the password as soon as possible, especially when the web application is out in the open. ↩ ↩

Last updated on 1/3/2021 by Hendrik Bulens
← AzureConfiguration →
  • Deployment overview
    • Sections
    • Modules
    • Parameters
    • General installation parameters
  • Deploy planning application
    • Website
    • Database
  • Deploy back office
    • Website
    • Database
  • Deploy Exchange connector
    • Exchange modules
    • Exchange parameters
  • Load and save installation parameters
Dime.Scheduler
Manuals
  • User Manual
  • Administration
  • Installation
  • Guides
Essential links
  • Getting Started
  • FAQ
  • Get support
  • Privacy Statement
Useful resources
  • Dime.Scheduler
  • Company website
  • GitHub
Community
  • LinkedIn
  • Youtube
  • Facebook
  • Twitter

Copyright © 2021 Dimenics