Linux Installation

If you are installing 1Data Gateway on Linux, it is released as an executable JAR package.

For installation the following steps must be followed:

1. Un-zip the file 1Data_Gateway_[version_number].zip to a directory on the machine you are installing on.

2. Edit the application.yml file to configure the location of basic configuration parameters:

Parameter	Description	Value
spring	N/A	N/A
datasource	Fill the following to configure which datasource 1Data Gateway will use.	N/A
jdbc url	The URL for the database you have set up for 1Data Gateway.      Note: For SQL servers please refer to external documentation on setting connection properties.	URL
username	The username for the database you have set up.	String
password	The password that has been defined for the database.	String
port	The port number through which the mail server is accessible.	Integer
app	N/A	N/A
mediaManager	Configure media storage below.	N/A
mediaRoot	The root address location for media storage.      Note: If performing an upgrade, do not delete the Media storage directory.	File path
server	Enter the following to define the server port for 1Data Gateway.	N/A
port	The server port on which 1Data Gateway is located.      Note: The default port is 9090.	Integer
SSL	Configure the following to improve security with SSL. You will need to have prepared a keystore which has been loaded with an SSL certificate from a Certificate Authority.
enabled	Set to enable SSL.	Boolean: True or False
key-store-type	Note: 1Data Gateway requires a PKCS12 keystore with a non-blank key alias. For security purposes, we recommend the use of a PKCS12 keystore. For information on using a keytool to create your keystore and certificate, please refer to Oracle JavaSE documentation. If you have an existing keystore with a blank key alias, please also refer to Oracle JavaSE to see how to update the alias.	PKCS12
key-store	The location of the key store.	URI
key-store-password	The password for your keystore.	string
key-alias	The alias of the certificate+private key within the keystore that should be used.	Unique string

Once the configuration file as been defined, perform the following steps:

1. Execute 1datagateway.sh

2. In your chosen browser, proceed to the address http://[machine name]:[port number]

3. Log in to 1Data Gateway using the following credentials:

Login	admin@1spatial.com
Password	admin1

Connecting to 1Integrate

Once you have installed 1Data Gateway, a default connection to 1Integrate is established at:

baseUri	http://localhost:8080/1Integrate/rest/
username	INTWService
password	integrate103

If your 1Integrate installation is different to the default, an administrative user of 1Data Gateway can change them.

To do this, navigate to the 1Integrate Connection tab of the System settings in the 1Data Gateway user interface and change the details as required.