Document toolboxDocument toolbox

Installation Process 1

Owned by Matthew Wren
Jan 29, 2024
4 min read

On This Page:


Screenshots Info

The exact screen-shots (figures) shown in this page may vary, depending on the version of software selected for installation.


ServiceManager is installed by executing the ServiceManager_install.exe application, and following the prompts presented by the Setup Wizard.

Installation Process

Please note that the installation process for ServiceManager must be executed from a command line prompt that has been started with administrator privileges.

Step 1: Open Administrator Command Prompt

As noted above, the ServiceManager_install.exe application must be executed from a command line prompt that has been started with administrator privileges (see Fig. 1).

Step 2: Run Installer

From within the command line prompt that has been started with administrator privileges, run the ServiceScheduling_install.exe application. This will display the welcome screen for the Setup Wizard (see Fig. 2).

Click the Next button.


Fig. 1
Fig. 2

Step 3: Select Installation Folder

On the Select Installation Folder screen (see Fig. 3), review (and change, if required) the installation folder that will be used for the ServiceManager installation.

Once the installation folder is set as desired, click the Next button.

Step 4: Select ServicePlanner Data Directory

On the ServicePlanner Configuration screen (see Fig. 4), review (and change, if required) the ServicePlanner data directory that will be used for ServicePlanner's geographic datasets.

Once the ServicePlanner data directory folder is set as desired, click the Next button.

Fig. 3

Fig. 4

Step 5: Set Service and Application Details

On the Service and Application Details screen (see Fig. 5), set the web application name, and SOAP URL and user name that will be used for the ServiceManager installation.

Once the details are set as desired, click the Next button.

Step 6: Select Database Type

On the Database Connection Details screen (see Fig. 6), select the type of database (Oracle or SQL Server) from the dropdown list.

Fig. 5

Fig. 6

Step 7: Set Database Connection Details

Based on the selection of the type of database in Step 6 above, the Database Connection Details screen will display the inputs for the required database connection details for either MS SQL Server (see Fig. 7) or Oracle (see Fig. 8).

Once the details for the database connection are set correctly, click the Next button.

Fig. 7

Fig. 8

Step 8: Ready to Install

At this point, ServiceManager is ready to install (see Fig. 9). This final dialog presents an opportunity to either completely cancel the installation, or to return to the preceding dialogs and update the information previously entered.

When ready, click the Install button to install ServiceManager.

Step 9: Installation Finished

Once the installation of ServiceManager is completed (see Fig. 10), click the Finish button.

Although the ServiceManager application has been installed at this point, the Service Registration, First Execution, and Future Execution steps below must still be completed before ServiceManager will be fully installed.

Fig. 9

Fig. 10

Service Registration

Once ServiceManager has been installed, it must be registered as a Windows Service. See the Execution Environment page for the details on how to do this.

Once ServiceManager has been registered as a Windows Service, do not start ServiceManager from the Windows Services control panel.

The first time ServiceManager is run, it must be run from within a command line prompt that has been started with administrator privileges.

First Execution

Once ServiceManager has been installed and registered as a Windows Service, then ServiceManager must be executed for the first time from within a command line prompt that has been started with administrator privileges.. This is because it is likely that the Windows firewall will be configured to block access to ServiceManager, and that on the first execution of ServiceManager, a prompt will be displayed asking the user to grant access through the firewall. However, if ServiceManager is started as a Windows Service, then this prompt will not be displayed, and so, ServiceManager will fail to start.

See the Execution Environment page for the details on how to do this.

Do not attempt to execute ServiceManager for the first time until after installing ServiceManager as a Windows Service.

Future Execution

Finally, once ServiceManager has been installed as a service, and the first execution of ServiceManager has been performed from within a command line prompt that has been started with administrator privileges, then ServiceManager may be started and stopped as a Windows Service, in the normal way for Windows Services.

See the Execution Environment page for the details.