1SMS Installation Parameters

The following table details all required parameters to install all of the 1Spatial Management Suite components.

Note: If you wish to install one component at a time, rather than the entire suite, please see Installation of 1SMS Components.

Common Settings

Parameter Description Typical Value
WebLogic
WebLogic Home   C:/oracle/Middleware
WebLogic Domain Home This can be an absolute directory or one relative to WebLogic home (relative directories will be converted into absolute directories automatically). user_project/domains
WebLogic 64-bit Domain With SOA Components
Host Host name [machine name]
Port Port number 7001
Protocol

Protocol type to use (t3 or t3s).

Note: If using t3s, you must ensure that the server's certificate(s) are added to the cacerts trust store for the Java version used when WebLogic was installed.

 
Admin Username Admin username for the WebLogic domain.  
Admin Password Admin password for the WebLogic domain.  
Admin Server Name

Name of the WebLogic domain's Administration Server

Note: This should be the same for each domain.

AdminServer
Domain Name Name of the domain sms_domain
Node Manager Machine Name Name of the node manager machine [machine name]
Node Manager Host Host of the node manager localhost
Node Manager Port Port of the node manager 5556
Node Manager Type Type of node manager ssl
WebLogic 64-bit Domain Without SOA Components
Host Host name [machine name]
Port Port number 7001
Protocol

Protocol type to use (t3 or t3s).

Note: If using t3s, you must ensure that the server's certificate(s) are added to the cacerts trust store for the Java version used when WebLogic was installed.

 
Admin Username The username associated with the Administration Server  
Admin Password The password associated with the Administration Server  
Admin Server Name

Name of the WebLogic domain's Administration Server

Note: This should be the same for each domain.

AdminServer
Name Name of the domain sms_domain
Node Manager Machine Name Name of the node manager machine [machine name]
Node Manager Host Host of the node manager localhost
Node Manager Port Port of the node manager 5556
Node Manager Type Type of node manager ssl
Feature Schema
JDBC Connection String

The connection details of the schema in the form jdbc:oracle:thin: @[hostname]:[port]:[service_name]

 
User The username associated with the Feature Schema  
Password The password associated with the Feature Schema  
Security Schema
JDBC Connection String

The connection details of the schema in the form jdbc:oracle:thin: @[hostname]:[port]:[service_name]

 
User The username associated with the Security Schema  
Password The password associated with the Security Schema  
JMS Schema
JDBC Connection String

The connection details of the schema in the form jdbc:oracle:thin: @[hostname]:[port]:[service_name]

 
User The username associated with the JMS Schema  
Password The password associated with the JMS Schema  

1Integrate Interface

Item Description Typical Value
General
Service Port

The port to use to host the 1Integrate interface web service

7004
Listen Address   [machine name]
Server Name

The name of the server to host the 1Integrate interface web service

[server name]
1Integrate Repository
JDBC Connection string

The connection details of the schema in the form jdbc:oracle:thin: @[hostname]:[port]:[service_name]

 
Username

User name for the schema

 
Password

Password for the schema

 
Cache Data
Directory

The location of the cache directory.

When a session is run, a folder is created called "1Integratecache", within which the cache is stored.

Note: This stores the data cache from data read by 1Integrate. This may require large amounts of disk space depending on the size of data being read into sessions and the number of concurrent sessions.

If left blank, this will default to "C:\Users\[user]\AppData\Local\Temp".

C:/1spatial/data

License

The location of the provided product licence file

C:/1spatial/ [licence name].lic
Interface JVM Settings
Initial Heap Size   256MB
Maximum Heap Size   1024MB
Custom Extensions
Include Custom Extensions

Tick this box to include custom extensions.

 
Selected Custom Extensions

Browse for custom extensions to be included.

 

1Integrate Session Queue

Parameter Description Typical Value
General
Number of Nodes

Number of Session Queues to be created (limited by your licence agreement).

2
Service Port(s)

A list of ports that should be used to host the processing services. This can either be a comma separated list or a range, such as 8022, 8023, or 8024-8027.

