Recommended Installation (Domino environments)

Top  Previous  Next

Once all of the necessary preparation has been completed (see Preparation), then the installation process can is a simple 4 steps.


1.Run the installer.
2.Configure the software.
3.Deal with any Actionable Alerts raised by the install/configuration steps.
4.Connect your first mobile device and provision it.


The recommended path in the installer is the most simple, and it will install the system with the minimum of configuration needed.  Using this path, the following configuration options will be set.


Proxy mode will be set to Internet Proxy (CSC) but can be changed later to Local Proxy or DMZ Proxy mode if required.
A self signed security certificate will be generated during the installation process.
Primary authentication will be set to Lotus Notes Internet Password.
User self registration will be configured.



  Running the Installer

1.Run the installer CommonTime_mSuite_Installer.exe.  If you are prompted with a dialog saying that the publisher cannot be verified, click the Run button to continue with the installation.
2.Click the Next button on the Welcome screen.
3.Accept the license agreement and click the Next button.
4.On the Setup Type screen, check the checkbox "Check this box to include the device and server components required for Lotus Domino integration for Recommended and Custom installations".
5.Select Recommended and then click the Next button.
6.On the Database Choice screen, select Create new database. Note: You can choose Use existing database only if you already have an existing mSuite database.
7.Copy your license key to the clipboard - find the email that contains the license key, drag across the key in the email to select it and use CTRL-C to copy the key to the clipboard.  Make sure that you do not copy any leading or trailing space characters with the key.
8.Now switch back to the install and click the Paste & Verify button - you should now be able to see the serial number of your license and its expiration date.  Because of changes that have been made to product licensing, perpetual licenses now expire 50 years into the future.  Click Next to continue.
9.On the Destination Folder screen, change the Installation folder and the Log folder if necessary.  Click Next to continue.

Note: Logs can take large amounts of space when a system has a large number of users.  Make sure that the logging volume has the necessary space for these logs.  If the volume runs out of space, system behaviour becomes unpredictable and unstable.


10.On the Ready to Install screen, click Install if you are happy with the configuration choices that you have made.
11.The installer will install all of the software, create the configuration database (the repository) and then run the configuration wizard.
12.You can complete the installer by clicking the Finish button.  Continue the installation with the next section - the configuration wizard


   The Configuration Wizard

The configuration wizard supplements the installer.  It determines and configures the settings that cannot be made prior to the software being installed.  It is launched automatically at the end of the installation process.


1.Click Next on the Welcome page.
2.mSuite always creates an administration account, this is always given the username Admin - on the Enter Admin Account Password page, enter and confirm the password to be used for this account.  This password is case sensitive.  Click Next to continue.

Note: Use a strong password that should not be shared or used by other members of the admin team.  You can create more administrators for the system later.  Make sure that you remember the password, this is the master admin account!


3.You will now see the configuration wizard restart all of the services.  The completion page will now be displayed.  Click Finish to complete this process.
4.You may well see a pop-up from the notification area to inform you that you have Actionable Alerts to process.
5.The mSuite Admin Console will be launched to allow you to process the Actionable Alerts.
6.Continue with the next section - Clearing the Actionable Alerts.


   Clearing the Actionable Alerts

See Admin Console layout for an overview of the console if you are not familiar with the Microsoft MMC.

Actionable Alerts are used to highlight configuration problems and also to indicate any required final steps.


1.Expand the Monitoring node in the navigation tree, then expand Alerts, You will now be able to select Actionable Alerts in the navigation tree.
2.The action pane now displays a list of Alerts that need to be processed to get the system fully operational. Note: Leave the Getting Started alert until last.  Process and fix the other alerts first.
3.Select the Extended tab at the bottom of the action pane.
4.Click on the Alert that you want to rectify.  To the left of the alert you will now see the available actions which include some or all of Configure (or Reconfigure), Do Not Run and Ignore.  There is also a description of the problem.  Mostly you will fix these by using Configure or Reconfigure.  Using Ignore or Do Not Run will allow you to get the rest of the system working, but depending on the alert, you will have a degraded or non-operational system.
5.The actions take you through a wizard - follow the instructions to make your changes.  On completion, the affected service will be restarted.  If your configuration is successful, the Alert will disappear from the action pane.
6.The mSuite server will always try to use the Internet Proxy (CSC).  If it has not been able to connect to the CSC, the Proxy connection failure actionable alert will appear.  Select it and click the Reconfigure link to the left of the alert.  On the Welcome screen, click Next then, on the Resolution Options screen, select Reconfigure Settings and click Next.
7.Choose from Use CommonTime switching center, Use enterprise DMZ proxy or Use local proxy and click Next.  If you are not sure which one to choose, please go to Proxy Configurations.
If you chose Use CommonTime switching center, you will then be asked for the Web Proxy Settings.  If you don't use a web proxy, click Next.  If you do use a web proxy, check the box marked Use web proxy and complete all the fields.
If you chose Use enterprise DMZ proxy then, on the DMZ Proxy Settings screen, enter the IP address (or host name) and Port that the mSuite server should use to make a connection to the proxy in the DMZ and click Next.
If you chose Use local proxy then, on the Local Proxy Settings screen, enter the IP address (or host name) and Port that the Proxy should use to listen for incoming connections from mobile devices and click Next.


8.When asked whether to Restart Services, answer Yes.  If the mSuite server is still not able to connect to the proxy, the Proxy connection failure actionable alert will re-appear.  You need to identify and fix the reason for the connection failure and then process the alert again.
9.Once all of the other Alerts have been addressed, it is time to process the Getting Started - Post installation steps alert.  Click on it then click the Configure link that appears to the left of the Alert.
10.Click Next on the Welcome page of the wizard.
11.On the Resolution Options page, select Configure settings (Recommended) and click the Next button.
12.By default mSuite will use Domino Internet Password authentication and user self registration (Automatic User Creation).  In order for this to work correctly, your Domino Directory must have a Group that contains all of the people allowed to use mSuite.  The Create or Select a Domino Group page allows you to select an existing Group from the Domino Directory or create a new Group for this purpose.
13.After creating or selecting the Domino Group, you will be allowed to select users from the Domino Directory and add them to the group.  Once you have selected the users to add to the group, click Next to continue.
14.If you chose to use either a DMZ Proxy or a Local Proxy, you will now see the Outside Host and Port screen.  In the Host and Port fields, enter the hostname (or IP address) and port that will be used by mobile devices to connect to the DMZ or Local Proxy.  This is the public IP address and port that will be used when devices connect to the Proxy via the internet.  This information will be used to configure the Outside connection information in the mSuite settings on the mobile devices.  Click Next.
15.You are now asked if you want to restart the services, if you have made any changes, select Yes.  Click Next to continue.
16.The completion page is now displayed.


   Commissioning the first device

Your mSuite system in now operational.  The final task is to get a mobile device operational:

1.If you are using self registration (automatic user creation), make sure that the device user is a member of the Domino Group that was selected or created during the Getting Started/Post-installation alert.  Otherwise, make sure they have an mSuite account profile.
2.Provision the device by any of the methods mentioned here.






Page url: