SQL Developer: Install and Configure for Windows

SQL Developer can be used to create queries that can be used to retrieve data from the Data Warehouse. If the Software Center application is installed on the Windows computer, it can be used to install SQL Developer. The benefit of installing from Software Center is that SQL Developer is preconfigured to work with the Data Warehouse.

If Software Center is not available on the computer, SQL Developer can be manually installed and configured.

SQL Developer requires the Java Development Kit (JDK) version 8 or version 11, also known as JDK 1.8 or JDK 1.11

Verify Proper version of JDK is installed

  1. Click in the search box in the Windows task bar
  2. Start typing Command Prompt
  3. Select Command Prompt application
  4. Type java -version
  5. Press Enter
    1. If JDK is installed, the version will be displayed
      1. The version will be the first line. It should be either 1.8 or 1.11
        1. Note: there are various distributions of Java: OpenJDK, Oracle, Amazon Corretto, etc. They all will work with SQL Developer.

If the computer has JDK version 1.8 or 1.11, continue on to the install SQL Developer section below.

Install Amazon Corretto Java 1.8

For Windows computers managed by University of Minnesota IT

  1. Open Software Center
    1. Please refer to the knowledge article on how to Install and Uninstall Available Software using Software Center
  2. Install Amazon Corretto Java 1.8

For other Windows computers

If you have an administrator account on the computer, you can install Amazon Corretto from the product page. Select Amazon Corretto 8

If you do not have an administrator account on the computer, please contact your local IT support or contact Technology Help.

Install Oracle Client

For Windows Computers managed by University of Minnesota IT

  1. Open Software Center
    1. Please refer to the knowledge article on how to Install and Uninstall Available Software using Software Center
  2. Locate Oracle SQL Developer 19.2 in the list of available applications
    1. If you do not see the application, please contact Technology Help and request it be added to your Software Center
  3. Click the Install button. The application will download and install
  4. Restart the computer when installation completes
  5. Click the Windows Start menu
  6. Expand the OIT-Oracle 12 Client folder
  7. Select UpdateTNSNames
    1. It will first check if the file is already on the computer. If not, it will download from the University's files server.
  8. Open SQL Developer 4.0
  9. Select the Tools menu
    1. Select Preferences. The preferences window is displayed.
      1. Expand the Database category in the left navigation
      2. Select Advanced
        1. Check the box for Use Oracle Client
          1. Click the Configure button. The Configure Oracle Client window is displayed.
            1. Select Instant Client from the Client Type drop-down selector.
            2. Click the Browse button. The Choose Directory dialog window is displayed.
            3. Scroll to the top, and then expand the OIT-Oracle folder
            4. Select instantclient_12_1
            5. Click the Select button
          2. Click the OK button to close the Configure Oracle Client
        2. Check the box for Use OCI/Thick Driver
        3. Click Browse next to the Tnsnames Directory field. The Choose Directory window is displayed.
          1. Scroll to the top
          2. Select the OIT-Oracle folder
          3. Click the Select button
      3. Click OK to close the Preferences window
        1. You may receive a message stating: "The client home C:\OIT-Oracle\instantclient_12_1 is not the first entry on the PATH. The OCI client may not work correctly." Select either the Yes or No button
    2. The application will then restart

For other Windows Computers

Please contact your local IT support, or Technology Help

Create a Connection to Data Warehouse using SQL Developer 

If you are using a Wireless connection on campus, or you are off campus, VPN is required. Download the AnyConnect for Windows client from the [email protected] website. The connection guide is also on the [email protected] website.

  1. Open SQL Developer from the Applications folder on the computer.
  2. Click the green + symbol the new connection icon in the connections palette in the upper left to create a new connection. The connection settings window is displayed.
  3. Type a name for the connection in the Connection Name field
  4. Type your University of Minnesota Internet ID in the Username field
  5. Type your password in the Password field
  6. Click the Connection Type drop-down selector
    1. Select TNS
  7. Click the Network Alias drop-down selector
    1. Select DWEPRD.WORLD
  8. Click the TEST button
    1. If your account uses DUO, you will need to confirm the request
  9. If the Status displays Success, everything works
  10. Click Save
  11. Click Connect

 

Troubleshoot Failed Connections

When configuring the connection to the Data Warehouse, the test might return an error similar to "Invalid username/password; logon denied". There are many reasons for this error. The most common:

  • Re-type your Internet ID and password in the username and password fields
  • Not connected to VPN when using wireless or from off-campus

If none of these options resolve the problem, please contact Technology Help.