Deploy Oracle Spatial and Graph Map Visualization Component to Oracle Cloud Overview The Map Visualization Component is a development toolkit packaged with Oracle Spatial and Graph for incorporating interactive maps and spatial analyses. This article provides instructions to deploy the Map Visualization Component to the Oracle Cloud. As described in the Map Visualization Component documentation, if you have Oracle Fusion Middleware MapViewer based applications (metadata, application code) you can deploy them to run with the Map Visualization Component. The following steps are included: Create an Oracle Database Cloud Service instance Create an Oracle Java Cloud Service instance Deploy Oracle Map Visualization Component to the Oracle Java Cloud Service The following service acronyms are used: DBCS: Oracle Database Cloud Service JCS: Oracle Java Cloud Service SCS: Oracle Storage Cloud Service Before You Get Started Become familiar with DBCS, JCS, and Oracle Map Visualization Component o DBCS Help Center o JCS Help Center o Map Visualization Component documentation Obtain an Oracle Cloud subscription or trial account including DBCS and JCS o Available at http://cloud.oracle.com Generate SSH key pairs. Instructions are available in the DBCS documentation: o Go to DBCS Help Center o On left side, click Manage Database Deployments o Under Secure Database Cloud Service, click Create SSH (secure shell) key pairs o Note your key files location and passphrase
Create Oracle Database Cloud Service (DBCS) instance A generic DBCS Quick Start tutorial is available here which is a helpful reference for understanding the instance creation flow. However details are slightly different in some steps in order configure the instance for Spatial and the Map Visualization Component. So it s important to follow the steps below. Sign in to your Oracle Cloud account With your account welcome email handy, navigate to at https://cloud.oracle.com/ Select the Data Center listed in your welcome email and click My Services Enter the Identity Domain listed in your welcome email and continue Enter your username and password listed in your welcome email and sign in If this is your first time signing in, follow the instructions to change your password You will be taken to your Dashboard listing your available services: If your services are not listed or if you wish to change which services are listed, click on Customize Dashboard. While configuring backups is optional for DBCS, it is required for a DBCS instance that is associated with JCS. We will choose Storage Cloud Service (SCS) for storing the required backups. Note your Storage Cloud Service (SCS) REST Endpoint: Navigate to the SCS Service Details page: o On the Dashboard, click on the Action Menu in the Storage tile and select View Details
Note the SCS REST Endpoint listed on the Service Details page Click the Dashboard button at the top of the page, then click the Action Menu for Database and click Open Service Console
If this is the first time you visit the Service Console o You will see a Welcome screen with links to tutorials and other learning resources. o When done reviewing these resources, click on Go to Console Click on Create Service Enter values for service
o Enter a service name of your choice o Service Level: Oracle Database Cloud Service o Software Release: Oracle Database 12c Release 2 o Software Edition: Enterprise Edition High Performance or Extreme Performance (editions that include Spatial and Graph) o Click Next Enter values for Details o Enter a database name of your choice o Enter and confirm database administration password o Enter amount of database storage o Select Compute Shape o Enter SSH Public key Click Edit Navigate to the location of your SSH key created earlier Select your public key o Select a backup destination. Cloud Storage Only is being used in this exercise o Enter Cloud Storage Container Enter Cloud Storage Container using your REST endpoint (noted earlier) and a name for your new container o o o Format is [Storage Cloud REST Endpoint]/[new container name] Enter your Oracle Cloud username and password Check the box to Create Cloud Storage Container. This will create a container with the new container name your specified. If desired, under Advanced Settings you select time zone and character set.
Click Next The following screen confirms creation of the Cloud Storage Container for backups and other service creation parameters.
Click Create. To monitor creation status, click the refresh button (circular arrow button to the right of the As of date-time). o It generally takes 20 to 30 minutes to create database resources. Once your service instance is created, click on the service name to view details. In the instance details page, note the Connect String and Public IP of our instance. When you hover over the Connect String a pop-up will appear where you can see the entire connect string Note the connect string and the Public IP as we will need them in later steps.
(Optional) By default, access to most ports are disabled, including 1521 for SQLNET access. If you wish to setup and test SQLNET access we are able to enable ports very easily. Click on the menu next to the database name and select Access Rules Open the rule ora_p2_dblistener to open Port 1521.
Click the Actions menu at the right for ora_p2_dblistener Select Enable Click Confirm when prompted (Optional) If you ve set up access to Port 1521, we ll now confirm access from our local system using SQL Developer. We will not use SQL Developer again in this exercise, but you may want to complete this step so that you have SQL Developer ready to use with DBCS for you scenario. If you do not have SQL Developer, it is available here. Create a new connection Provide a Connection Name For Username, enter system For Password, enter the administrator password you defined when creating the instance For Hostname, enter the Public IP you noted above For Port, enter 1521 For Service name, enter the DBCS service name portion of the connect string you noted above. o The connect string is in the form [instance name]:1521/[service name] Click Test at the bottom and confirm Status : Success at lower left Click Save to save this connection profile Click Cancel and exit SQL Developer
Download the Map Visualization Component EAR file The Map Visualization Component is packaged with Oracle Spatial and Graph. The application archive (EAR file) is called mapviewer.ear and is found on the database server in the folder $ORACLE_HOME/md/jlib. On DBCS with 12.2 release, this location is /u01/app/oracle/product/12.2.0/dbhome_1/md/ jlib. We will now download the EAR file for deployment: Notes on transferring files to/from DBCS is described here In this exercise we use PSCP on Windows o PSCP is the PuTTY Secure Copy client o If not already installed, download and install PuTTY here o PSCP is described here Open a command prompt and change directories to the folder you d like to download into Run the following to download the Map Visualization Component: pscp -P 22 -i "[full path to your key files]\[your private key file]" oracle@[your DBCS Public IP]:/u01/app/oracle/product/12.2.0/dbhome_1/md/jlib/mapviewer.ear./mapviewer.ear o For example: pscp -P 22 -i "c:\keys\my-key.ppk" oracle@120.130.61.117:/u01/app/oracle/product/12.2.0/dbhome_1/md/jlib/mapviewer.ear./mapviewer.ear o When prompted, enter your SSH key passphrase The download is roughly 50MB Confirm that mapviewer.ear is downloaded
Deploy Oracle Java Cloud Service (JCS) instance Return to your browser and click on the Dashboard button to return to the My Services page Click the Action Menu for Java and select Open Service Console. o If you do not see the Java in Dashboard, click in Customize Dashboard and set Java to show. Click Create Service > Java Cloud Service
Service step: o Provide a Service Name and optional Service Description o Select Oracle Java Cloud Service as Service Level, 12.2.1.2 as Software Release, Enterprise Edition as Software Edition o Click Next Details step:
o o o o o o Under WebLogic Configuration Select a Compute Shape For SSH Public Key, click Edit and then Browse to select the Public Key you created earlier For this exercise, we can leave cluster size as 1 Under WebLogic Access, provide a password for the weblogic user (i.e. admin user) Expand Advanced Settings Check the option to Enable access to Administrative Consoles Optionally uncheck the option to Deploy Sample Application Under Database Configuration For Name, select your DBCS instance from the pull-down menu For Administrator Username, enter sys For password, enter the administrator password you chose when creating your DBCS instance Under Load Balancer, leave response as no Under Backup and Recovery For Backup Destination, select Both Cloud Storage and Local Storage Enter a Cloud Storage Container name as we did when creating DBCS instance Enter your cloud account Username and Password Check the box to Create Cloud Storage Container
o Click Next Confirm step o Observe conformation of backup container creation o Verify other settings o Click Create It may take 20 to 30 minutes to create the instance. o To monitor progress, click the refresh button (circular arrow button to the right of the As of date-time) Once the service has been created, click on the service name to view details
Observe details and note the Public IP of our JCS instance
Click the button to the right of your JCS name and select Open WebLogic Server Console You should see the WebLogic Server Console log in page.
Deploy Map Visualization Component to JCS instance A generic deployment tutorial is available here which is a helpful reference for understanding the deployment flow. However details are slightly different in some steps in order configure the Map Visualization Component. So it s important to follow the steps below. In your browser WebLogic Server Console log in page: Log in with the user weblogic and the password you defined when creating the instance. At the top left, click the button Lock & Edit On the left under Domain Structure, click Deployments In the middle under Deployments, click Install Above the Path textbox, click the link to Upload your file(s)
Next to Deployment Archive, click Browse and open mapviewer.ear which you downloaded earlier
Click Next and wait for the upload to complete. o Upload % complete is displayed on the lower left corner of your browser When complete you will see a message indicating upload successful. Click Next Under Choose installation type and scope, leave the default selection ( Install this deployment as an application ) Click Next Under Clusters check the option for All servers in the cluster
Click Next Under General, leave the name as mapviewer Click Next Under Additional Configuration leave default ( Yes, take me to the deployment's configuration screen. ) Click Finish At top left, click button Activate Changes In the middle under Settings for mapviewer, click the tab Control Check the box next to mapviewer Click on the menu Start and select Servicing all requests
Click Yes when prompted to confirm You should now see mapviewer state is Active
Click the tab Testing Under Name, expand mapviewer This shows us the Map Visualization Component URL, where you replace the server name with the JCS public IP Note the port shown in URLs under Test Point is the Managed Server listen port We must open port 9073 in order to access the Map Visualization Component Return to your JCS instance details page Click on the menu to the right of your JCS instance name and select Access Rules
Click the button Create Rule Enter a name, such as port_9073 For Source, select PUBLIC-INTERNET For Destination, select WLS_MANAGED_SERVER For Destination Port(s), enter 9073 Leave Protocol as TCP Click Create
Verify that the new access rule is listed. In a new browser tab, navigate to the Map Visualization Component URL o http://[your JCS Public IP]:9073/mapviewer Log in using user weblogic and the password you defined when creating your JCS instance.
The Map Visualization Component is now deployed to Java Cloud Service and ready to be used with your Database Cloud Service instance for development. Document date 9-28-2017 Contact: david.lapp@oracle.com