Using the Quick Start
Spatial Studio is available as a Java application for trial, development, and testing purposes at no cost under an Oracle Technology Network License Agreement.
Download Spatial Studio Quick Start from Oracle Technical Resources (formerly OTN)
- Oracle Database 12.2+ [NOTE: Spatial Studio requires a database connection]
- Studio repository must include Spatial and Graph
- JDK 8 only 64-bit (update 181 or later)
- Database users for connections having CONNECT, RESOURCE, CREATE VIEW roles and quota in their default tablespace
- Public internet connection to access background map
Installing and Configuring
- Download the Quick Start zip archive OracleSpatialStudio_qs_19.1.0.zip.
- Unzip (extract) it, which results in a directory named Oracle_Spatial_Studio.
- Ensure that the JAVA_HOME environment variable exists on your system, and points to a full JDK installation of Java SE Development Kit 8u181 or later.
- Ensure that the port 4040 is not being used by any other (web) applications. (You can direct Spatial Studio to use different ports, but 4040 is the default HTTPS port for Studio.)
- From a command window (Windows) or terminal (Linux or Mac), go to (cd) the Oracle_Spatial_Studio directory. This directory contains several .bat or .sh files.
- Use start.sh or start.bat to start the application. (On Linux or Mac you may need to ensure that the .sh files are executable by first running the command: chmod u+x *.sh)
Leave the terminal or command window open.
In your browser, go to the URL: https://localhost:4040/spatialstudio
This page will require login. And you will need to add a security exception to
your browser as the Quick Start uses a self-signed SSL certificate. Check the README.txt file found in the Quick Start folder for login instructions and how to change the login id et al. The following considerations apply to using Spatial Studio Quick Start:
- The default port is 4040, but you can change it by editing the file conf/server.json in Oracle_Spatial_Studio. You will need to restart the application after you make the change.
- Spatial Studio Quick Start provides several predefined web user login
accounts in the configuration file conf/jetty-realm.properties. You should change the passwords immediately after you unzip the downloaded Quick Start. Because Spatial Studio Quick Start is intended for personal use, the passwords for the end user accounts are not encrypted. However, all other passwords, such as those used to log into the Spatial Studio metadata schema or for any user-created connections to database schemas, are strongly encrypted everywhere.
- To stop the application, the preferred approach is to start a second terminal or command window, then go to the same Oracle_Spatial_Studio folder and run the stop.bat or stop.sh script.
See documentation for more information.