Skip to main content
insightsoftware Documentation insightsoftware Documentation
{%article.title%}
Published:
Was this article helpful?
0 out of 0 found this helpful

Appendix B: The Installation Configuration File

If you are using the silent installer option, you may want to modify values provided in the sample configuration file or use values other than (Default) for some of the parameters.

The following tables explain each parameter, its valid values, and its default value.

Note: If using accented characters you must use either ANSI or UTF 16 LE encoding when creating editing the .ini file.

This chapter contains information on these main topics:

Setup parameters

Parameter

Values

Notes

Lang

English

 

Dir

Target folder for installation files

Spaces are not allowed in the path

Group

(Default)

 

NoIcons

0

 

SetupType

Full

 

Components

(Default)=database,executables,web
database - RDBMS

executables – data server

proxy – HTTP proxy server

web – web bridge and client components

Any combination of the values can be specified separated by a comma.

Tasks

 

This parameter is always blank

Instance parameters

Parameter

Values

Notes

InstanceName

(Default) = Longview

from 1 to 32 characters

Any characters except those not supported in windows for directory/folder names / \ ; ? * ' < > | %

InstallType

New

Upgrade

 

InstallLanguages

(Default) = en
en
fr

Any combination of the values can be specified separated by a comma.

Dataserver parameters

Parameter

Values

Notes

LongviewID

(Default) = InstanceName or Longview if the InstanceName does not meet the requirements

from 4 to 32 characters

Alphanumeric and underscore

DataServerHost

(Default) = <Device Name>

For HTTP Proxy server configuration.

DataServer
AdminPort

(Default) = 27999

numeric value between 1025-65535

DataServer
ListenerPort

(Default) = 28000

numeric value between 1025-65535

DataServerWeb
ListenerPort

(Default) = 28001

numeric value between 1025-65535

DataServer
DataSource

(Default) = LongviewIdentifier

from 1 to 32 characters

Alphanumeric and all special characters except for: []{},;?*=!@\<> and space

ApplicationServer

(Default) = <Device Name>

 

Data Server Configuration

Parameter

Values

Notes

DataServerConfigFIle

 

Name of an existing data server configuration file to use

The subsequent data server configuration parameters will be ignored

JAVA_FILENAME

 

Name of the JRE zip file

CLIENT_HTTP_PROXY

 

This parameter specifies the secure listener port URL

(HttpProxyServerListenerPortURL) for your HTTP Proxy Server.
This parameter should only be set if using the Longview HTTP-RPC Proxy

ADMIN_HTTP_PROXY

 

This parameter specifies the secure admin port URL (HttpProxyServerAdminPortURL) for your HTTP Proxy Server.
This parameter should only be set if using the Longview HTTP-RPC Proxy

FILES_CUSTOM_ROOT_PATH

(Default)=<
Dir>/<LongivewID>

This parameter specifies the location of where custom code files will be stored. For example: applications, templates, and workflow

This path cannot be set to the dataservers working directory or a default folder within.

LOCAL_ADMIN_GROUP

 

This parameter specifies a Windows local group to use to start and stop the Longview Servers If the group does not exist the install will create it. It will also assign the user running the install to the group if not already assigned.
This is an optional parameter.

Note: Local Admin Group will not work with a Windows default local group.

SQL SERVER Database parameters

Parameter

Values

Notes

BaseDimensions

(Default) = 8

4 to 16

ScheduleDimensions

(Default) = 3

1 to 8

Partitions

(Default) = 1

1 to 1000

DimensionNames

(Default) = ACCOUNTS|TIMEPER|

ENTITIES|DIMENSION3|…|

DIMENSION7

1 to 31 characters for each dimension name

Alphanumeric characters and underscore

DimensionDescriptions

(Default) = Accounts|Time Periods|Entities|Dimension 3|…|Dimension 7

1 to 100 characters for each dimension description

FrenchDimension
Descriptions

(Default) = Comptes|Période|Entités|
Dimension 3|…|Dimension 7

1 to 100 characters for each dimension description

InstallLanguages parameter must include fr for this parameter to be used.

SQLServerUse
WindowsAuth

(Default)=Yes
Yes
No

 

SQLServerUser

System if using Windows authentication

 

SQLServerPassword

 

Leave blank if using Windows authentication

DBOUser

 

Name of the DBO for the Longview database

The DBO Username cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

DBOPassword

 

Password of the DBO for the Longview database

The DBO Password cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