Ensure the ports are not already in use.

 
Listen Address    

1Integrate Repository

Note: These settings must be entered the same as for the 1Integrate Interface.

JDBC Connection String The connection details of the schema in the form jdbc:oracle:thin: @[hostname]:[port]: [service_name]  
Username User name for the schema  
Password Password for the schema  
Cache Data
Directory

The location of the cache directory.

When a session is run, a folder is created called "1Integratecache", within which the cache is stored.

Note: This stores the data cache from data read by 1Integrate. This may require large amounts of disk space depending on the size of data being read into sessions and the number of concurrent sessions.

If left blank, this will default to "C:\Users\[user]\AppData\Local\Temp".

C:/1spatial/data

License The location of the provided product licence file C:/1spatial/ [licence name].lic
Session Queue JVM Settings
Initial Heap Size

This Initial Heap Size value specifies how much memory a 1Integrate session queue node uses on startup.

If it requires more memory, it will grow up to the Maximum Heap size.

256MB
Maximum Heap Size

This is the maximum amount of Java memory that can be allocated to the 1Integrate Session Queue node.

If this number is too small then very complex or large processes may fail by running out of memory. The amount of memory is required not directly related to the amount of feature loaded (because they are cached to disk) but is related to the size of individual entities being handled, such as restoring large XML backups or processing very large geometries.

1024MB
Custom Extensions
Include Custom Extensions Tick this box to include custom extensions.  
Selected Custom Extensions Browse for custom extensions to be included.  
Clustering
Clustered Select to enable clustering Boolean
Cluster Name Define the name for the cluster of servers A unique identifier for the cluster of 1Integrate servers e.g: "1Int_Cluster"
Cluster Address (optional) The address of the cluster A comma separated list of IP/Host addresses for each cluster member, or a single DNS name that maps to all members.
Cluster Load Algorithm Select the algorithm to be used for load-balancing between the services. round-robin, weight-based, random
Cluster Messaging Mode Select the messaging mode to be used by the cluster. Unicast/
Multicast
Cluster Broadcast Channel (optional) Define the channel that will handle communications within the cluster. String, if nothing is specified the default is used.

1Exchange

Parameter Description Typical value
General
Service Port The port to use to host the 1Exchange web service 7115
Listen Address The listen address of the server, for more information about listen addresses please refer to Oracle Documentation  
Server Name The name of the server on which the application is hosted. There is a 22 character limit. MSExchange
Exchange Repository
JDBC Connection string

The connection details of the Exchange repository. This will be in the form:

jdbc:oracle:thin:@[hostname]:
[port]:[service_name]

 
Username User name for the schema  
Password Password for the schema  
Use Snowflake Components for GML handling
Configure Snowflake Components Select whether 1Exchange is installed with Snowflake components Boolean
Load Balancing
Using Load Balancer See Load Balancing  
Address This is the address of your Load Balancer or the URL location from which to download your packages  
Clustering
Clustered Select to enable clustering Boolean
Cluster Name Define the name for the cluster of servers A unique identifier for the cluster of 1Exchange servers e.g: "1Exchange_Cluster"
Cluster Address The address of the cluster A comma separated list of IP/Host addresses for each cluster member, or a single DNS name that maps to all members.
Cluster Load Algorithm Select the algorithm to be used for load-balancing between the services. round-robin, weight-based, random
Cluster Messaging Mode Select the messaging mode to be used by the cluster. Unicast/
Multicast
Cluster Broadcast Channel Define the channel that will handle communications within the cluster. String, if nothing is specified then the default is used.

1Exchange Snowflake Configuration

Licences
Go Publisher Licence File Location of the license file  
Go Loader Licence File Location of the license file  
GO Loader Repository
JDBC Connection string

The database schema set up for the GoLoader database. This will be in the form:

jdbc:oracle:thin:@[hostname]:
[port]:[service_name]

 
Username User name for the GoLoader schema  
Password Password for the schema  
GO Publisher Repository
JDBC Connection string

