Skip to content

Commit 38cbfe2

Browse files
authored
Merge pull request oracle-samples#121 from oracle/Issue_113
Issue 113 Uninstall / deactivate DependencyExample?
2 parents 7edb31d + af7507a commit 38cbfe2

14 files changed

+60
-1
lines changed
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# [SQL Developer](http://www.oracle.com/technetwork/developer-tools/sql-developer/) Examples
2+
3+
## Managing Extensions
4+
* [Getting Extensions](#getting-extensions)
5+
* [Download Centers](#download-centers)
6+
* [Adding an Update Center](#adding-an-update-center)
7+
* [Using an Update Center](#using-an-update-center)
8+
* [Using a Check for Updates bundle](#using-a-check-for-updates-bundle)
9+
* [Build your own](#build-your-own)
10+
* [Enabling and Disabling Extensions](#enabling-and-disabling-extensions)
11+
* [Removing or Rolling Back Extensions](#removing-or-rolling-back-extensions)
12+
13+
14+
### Getting Extensions
15+
#### Download Centers
16+
Navigate to Help->Check for Updates.
17+
![Select update source image](images/ME-CFU-Check-1.png)
18+
19+
##### Adding an Update Center
20+
If you need to add a reference to an update center, press the Add button to enter the name and location. If the new update center is web based, enter the URL. If it is file system based, enter the path or use the browse button. There is an external _(not supported by Oracle)_ [example update center](https://github.com/bjeffrie/sqldev-update-center) for these extensions. You can add https://raw.githubusercontent.com/bjeffrie/sqldev-update-center/master/update-center.xml as an update center location to access it.
21+
![Add update center dialog image](images/ME-CFU-Add-1.png)
22+
23+
##### Using an Update Center
24+
Check the update centers you want to search and hit Next. You will be presented with a list of updates available for your version of SQL Developer from the selected update centers. Clicking on an entry shows information about the extension in the right panel. Select the extensions you want to add/update.
25+
26+
![Select updates to install image](images/ME-CFU-Add-2.png)
27+
Press Next.
28+
![Select updates to install Summary page image](images/ME-CFU-Add-3+4.png)
29+
Press Finish. If there are any licenses required, you will be asked to accept them. SQL Developer will ask you if it can restart.
30+
![Check for Updates restart dialog image](images/ME-CFU-Restart.png)
31+
32+
#### Using a Check for Updates bundle
33+
A Check for Updates (CFU) bundle is a zip file with the extension and metadata about it. Select Install from Local File(s), and enter the path or use the Browse button. _(The [Example Update Center](https://github.com/bjeffrie/sqldev-update-center) (external) has pre-built cfu bundles for these examples.)_
34+
35+
![Select update source install from local file image](images/ME-CFU-Local-1.png)
36+
Press Next.
37+
![Select update source install from local file Summary page image](images/ME-CFU-Local-2.png)
38+
Press Finish. If there are any licenses required, you will be asked to accept them. SQL Developer will ask you if it can restart.
39+
![Check for Updates restart dialog image](images/ME-CFU-Restart.png)
40+
41+
#### Build your own
42+
See the [Set Up / Tutorial](./setup.md) - A step by step guide to building your first extension and check for updates bundle. See the extension [read me](./README.md) for other example extensions.
43+
44+
### Enabling and Disabling Extensions
45+
__Note:__ _The About Oracle SQL Developer dialog has an Extensions tab that displays the load status. Newly installed extensions are typically in "Triggers Loaded" state which means SQL Developer 'knows' about the extension, but has not "Fully Loaded" it yet. Loading is (generally) triggered by either choosing a menu action provided by the extension or visiting its preference page (if any). Once fully loaded, most extensions will fully load on subsequent sessions._
46+
47+
Navigate to Tools->Features...
48+
![Manage Features and Updates dialog Features tab image](images/ME-MFU-Features.png)
49+
If the extension allows it, you can use the check boxes to toggle extensions on and off from this page. There will be a pop-up progress dialog while the extension loading information is updated.
50+
51+
### Removing or Rolling Back Extensions
52+
Navigate to Tools->Features... and select the Installed Updates tab.
53+
![Manage Features and Updates dialog Installed Updates tab image](images/ME-MFU-Installed-Updates.png)
54+
From this panel, you can uninstall or roll back updates by selecting the desired entries and pressing Uninstall.

sqldeveloper/extension/README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ Depending on requirements, this can be done in either XML or java and deployed b
66

77
### New
88

9+
* [Managing Extensions](./ManagingExtensions.md) - ([Issue 113](https://github.com/oracle/oracle-db-examples/issues/113)) How to add, disable, and remove extensions.
10+
911
* [ConnectionHelper](java/ConnectionHelper)
1012
Optionally accept connection info from the command line and/or on a [SocketServer](https://docs.oracle.com/javase/tutorial/networking/sockets/clientServer.html)
1113

@@ -20,6 +22,9 @@ A simple command line client for the ConnectionHelper socket server.
2022
* [Set Up / Tutorial](./setup.md) - A step by step guide to building your first extension and check for updates bundle.
2123

2224

25+
* [Managing Extensions](./ManagingExtensions.md) - How to add, disable, and remove extensions.
26+
27+
2328
* ["Simple" User Extensions (XML)](xml)
2429

2530

sqldeveloper/extension/build.properties

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,5 +17,5 @@ extension.owner.url=https://github.com/oracle/oracle-db-examples/tree/master/sql
1717
#
1818
# Base location of the CFU site.
1919
# This is where the produced updates.xml will say the cfu bundle files are.
20-
update.url=https://gitcdn.xyz/repo/bjeffrie/sqldev-update-center/master
20+
update.url=https://raw.githubusercontent.com/bjeffrie/sqldev-update-center/master
2121

Loading
Loading
214 KB
Loading
206 KB
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)