DatabaseViewUse
DBOAuth

(Default)=Yes

Yes
No

Yes, to use the DBO for view access

DatabaseViewUser

 

Leave blank if using the DBO

DatabaseView
Password

 

Leave blank if using the DBO

DBMS

SQL Server

 

SQLServer
InstanceName

(Default) = <Device Name>

<Device Name>[\Instance Name] if using instance names or the database is on a different device

DatabaseName

(Default) = lvdataserver

The Database Name cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

OnDatabaseExists

(Default)=Terminate
Terminate
Continue

 

RepoPrimaryFile

(Default) = defined by RDBMS

If parameter CloudProviderManaged is set to Yes, then this parameter will not be used

RepoBaseFile

(Default) = defined by RDBMS

If parameter CloudProviderManaged is set to Yes, then this parameter will not be used

RepoDerivedFile

(Default) = defined by RDBMS

If parameter CloudProviderManaged is set to Yes, then this parameter will not be used

RepoLogFile

(Default) = defined by RDBMS

If parameter CloudProviderManaged is set to Yes, then this parameter will not be used

ContainedDatabase

Default=No
No
Yes

Yes, will create the database as a contained database.

CloudProviderManaged

Default=No
No
Yes

Use Yes when creating the  database in an Azure Managed instance.

If this option is set to Yes then the following parameters are not used:

  • RepoPrimaryFile
  • RepoBaseFile
  • RepoDerivedFile
  • RepoLogFile

Longview only supports Azure managed systems.

ORACLE Database parameters

Parameter

Values

Notes

BaseDimensions

(Default) = 8

4 to 16

ScheduleDimensions

(Default) = 3

1 to 8

Partitions

(Default) = 1

1 to 1000

DatabaseServer

(Default) = <Device Name>

 

DimensionNames

(Default) = ACCOUNTS|TIMEPER|

ENTITIES|DIMENSION3|…|

DIMENSION7

1 to 31 characters for each dimension name

Alphanumeric characters and underscore

DimensionDescriptions

(Default) = Accounts|Time Periods|Entities|Dimension 3|…|Dimension 7

1 to 100 characters for each dimension description

FrenchDimension
Descriptions

(Default) = Comptes|Période|Entités|
Dimension 3|…|Dimension 7

1 to 100 characters for each dimension description

InstallLanguages parameter must include fr for this parameter to be used.

OracleUser

 

 

OraclePassword

 

 

DBOUser

 

Name of the DBO for the Longview database

The DBO Username cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

DBOPassword

 

Password of the DBO for the Longview database

The DBO Password cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

DatabaseViewUse
DBOAuth

Yes

No

Yes, to use the DBO for view access

DatabaseViewUser

 

Leave blank if using the DBO

DatabaseViewPassword

 

Leave blank if using the DBO

DBMS

Oracle

 

OracleServiceName

(Default) = <Device Name>

Specify the service name for the Oracle database to connect to

TablespaceName

(Default) = LVDAT

 

TablespaceDirectory

(Default) = defined by RDBMS

 

TablespaceSize

(Default) = 1000

 

DatabaseName

(Default) = lvdataserver

The Database Name cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

OnDatabaseExists

(Default)=Terminate
Terminate
Continue

This setting is used to determine what the installer should do if the DBOUser defined already exists.

OnTableSpaceExists

(Default)=Terminate

Terminate
Continue

 

Web parameters

Parameter

Values

Notes

WebType

Default=(IPC)

IPC
TCP

TCP can only be used when only web is defined for components parameter

WebServerHost

(Default) = <Device Name>

 

WebDirectory

(Default) = C:\inetpub\wwwroot\cgi-bin\<LongviewIdentifier>

 

Longview HTTP-RPC Proxy Server parameters

Parameter

Values

Notes

ProxyDirectory

(Default) = <Dir>\ProxyServers\
<LongviewIdentifier>

 

ProxyClientURL

 

The URL to be set in the HttpProxyServerListenerPortUrl parameter of the Longview.HttpProxyServer.exe.config file.

The URL must end in “/”

ProxyAdminURL

 

The URL to be set in the HttpProxyServerAdminPortUrl parameter of the Longview.HttpProxyServer.exe.config file.

The URL must end in “/”

ProxyServiceName

(Default) = <LongviewIdentifier>Proxy

 

 

Previous sectionNext section
Appendix A: The Server Configuration FileAppendix C: Longview database tables
Published:

Appendix B: The Installation Configuration File

