Document toolboxDocument toolbox

14.1 Configuration Parameter Requirements

On This Page:

As part of the installation process, the following configuration details will be required.

  • The desired installation folder;
  • The desired ServicePlanner data directory;
  • Various service and application details:
    • The desired web application name;
    • The desired SOAP URL and user name;
  • The database connection details.

You will be prompted for all of these details when installing ServiceManager.

Installation Folder

This is the fully qualified directory where ServiceManager will be installed.

By default, this is C:\Program Files\ServicePower, but can be any valid directory location. 

That the actual ServiceManager application will be installed within a sub-directory of the installation folder, entitled ServiceManager.

ServicePlanner Data Directory

This is the fully qualified directory where ServicePlanner will search for geographic datasets.

By default, this is C:\Program Files\ServicePower\ServiceManager\modules\ServicePlanner\data, but can be any valid directory location. 

Service and Application Details

Web Application Name

ServiceManager's web application name forms part of the endpoint URL required to connect to ServiceManager.

By default, the web application name is SERVICEManager. So, if the ServiceManager service was hosted on a server that was accessed via the www.mycompany.com domain name, the ServiceManager URL would be www.mycompany.com:8080/SERVICEManager.

SOAP URL & User Name

ServiceManager interacts with ServiceOptimizer via ServiceScheduling’s SOAP APIs. In order to achieve this connection, ServiceManager needs two specific pieces of information:

  • The endpoint URL of the ServiceScheduling SOAP server; and
  • The database user/schema name to connect to.

It should be noted that the endpoint URL must also include the correct port number at the end of the URL, for example: http://www.mycompany.com:18081. ServiceScheduling's SOAP port number is defined within the sp409_component_ports database table.

Database Connection Details

ServiceManager retrieves most of its data from the ServiceScheduling database. To do this, the ServiceManager installation needs to know the following information:

  • The database type (Oracle or SQL Server); 
  • The connection URL; and
  • The database username and password.

Note that the connection URL differs between Oracle and SQL Server.

Oracle@<server>:1521:<service_name>
SQL Server//<server>;databaseName=<db name>