The database schema set up for the GoPublisher database. This will be in the form:

jdbc:oracle:thin:@[hostname]:
[port]:[service_name]

 
Username Username for the GoPublisher schema  
Password Password for the schema  
Configuration
Configure GoLoader and GoPublisher Products See GO Publisher and GO Loader  

1Generalise Interface

Parameter Description Typical Value
General
Service Port The port to use to host the interface web service 8100
Listen Address   [machine name]
Server Name The name of the server on which the application is hosted. There is a 22 character limit. [server name]
1Generalise Repository
JDBC Connection string The connection details of the schema in the form jdbc:oracle:thin: @[hostname]:[port]: [service_name]  
Username User name for the schema  
Password Password for the schema  
Cache Data
Directory

The location of the cache directory.

When a session is run, a folder is created called "1Integratecache", within which the cache is stored.

Note: This stores the data cache from data read by 1Integrate. This may require large amounts of disk space depending on the size of data being read into sessions and the number of concurrent sessions.

If left blank, this will default to "C:\Users\[user]\AppData\Local\Temp".

C:/1spatial/data

License The location of the provided product licence file C:/1spatial/ [licence name].lic
Custom Extensions
Include Custom Extensions Tick this box to include custom extensions.  
Selected Custom Extensions Browse for custom extensions to be included.  
Clustering
Clustered Select to enable clustering Boolean
Cluster Name Define the name for the cluster of servers MSExchangeCluster
Cluster Address The address of the cluster A unique identifier for the cluster of 1Generalise servers e.g: "1Gen_Cluster"
Cluster Load Algorithm Select the algorithm to be used for load-balancing between the services. round-robin, weight-based, random
Cluster Messaging Mode Select the messaging mode to be used by the cluster. Unicast/
Multicast
Cluster Broadcast Channel Define the channel that will handle communications within the cluster. String, if nothing is specified the default is used.

1Generalise Processing Nodes

Parameter Description Typical Value
General
Number Of Nodes

The number of processing nodes to install on this machine.

The number of processing nodes depends on the expected load and a license is required for each one.

For a small to medium-sized system, two processing nodes should be sufficient. For larger systems, contact 1Spatial to discuss the correct sizing.

 
Service Port(s)

A list of ports that should be used to host the processing services. This can either be a comma separated list or a range, such as 8022, 8023, or 8024-8027.

Ensure the ports are not already in use.

 
Listen Address    
1Generalise Repository
JDBC Connection String The connection details of the schema in the form jdbc:oracle:thin: @[hostname]:[port]: [service_name]  
Username User name for the schema  
Password Password for the schema  
Cache Data
Directory

The location of the cache directory.

When a session is run, a folder is created called "1Integratecache", within which the cache is stored.

Note: This stores the data cache from data read by 1Integrate. This may require large amounts of disk space depending on the size of data being read into sessions and the number of concurrent sessions.

If left blank, this will default to "C:\Users\[user]\AppData\Local\Temp".

C:/1spatial/data

License The location of the provided product licence file C:/1spatial/ [licence name].lic
Custom Extensions
Include Custom Extensions Tick this box to include custom extensions.  
Selected Custom Extensions Browse for custom extensions to be included.  
Clustering
Clustered Select to enable clustering Boolean
Cluster Name Define the name for the cluster of servers A unique identifier for the cluster of 1Generalise servers e.g: "1Gen_Cluster"
Cluster Address The address of the cluster A comma separated list of IP/Host addresses for each cluster member, or a single DNS name that maps to all members.
Cluster Load Algorithm Select the algorithm to be used for load-balancing between the services. round-robin, weight-based, random
Cluster Messaging Mode Select the messaging mode to be used by the cluster. Unicast/
Multicast
Cluster Broadcast Channel Define the channel that will handle communications within the cluster. String, if nothing is specified the default is used.

1Plan

Parameter Description Typical value
General
Service Port The port to use for 1Plan 7112
Listen Address

The IP address or DNS name the 1Plan server uses to listen for incoming connections.