If you are using the silent installer option, you may want to modify values provided in the sample configuration file or use values other than (Default) for some of the parameters.

The following tables explain each parameter, its valid values, and its default value.

Note: If using accented characters you must use either ANSI or UTF 16 LE encoding when creating editing the .ini file.

This chapter contains information on these main topics:

Setup parameters

Parameter

Values

Notes

Lang

English

 

Dir

Target folder for installation files

Spaces are not allowed in the path

Group

(Default)

 

NoIcons

0

 

SetupType

Full

 

Components

(Default)=database,executables,web
database - RDBMS

executables – data server

proxy – HTTP proxy server

web – web bridge and client components

Any combination of the values can be specified separated by a comma.

Tasks

 

This parameter is always blank

Instance parameters

Parameter

Values

Notes

InstanceName

(Default) = Longview

from 1 to 32 characters

Any characters except those not supported in windows for directory/folder names / \ ; ? * ' < > | %

InstallType

New

Upgrade

 

InstallLanguages

(Default) = en
en
fr

Any combination of the values can be specified separated by a comma.

Dataserver parameters

Parameter

Values

Notes

LongviewID

(Default) = InstanceName or Longview if the InstanceName does not meet the requirements

from 4 to 32 characters

Alphanumeric and underscore

DataServerHost

(Default) = <Device Name>

For HTTP Proxy server configuration.

DataServer
AdminPort

(Default) = 27999

numeric value between 1025-65535

DataServer
ListenerPort

(Default) = 28000

numeric value between 1025-65535

DataServerWeb
ListenerPort

(Default) = 28001

numeric value between 1025-65535

DataServer
DataSource

(Default) = LongviewIdentifier

from 1 to 32 characters

Alphanumeric and all special characters except for: []{},;?*=!@\<> and space

ApplicationServer

(Default) = <Device Name>

 

Data Server Configuration

Parameter

Values

Notes

DataServerConfigFIle

 

Name of an existing data server configuration file to use

The subsequent data server configuration parameters will be ignored

JAVA_FILENAME

 

Name of the JRE zip file

CLIENT_HTTP_PROXY

 

This parameter specifies the secure listener port URL

(HttpProxyServerListenerPortURL) for your HTTP Proxy Server.
This parameter should only be set if using the Longview HTTP-RPC Proxy

ADMIN_HTTP_PROXY

 

This parameter specifies the secure admin port URL (HttpProxyServerAdminPortURL) for your HTTP Proxy Server.
This parameter should only be set if using the Longview HTTP-RPC Proxy

FILES_CUSTOM_ROOT_PATH

(Default)=<
Dir>/<LongivewID>

This parameter specifies the location of where custom code files will be stored. For example: applications, templates, and workflow

This path cannot be set to the dataservers working directory or a default folder within.

LOCAL_ADMIN_GROUP

 

This parameter specifies a Windows local group to use to start and stop the Longview Servers If the group does not exist the install will create it. It will also assign the user running the install to the group if not already assigned.
This is an optional parameter.

Note: Local Admin Group will not work with a Windows default local group.

SQL SERVER Database parameters

Parameter

Values

Notes

BaseDimensions

(Default) = 8

4 to 16

ScheduleDimensions

(Default) = 3

1 to 8

Partitions

(Default) = 1

1 to 1000

DimensionNames

(Default) = ACCOUNTS|TIMEPER|

ENTITIES|DIMENSION3|…|

DIMENSION7

1 to 31 characters for each dimension name

Alphanumeric characters and underscore

DimensionDescriptions

(Default) = Accounts|Time Periods|Entities|Dimension 3|…|Dimension 7

1 to 100 characters for each dimension description

FrenchDimension
Descriptions

(Default) = Comptes|Période|Entités|
Dimension 3|…|Dimension 7

1 to 100 characters for each dimension description

InstallLanguages parameter must include fr for this parameter to be used.

SQLServerUse
WindowsAuth

(Default)=Yes
Yes
No

 

SQLServerUser

System if using Windows authentication

 

SQLServerPassword

 

Leave blank if using Windows authentication

DBOUser

 

Name of the DBO for the Longview database

The DBO Username cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

DBOPassword

 

Password of the DBO for the Longview database

The DBO Password cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

DatabaseViewUse
DBOAuth

(Default)=Yes

Yes
No

Yes, to use the DBO for view access

DatabaseViewUser

 

Leave blank if using the DBO

DatabaseView
Password

 

Leave blank if using the DBO

