platform-update-home/doc/working/documentation/standalone_update.html
Parent Directory
| 
Revision Log
Revision 1.17 - (view) (download) (as text)
| 1 : | dbirsan | 1.1 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| 2 : | <html> | ||
| 3 : | <head> | ||
| 4 : | <title>Standalone update</title> | ||
| 5 : | |||
| 6 : | <meta http-equiv="content-type" | ||
| 7 : | content="text/html; charset=ISO-8859-1"> | ||
| 8 : | </head> | ||
| 9 : | <body> | ||
| 10 : | <h3>Standalone update</h3> | ||
| 11 : | dbirsan | 1.2 | With the most recent code, you can install/update/enable/disable |
| 12 : | a feature or list the features available on a remote site by running eclipse in a command line mode.<br> | ||
| 13 : | dbirsan | 1.8 | You can also, mirror chosen features from an update site to a local update site mirror.<br> |
| 14 : | dbirsan | 1.1 | <br> |
| 15 : | dbirsan | 1.2 | Launch eclipse as follows, where [ ] means optional argument and arguments in italics must be provided by the user.<br> |
| 16 : | dbirsan | 1.4 | <br> |
| 17 : | dbirsan | 1.1 | <b>Installing a feature from a remote site</b>:<br> |
| 18 : | dbirsan | 1.12 | java -cp startup.jar org.eclipse.core.launcher.Main <br> |
| 19 : | dbirsan | 1.9 | -application org.eclipse.update.core.standaloneUpdate<br> |
| 20 : | -command install <br> | ||
| 21 : | -featureId <i>feature_id </i><br> | ||
| 22 : | -version <i>version </i><br> | ||
| 23 : | -from <i>remote_site_url</i> <br> | ||
| 24 : | [-to <i>target_site_dir</i>] <br> | ||
| 25 : | dbirsan | 1.2 | <p> |
| 26 : | dbirsan | 1.12 | <b>Example:</b> <code>java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.update.core.standaloneUpdate -command install -from http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/optionalSite/ -featureId com.example.root -version 1.0.0</code> |
| 27 : | dbirsan | 1.2 | </p> |
| 28 : | dbirsan | 1.1 | <br> |
| 29 : | dbirsan | 1.7 | <b>Updating an existing feature or all features</b>:<br> |
| 30 : | dbirsan | 1.12 | java -cp startup.jar org.eclipse.core.launcher.Main <br> |
| 31 : | dbirsan | 1.9 | -application org.eclipse.update.core.standaloneUpdate<br> |
| 32 : | dbirsan | 1.1 | -command update<br> |
| 33 : | dbirsan | 1.7 | [-featureId <i>feature_id </i>]<br> |
| 34 : | dbirsan | 1.17 | [-version <i>version </i>]<br> |
| 35 : | dbirsan | 1.1 | <br> |
| 36 : | <b>Enabling (configuring) a specified feature:</b><br> | ||
| 37 : | dbirsan | 1.12 | java -cp startup.jar org.eclipse.core.launcher.Main <br> |
| 38 : | dbirsan | 1.9 | -application org.eclipse.update.core.standaloneUpdate<br> |
| 39 : | dbirsan | 1.1 | -command enable<br> |
| 40 : | dbirsan | 1.6 | -featureId <i>feature_id </i><br> |
| 41 : | dbirsan | 1.1 | -version <i>version </i><br> |
| 42 : | dbirsan | 1.8 | [-to <i>target_site_dir</i>] <br> |
| 43 : | dbirsan | 1.1 | <br> |
| 44 : | <b>Disabling (unconfiguring) a specified feature:</b><br> | ||
| 45 : | dbirsan | 1.12 | java -cp startup.jar org.eclipse.core.launcher.Main <br> |
| 46 : | dbirsan | 1.9 | -application org.eclipse.update.core.standaloneUpdate<br> |
| 47 : | -command disable<br> | ||
| 48 : | -featureId <i>feature_id </i><br> | ||
| 49 : | -version <i>version </i><br> | ||
| 50 : | [-to <i>target_site_dir</i>] <br> | ||
| 51 : | dbirsan | 1.1 | <br> |
| 52 : | dbirsan | 1.9 | <b>Uninstalling a specified feature:</b><br> |
| 53 : | dbirsan | 1.12 | java -cp startup.jar org.eclipse.core.launcher.Main <br> |
| 54 : | dbirsan | 1.9 | -application org.eclipse.update.core.standaloneUpdate<br> |
| 55 : | -command uninstall<br> | ||
| 56 : | dbirsan | 1.6 | -featureId <i>feature_id </i><br> |
| 57 : | dbirsan | 1.1 | -version <i>version </i><br> |
| 58 : | dbirsan | 1.8 | [-to <i>target_site_dir</i>] <br> |
| 59 : | dbirsan | 1.1 | <br> |
| 60 : | dbirsan | 1.8 | In all the above commands where the -to target_site_dir is specified, corresponding |
| 61 : | configured target site at given directory will be used. If it is not specified, | ||
| 62 : | then the default local product site is used.<br> | ||
| 63 : | <br> | ||
| 64 : | If you only need to verify if the operation would succeed, in the above commands, (i.e. it satisfies the constraints), without actually performing it, | ||
| 65 : | dbirsan | 1.9 | then add <b><em>-verifyOnly=true</em></b> to the list of arguments.<br> |
| 66 : | dbirsan | 1.8 | |
| 67 : | <br><b>Searching a remote site, listing all available features for install:</b><br> | ||
| 68 : | dbirsan | 1.12 | java -cp startup.jar org.eclipse.core.launcher.Main <br> |
| 69 : | dbirsan | 1.9 | -application org.eclipse.update.core.standaloneUpdate<br> |
| 70 : | dbirsan | 1.1 | -command search<br> |
| 71 : | -from <i>remote_site_url</i> <br> | ||
| 72 : | dbirsan | 1.14 | |
| 73 : | dbirsan | 1.15 | <br><b>Listing installed features:</b><br> |
| 74 : | dbirsan | 1.14 | java -cp startup.jar org.eclipse.core.launcher.Main <br> |
| 75 : | -application org.eclipse.update.core.standaloneUpdate<br> | ||
| 76 : | dbirsan | 1.15 | -command listFeatures<br> |
| 77 : | dbirsan | 1.14 | -from <i>local_site_dir</i> <br> |
| 78 : | dbirsan | 1.16 | <br> |
| 79 : | The features are listed as: | ||
| 80 : | <br> | ||
| 81 : | <code> | ||
| 82 : | Site: <em>site url </em><br> | ||
| 83 : | Feature: <em>id version</em> enabled (or disabled) | ||
| 84 : | </code> | ||
| 85 : | <br> | ||
| 86 : | dbirsan | 1.14 | |
| 87 : | <br><b>Adding a local site with more features:</b><br> | ||
| 88 : | java -cp startup.jar org.eclipse.core.launcher.Main <br> | ||
| 89 : | -application org.eclipse.update.core.standaloneUpdate<br> | ||
| 90 : | -command addSite<br> | ||
| 91 : | -from <i>local_site_dir</i> <br> | ||
| 92 : | |||
| 93 : | dbirsan | 1.15 | <br><b>Removing a local site:</b><br> |
| 94 : | java -cp startup.jar org.eclipse.core.launcher.Main <br> | ||
| 95 : | -application org.eclipse.update.core.standaloneUpdate<br> | ||
| 96 : | -command removeSite<br> | ||
| 97 : | -to <i>local_site_dir</i> <br> | ||
| 98 : | |||
| 99 : | dbirsan | 1.1 | <br> |
| 100 : | dbirsan | 1.8 | <b>Mirroring feature(s) from a remote site:</b><br> |
| 101 : | dbirsan | 1.12 | java -cp startup.jar org.eclipse.core.launcher.Main <br> |
| 102 : | dbirsan | 1.9 | -application org.eclipse.update.core.standaloneUpdate<br> |
| 103 : | dbirsan | 1.8 | -command mirror<br> |
| 104 : | -from <i>remote_site_url</i> <br> | ||
| 105 : | -to <i>target_site_dir</i><br> | ||
| 106 : | [-featureId <i>feature_id</i>]<br> | ||
| 107 : | [-version <i>version</i>]<br> | ||
| 108 : | dbirsan | 1.11 | [-mirrorURL <i>mirror_site_url</i>]<br> |
| 109 : | dbirsan | 1.10 | <br> |
| 110 : | dbirsan | 1.13 | If -mirrorURL is specified, an update policy will be generated in |
| 111 : | <target_site_dir>/policy.xml file. The resulting policy.xml | ||
| 112 : | maps all features from the mirror site to the specified URL. | ||
| 113 : | The policy.xml can be used as is, or its fragments | ||
| 114 : | can be included into custom designed policy file. | ||
| 115 : | <br> | ||
| 116 : | dbirsan | 1.1 | <br> |
| 117 : | dbirsan | 1.12 | The return code for each command is either 0 (success) or 1 (failure).<br> |
| 118 : | dbirsan | 1.5 | <br> |
| 119 : | dbirsan | 1.12 | Additionally, most <A |
| 120 : | href="http://dev.eclipse.org/help21/topic/org.eclipse.platform.doc.user/tasks/running_eclipse.htm">options | ||
| 121 : | accepted by Eclipse executable</A> can be passed. They are especially | ||
| 122 : | useful during debugging and for specifying target environment for installed features. | ||
| 123 : | For example, passing option | ||
| 124 : | <code>-ws gtk</code> | ||
| 125 : | will set windowing system to GTK.<br> | ||
| 126 : | dbirsan | 1.1 | </body> |
| 127 : | </html> |
| help@eclipse.org | ViewVC Help |
| Powered by ViewVC 1.0.3 |