In a clustered environment, this needs to be unique for each node in that environment. Typically set to the machine name.

 
Server Name

Name of the 1Plan server within WebLogic. There is a 22 character limit.

In a clustered environment, this needs to be unique for each node in that environment.

 
Job Schema
JDBC Connection string

The connection details of the 1Plan repository schema in the form jdbc:oracle:thin: @[hostname]:[port]:[service_name]

 
Username User name for the schema  
Password Password for the schema  
Clustering
Clustered Select to enable clustering Boolean
Cluster Name Define the name for the cluster of servers A unique identifier for the cluster of 1Plan servers e.g: "1Plan_Cluster"
Cluster Address The address of the cluster A comma separated list of IP/Host addresses for each cluster member, or a single DNS name that maps to all members.
Cluster Load Algorithm Select the algorithm to be used for load-balancing between the services. round-robin, weight-based, random
Cluster Messaging Mode Select the messaging mode to be used by the cluster. Unicast
Multicast
Cluster Broadcast Channel Define the channel that will handle communications within the cluster. String, if nothing is specified the default is used.

1Transact

Parameter Description Typical Value
General
Service port The port to use to host the 1Transact web service. 7007
Listen Address    
Server Name The name of the server on which the application is hosted. There is a 22 character limit. MSTransact
Clustering
Clustered Select to enable clustering Boolean
Cluster Name Define the name for the cluster of servers A unique identifier for the cluster of 1Transact servers e.g: "1Transact_Cluster"
Cluster Address The address of the cluster A comma separated list of IP/Host addresses for each cluster member, or a single DNS name that maps to all members.
Cluster Load Algorithm Select the algorithm to be used for load-balancing between the services. round-robin, weight-based, random
Cluster Messaging Mode Select the messaging mode to be used by the cluster. Unicast/
Multicast
Cluster Broadcast Channel Define the channel that will handle communications within the cluster. String, if nothing is specified the default is used.

1Validate Interface

Parameter Description Typical Value
General
Service Port The port to use to host the interface web service 8021
Listen Address   [machine name]
Server Name The name of the server on which the application is hosted. There is a 22 character limit. [server name]
1Validate Repository
JDBC Connection string The connection details of the schema in the form jdbc:oracle:thin: @[hostname]:[port]: [service_name]  
Username User name for the schema  
Password Password for the schema  
Cache Data
Directory

The location of the cache directory.

When a session is run, a folder is created called "1Integratecache", within which the cache is stored.

Note: This stores the data cache from data read by 1Integrate. This may require large amounts of disk space depending on the size of data being read into sessions and the number of concurrent sessions.

If left blank, this will default to "C:\Users\[user]\AppData\Local\Temp".

C:/1spatial/data

License The location of the provided product licence file C:/1spatial/ [licence name].lic
Custom Extensions
Include Custom Extensions Tick this box to include custom extensions.  
Selected Custom Extensions Browse for custom extensions to be included.  
Clustering
Clustered Select to enable clustering Boolean
Cluster Name Define the name for the cluster of servers A unique identifier for the cluster of 1Validate servers e.g: "1Val_Cluster"
Cluster Address The address of the cluster A comma separated list of IP/Host addresses for each cluster member, or a single DNS name that maps to all members.
Cluster Load Algorithm Select the algorithm to be used for load-balancing between the services. round-robin, weight-based, random
Cluster Messaging Mode Select the messaging mode to be used by the cluster. Unicast/
Multicast
Cluster Broadcast Channel Define the channel that will handle communications within the cluster. String, if nothing is specified the default is used.

1Validate Processing Nodes

Parameter Description Typical Value
General
Number Of Nodes

The number of processing nodes to install on this machine.

The number of processing nodes depends on the expected load and a license is required for each one.

For a small to medium-sized system, two processing nodes should be sufficient. For larger systems, contact 1Spatial to discuss the correct sizing.

 
Service Port(s)

A list of ports that should be used to host the processing services. This can either be a comma separated list or a range, such as 8022, 8023, or 8024-8027.