DBMS

SQL Server

 

SQLServer
InstanceName

(Default) = <Device Name>

<Device Name>[\Instance Name] if using instance names or the database is on a different device

DatabaseName

(Default) = lvdataserver

The Database Name cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

OnDatabaseExists

(Default)=Terminate
Terminate
Continue

 

RepoPrimaryFile

(Default) = defined by RDBMS

If parameter CloudProviderManaged is set to Yes, then this parameter will not be used

RepoBaseFile

(Default) = defined by RDBMS

If parameter CloudProviderManaged is set to Yes, then this parameter will not be used

RepoDerivedFile

(Default) = defined by RDBMS

If parameter CloudProviderManaged is set to Yes, then this parameter will not be used

RepoLogFile

(Default) = defined by RDBMS

If parameter CloudProviderManaged is set to Yes, then this parameter will not be used

ContainedDatabase

Default=No
No
Yes

Yes, will create the database as a contained database.

CloudProviderManaged

Default=No
No
Yes

Use Yes when creating the  database in an Azure Managed instance.

If this option is set to Yes then the following parameters are not used:

  • RepoPrimaryFile
  • RepoBaseFile
  • RepoDerivedFile
  • RepoLogFile

Longview only supports Azure managed systems.

ORACLE Database parameters

Parameter

Values

Notes

BaseDimensions

(Default) = 8

4 to 16

ScheduleDimensions

(Default) = 3

1 to 8

Partitions

(Default) = 1

1 to 1000

DatabaseServer

(Default) = <Device Name>

 

DimensionNames

(Default) = ACCOUNTS|TIMEPER|

ENTITIES|DIMENSION3|…|

DIMENSION7

1 to 31 characters for each dimension name

Alphanumeric characters and underscore

DimensionDescriptions

(Default) = Accounts|Time Periods|Entities|Dimension 3|…|Dimension 7

1 to 100 characters for each dimension description

FrenchDimension
Descriptions

(Default) = Comptes|Période|Entités|
Dimension 3|…|Dimension 7

1 to 100 characters for each dimension description

InstallLanguages parameter must include fr for this parameter to be used.

OracleUser

 

 

OraclePassword

 

 

DBOUser

 

Name of the DBO for the Longview database

The DBO Username cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

DBOPassword

 

Password of the DBO for the Longview database

The DBO Password cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

DatabaseViewUse
DBOAuth

Yes

No

Yes, to use the DBO for view access

DatabaseViewUser

 

Leave blank if using the DBO

DatabaseViewPassword

 

Leave blank if using the DBO

DBMS

Oracle

 

OracleServiceName

(Default) = <Device Name>

Specify the service name for the Oracle database to connect to

TablespaceName

(Default) = LVDAT

 

TablespaceDirectory

(Default) = defined by RDBMS

 

TablespaceSize

(Default) = 1000

 

DatabaseName

(Default) = lvdataserver

The Database Name cannot contain the pound sign ( # ), percent sign ( % ), angle brackets ( < > ), forward slash ( / ), colon ( : ), question mark ( ? ), asterisk ( * ), double quotation mark ( “ ) or pipe ( | )

OnDatabaseExists

(Default)=Terminate
Terminate
Continue

This setting is used to determine what the installer should do if the DBOUser defined already exists.

OnTableSpaceExists

(Default)=Terminate

Terminate
Continue

 

Web parameters

Parameter

Values

Notes

WebType

Default=(IPC)

IPC
TCP

TCP can only be used when only web is defined for components parameter

WebServerHost

(Default) = <Device Name>

 

WebDirectory

(Default) = C:\inetpub\wwwroot\cgi-bin\<LongviewIdentifier>

 

Longview HTTP-RPC Proxy Server parameters

Parameter

Values

Notes

ProxyDirectory

(Default) = <Dir>\ProxyServers\
<LongviewIdentifier>

 

ProxyClientURL

 

The URL to be set in the HttpProxyServerListenerPortUrl parameter of the Longview.HttpProxyServer.exe.config file.

The URL must end in “/”

ProxyAdminURL

 

The URL to be set in the HttpProxyServerAdminPortUrl parameter of the Longview.HttpProxyServer.exe.config file.

The URL must end in “/”

ProxyServiceName

(Default) = <LongviewIdentifier>Proxy

 

 

Previous sectionNext section
Appendix A: The Server Configuration FileAppendix C: Longview database tables
For an optimal Community experience, Please view on Desktop