Skip to content

Latest commit

 

History

History
74 lines (57 loc) · 2.98 KB

index.md

File metadata and controls

74 lines (57 loc) · 2.98 KB
title uid description author so.date keywords so.topic so.envir
Service configuration
service_configuration
Description of Service configuration
Bergfrid Dias
12.12.2021
service, config, nsEndPoint
concept
onsite

Core configuration of Service

Used for connecting to NetServer, the database, and putting your service installation in maintenance mode.

Example service.config file

dbHost = localhost
dbUsername = crm7
dbPassword = password
dbDatabase = SuperOffice
dbType = mssql
nsUser = ejSysUser
nsPass = cpbtrzdo
nsAnonUser = ejSysUser
nsAnonPass = cpbtrzdo
nsEndPoint = http://localhost/NetServer/Services88
defaultContact = 2
#frozen

Configuration settings

If a configuration setting is prefixed by a #, it means it is commented out and will not be read by the system. This is mostly used for the frozen setting.

Name Description
dbHost IP address or resolvable hostname of your database server.
dbUsername Username for connecting to the SuperOffice database.
dbPassword Password for the username used when connecting to the SuperOffice database.
dbDatabase Name of the ODBC source for database connection.
dbType Type of database, for example, MSSQL or Oracle.
nsUser Username for connecting to NetServer. This username defaults to ejSysUser and has a randomly generated password upon installation.
nsPass Password for nsUser.
nsAnonUSer Same as above, but used for anonymous access
nsAnonPass Same as above, but used for anonymous access
nsEndPoint Resolvable URL for your NetServer installation.
defaultContact Should always be the ID of the company owner card in your crm7.contact table. In most scenarios, 2 (SuperOffice has ID 1), but in some older installations, the owner card can be 1.
frozen Takes no parameters, but when not commented out it sets Service in maintenance.

nsUser

The nsUser needs to have the type "System user" and an "Active" login under Users > Other users in your admin client. The "Other users" type is accessible only when logging into the web admin client with a system user (crm7).

You might want to change this password if you had to recreate your Service installation and the newly randomized password in the config file is not identical to the one stored in the database.

nsEndPoint

Running upgrade.exe will automatically set the correct Services version.

Note

Service still does not support running HTTPS on the NetServer it uses. See our recommended scenario #2 on how to use a reverse proxy to secure the installation but make sure the endpoint for Service inside is using HTTP.

frozen

This setting is valuable when you want to avoid having users logging/being logged in when you have scheduled/announced an update/maintenance.

Always remember to remove this or comment it out after you have completed your maintenance.