Ensure the ports are not already in use.

 
Listen Address    
1Validate Repository
JDBC Connection String The connection details of the schema in the form jdbc:oracle:thin: @[hostname]:[port]: [service_name]  
Username User name for the schema  
Password Password for the schema  
Cache Data
Directory

The location of the cache directory.

When a session is run, a folder is created called "1Integratecache", within which the cache is stored.

Note: This stores the data cache from data read by 1Integrate. This may require large amounts of disk space depending on the size of data being read into sessions and the number of concurrent sessions.

If left blank, this will default to "C:\Users\[user]\AppData\Local\Temp".

C:/1spatial/data

License The location of the provided product licence file C:/1spatial/ [licence name].lic
Custom Extensions
Include Custom Extensions Tick this box to include custom extensions.  
Selected Custom Extensions Browse for custom extensions to be included.  
Clustering
Clustered Select to enable clustering Boolean
Cluster Name Define the name for the cluster of servers A unique identifier for the cluster of 1Validate servers e.g: "1ValNode_Cluster"
Cluster Address The address of the cluster A comma separated list of IP/Host addresses for each cluster member, or a single DNS name that maps to all members.
Cluster Load Algorithm Select the algorithm to be used for load-balancing between the services. round-robin, weight-based, random
Cluster Messaging Mode Select the messaging mode to be used by the cluster. Unicast/
Multicast
Cluster Broadcast Channel Define the channel that will handle communications within the cluster. String, if nothing is specified the default is used.

1Workflow Settings

Parameter Description Typical value
SOA Server
SOA Server Protocol

The protocol type to be used (http or https).

Note: If using https, you must ensure that the server's certificate(s) are added to the cacerts trust store for the Java version used when WebLogic was installed.

 
SOA Server Name The name of the SOA server.  
SOA Server Host The machine to host 1Workflow localhost
SOA Server Port The port for the SOA service. 7003
SOA Server Username The user name of the SOA server administrator.  
SOA Server Password The password for the SOS server administrator.  
Secure with Oracle Web Services Manager Policies Requires Oracle Web Services Manager license.  
Component WSDLs
1Exchange   http://[server]:7115/soapview/
ExchangeService?WSDL
1Plan   http://[server]:7112/pcs/
JobSoapService?wsdl
1Workflow   http://[server]:7003/soa-infra/services/
default/SMSMainWorkflow/
SMSMainWorkflowClient_ep?WSDL
Worklist   http://[server]:7122/wf/
WorkflowConfigSoapService?wsdl
1Transact   http://[server]:7007/ms-transact-soapview/TransactService?WSDL
1Validate   http://[server]:8021/soap/
ValidationService?WSDL
1Generalise   http://[server]:8100/soap/
GeneralisationService?WSDL
Clustering
Clustered Select if you are deploying 1Workflow to a clustered SOA domain. Boolean
Cluster Name The name of the pre-existing SOA server cluster.  

Worklist Settings

Parameter Description Typical value
General
Service Port The port to use to host the 1Workflow interface web service 7122
Listen Address    
Server Name In a clustered environment, this needs to be unique on each node in the cluster. MSWorkflow
Worklist repository
JDBC Connection string

The connection details of the 1Workflow schema in the form:

jdbc:oracle:thin:@[hostname]:[port]:[service_name]

 
Username User name for the schema  
Password Password for the schema  
Clustering
Clustered Select to enable clustering Boolean
Cluster Name Define the name for the cluster of servers A unique identifier for the cluster of 1Worklist servers e.g: "1Worklist_Cluster"
Cluster Address The address of the cluster A comma separated list of IP/Host addresses for each cluster member, or a single DNS name that maps to all members.
Cluster Load Algorithm Select the algorithm to be used for load-balancing between the services. round-robin, weight-based, random
Cluster Messaging Mode Select the messaging mode to be used by the cluster. Unicast/
Multicast
Cluster Broadcast Channel Define the channel that will handle communications within the cluster. String, if nothing is specified the default is used.