platform-update-home/doc/working/documentation/standalone_update.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.10 - (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 :     eclipse <br>
19 : dbirsan 1.9 &nbsp;&nbsp;&nbsp; -application&nbsp; org.eclipse.update.core.standaloneUpdate<br>
20 :     &nbsp;&nbsp;&nbsp; -nosplash <br>
21 :     &nbsp;&nbsp;&nbsp; [-vm <i>path to java.exe</i>] <br>
22 :     &nbsp;&nbsp;&nbsp; -command install <br>
23 :     &nbsp;&nbsp;&nbsp; -featureId <i>feature_id </i><br>
24 :     &nbsp;&nbsp;&nbsp; -version <i>version </i><br>
25 :     &nbsp;&nbsp;&nbsp; -from <i>remote_site_url</i> <br>
26 :     &nbsp;&nbsp;&nbsp; [-to <i>target_site_dir</i>] <br>
27 : dbirsan 1.2 <p>
28 : dbirsan 1.3 <b>Example:</b> <code>eclipse.exe -application org.eclipse.update.core.standaloneUpdate -nosplash -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>
29 : dbirsan 1.2 </p>
30 : dbirsan 1.1 <br>
31 : dbirsan 1.7 <b>Updating an existing feature or all features</b>:<br>
32 : dbirsan 1.1 eclipse <br>
33 : dbirsan 1.9 &nbsp;&nbsp;&nbsp; -application&nbsp; org.eclipse.update.core.standaloneUpdate<br>
34 :     &nbsp;&nbsp;&nbsp; -nosplash <br>
35 :     &nbsp;&nbsp;&nbsp; [-vm <i>path to java.exe</i>] <br>
36 : dbirsan 1.1 &nbsp;&nbsp;&nbsp; -command update<br>
37 : dbirsan 1.7 &nbsp;&nbsp;&nbsp; [-featureId <i>feature_id </i>]<br>
38 : dbirsan 1.1 <br>
39 :     <b>Enabling (configuring) a specified feature:</b><br>
40 :     eclipse <br>
41 : dbirsan 1.9 &nbsp;&nbsp;&nbsp; -application&nbsp; org.eclipse.update.core.standaloneUpdate<br>
42 :     &nbsp;&nbsp;&nbsp; -nosplash <br>
43 :     &nbsp;&nbsp;&nbsp; [-vm <i>path to java.exe</i>] <br>
44 : dbirsan 1.1 &nbsp;&nbsp;&nbsp; -command enable<br>
45 : dbirsan 1.6 &nbsp;&nbsp;&nbsp; -featureId <i>feature_id </i><br>
46 : dbirsan 1.1 &nbsp;&nbsp;&nbsp; -version <i>version </i><br>
47 : dbirsan 1.8 &nbsp;&nbsp;&nbsp; [-to <i>target_site_dir</i>] <br>
48 : dbirsan 1.1 <br>
49 :     <b>Disabling (unconfiguring) a specified feature:</b><br>
50 :     eclipse <br>
51 : dbirsan 1.9 &nbsp;&nbsp;&nbsp; -application&nbsp; org.eclipse.update.core.standaloneUpdate<br>
52 :     &nbsp;&nbsp;&nbsp; -nosplash <br>
53 :     &nbsp;&nbsp;&nbsp; [-vm <i>path to java.exe</i>] <br>
54 :     &nbsp;&nbsp;&nbsp; -command disable<br>
55 :     &nbsp;&nbsp;&nbsp; -featureId <i>feature_id </i><br>
56 :     &nbsp;&nbsp;&nbsp; -version <i>version </i><br>
57 :     &nbsp;&nbsp;&nbsp; [-to <i>target_site_dir</i>] <br>
58 : dbirsan 1.1 <br>
59 : dbirsan 1.9 <b>Uninstalling a specified feature:</b><br>
60 :     eclipse <br>
61 :     &nbsp;&nbsp;&nbsp; -application&nbsp; org.eclipse.update.core.standaloneUpdate<br>
62 :     &nbsp;&nbsp;&nbsp; -nosplash <br>
63 :     &nbsp;&nbsp;&nbsp; [-vm <i>path to java.exe</i>] <br>
64 :     &nbsp;&nbsp;&nbsp; -command uninstall<br>
65 : dbirsan 1.6 &nbsp;&nbsp;&nbsp; -featureId <i>feature_id </i><br>
66 : dbirsan 1.1 &nbsp;&nbsp;&nbsp; -version <i>version </i><br>
67 : dbirsan 1.8 &nbsp;&nbsp;&nbsp; [-to <i>target_site_dir</i>] <br>
68 : dbirsan 1.1 <br>
69 : dbirsan 1.8 In all the above commands where the -to target_site_dir is specified, corresponding
70 :     configured target site at given directory will be used. If it is not specified,
71 :     then the default local product site is used.<br>
72 :     <br>
73 :     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,
74 : dbirsan 1.9 then add <b><em>-verifyOnly=true</em></b> to the list of arguments.<br>
75 : dbirsan 1.8
76 :     <br><b>Searching a remote site, listing all available features for install:</b><br>
77 : dbirsan 1.1 eclipse <br>
78 : dbirsan 1.9 &nbsp;&nbsp;&nbsp; -application&nbsp; org.eclipse.update.core.standaloneUpdate<br>
79 :     &nbsp;&nbsp;&nbsp; -nosplash <br>
80 :     &nbsp;&nbsp;&nbsp; [-vm <i>path to java.exe</i>] <br>
81 : dbirsan 1.1 &nbsp;&nbsp;&nbsp; -command search<br>
82 :     &nbsp;&nbsp;&nbsp; -from <i>remote_site_url</i> <br>
83 :     <br>
84 : dbirsan 1.8 <b>Mirroring feature(s) from a remote site:</b><br>
85 :     eclipse <br>
86 : dbirsan 1.9 &nbsp;&nbsp;&nbsp; -application&nbsp; org.eclipse.update.core.standaloneUpdate<br>
87 :     &nbsp;&nbsp;&nbsp; -nosplash <br>
88 :     &nbsp;&nbsp;&nbsp; [-vm <i>path to java.exe</i>] <br>
89 : dbirsan 1.8 &nbsp;&nbsp;&nbsp; -command mirror<br>
90 :     &nbsp;&nbsp;&nbsp; -from <i>remote_site_url</i> <br>
91 :     &nbsp;&nbsp;&nbsp; -to <i>target_site_dir</i><br>
92 :     &nbsp;&nbsp;&nbsp; [-featureId <i>feature_id</i>]<br>
93 :     &nbsp;&nbsp;&nbsp; [-version <i>version</i>]<br>
94 : dbirsan 1.10 &nbsp;&nbsp;&nbsp; [-siteURL <i>target_site_url</i>]<br>
95 :     <br>
96 :     If -siteURL is specified, a fragment of policy file will be generated in
97 :     &lt;target_site_dir&gt;/policy.inc file, for inclusion in update policy file.
98 :     The fragment will map all features from the mirror site to the specified URL.<br>
99 : dbirsan 1.1 <br>
100 : dbirsan 1.5 The return code for each command is either 0 (success) or 1 (failure).
101 :     <br>
102 : dbirsan 1.8
103 : dbirsan 1.1 </body>
104 :     </html>