summaryrefslogtreecommitdiffstats
path: root/branches/site-20070701-mvnbased/site-author/building_source.xml
blob: 38970684422e0954330935058d51b2a720aa294a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
<?xml version="1.0" encoding="UTF-8"?>
<document>
    <properties>
        <title>Building Tuscany Source Code</title>
        <bannertitle>Building Tuscany Source Code</bannertitle>
    </properties>
    <body>
        <section name="Building Tuscany Source Code">

            <p>This page provides information related to building Tuscany (SCA/SDO/DAS ) Source Code (Java/C++).</p><table border="0" bgcolor="white" width="100%">
	<tbody>
		<tr bgcolor="#e0e0c2">
			<td><b><font color="#004566">Building Tuscany Java SCA / SDO / DAS</font></b></td>
		</tr>
		<tr bgcolor="white">
			<td bgcolor="white" valign="top">If you are building the source for Tuscany Java SCA or Java SDO or Java DAS, then the procudure to be followed is the same for all three and is as follows: <table border="0" width="100%">
				<tbody>
					<tr bgcolor="#f8f8fb">
						<td width="17" align="center" valign="top">1.</td>
						<td width="605" valign="top">Ensure that you have downloaded the relevant (Java SCA / SDO / DAS) source code from the Apache Tuscany Subversion Repository. Here are the links for the source in that repository: -<table border="0" width="100%">
							<tbody>
								<tr>
									<td width="10"></td>
									<td width="567" bgcolor="#fffff4"><a
										href="http://svn.apache.org/repos/asf/incubator/tuscany/java/sca/">Source
									code for Tuscany Java SCA</a></td>
								</tr>
								<tr>
									<td width="10"></td>
									<td width="567" bgcolor="#fffff4"><a
										href="http://svn.apache.org/repos/asf/incubator/tuscany/java/sdo/">Source
									code for Tuscany Java SDO</a></td>
								</tr>
								<tr>
									<td width="10"></td>
									<td width="567" bgcolor="#fffff4"><a
										href="http://svn.apache.org/repos/asf/incubator/tuscany/java/das/">Source
									code for Tuscany Java DAS</a></td>
								</tr>
							</tbody>
						</table>
						<br />Alternatively, you may download the source distribution from the releases for SCA / SDO / DAS. The release can be found at the following links: -<a
							href="http://svn.apache.org/repos/asf/incubator/tuscany/java/sca/"></a><table border="0" width="100%">
							<tbody>
								<tr>
									<td width="10"></td>
									<td width="567" bgcolor="#fffff4"><a
										href="http://www.osoa.org/download/attachments/35/SCA_AssemblyModel_V095.pdf?version=4">
									<span class="nobr"><a
										href="http://www.osoa.org/download/attachments/35/SCA_AssemblyModel_V096.pdf?version=1"
										title="SCA_AssemblyModel_V096.pdf attached to Service Component Architecture Specifications"></a></span></a><a
										href="sca_downloads.html">Tuscany SCA Downloads</a><a
										href="http://www.osoa.org/download/attachments/35/SCA_AssemblyModel_V095.pdf?version=4"></a></td>
								</tr>
								<tr>
									<td width="10"></td>
									<td width="567" bgcolor="#fffff4"><a href="sdo_downloads.html">Tuscany
									SDO Dowloads</a></td>
								</tr>
								<tr>
									<td width="10"></td>
									<td width="567" bgcolor="#fffff4"><span class="nobr"><a
										href="http://www.osoa.org/download/attachments/287/Next-Gen-Data-Programming-Whitepaper.pdf?version=1"
										title="Next-Gen-Data-Programming-Whitepaper.pdf attached to SDO Resources"></a></span><a
										href="das_downloads.html">Tuscany DAS Downloads</a></td>
								</tr>
							</tbody>
						</table></td>
					</tr>
					<tr bgcolor="#f8f8fb">
						<td width="17" align="center" valign="top">2.</td>
						<td width="605" valign="top">If you wish to download the source from the Subversion Repository then you must first install the Subversion client. Information related to Subversion - such as downloading, installing etc. can be found at <a
							href="http://subversion.tigris.org/">http://subversion.tigris.org/</a>. Ensure that you download a version that is greater or equal to 1.3.0<br />
						<br />After installing the Subversion client you can download the source from the links mentioned in the previous point.
						For example here is the command that will download all of SCA, SDO and DAS into the present working directory.<br />
						<br />
						<i><font face="Courier New">&quot;svn co
						http://svn.apache.org/repos/asf/incubator/tuscany/java/ .&quot;</font></i><br />
						<br />
						Subversion also provides clients that plug into popular IDEs such as Eclipse. The Subversion plugin for Eclipse is know as Subclipes and can be obtained from <a
							href="http://subclipse.tigris.org/">http://subclipse.tigris.org/</a>. Using this plugin you may work with the Tuscany Subversion Repository from within your Eclipse IDE.<br />
						<br />
						<br />Alternatively, if you have downloaded on the source distributions from the releases, then extract the distribution to you local system.</td>
					</tr>
					<tr bgcolor="#f8f8fb">
						<td width="17" align="center" valign="top">3.</td>
						<td width="605" valign="top">To compile Tusacny Java SCA / SDO / DAS source you must ensure you have the appropriate level of JDK installed on your local system.<br />
						<table border="0">
							<tbody>
								<tr>
									<td width="10"></td>
									<td bgcolor="#fffff4" width="75">SCA </td>
									<td bgcolor="#fffff4" width="226">JDK 5.0 </td>
								</tr>
								<tr>
									<td width="10"></td>
									<td bgcolor="#fffff4" width="75">SDO </td>
									<td bgcolor="#fffff4" width="226">JDK 1.4</td>
								</tr>
								<tr>
									<td width="10"></td>
									<td bgcolor="#fffff4" width="75">DAS </td>
									<td bgcolor="#fffff4" width="226">JDK 5.0</td>
								</tr>
							</tbody>
						</table></td>
					</tr>
					<tr bgcolor="#f8f8fb">
						<td width="17" align="center" valign="top">4.</td>
						<td width="605" valign="top">Next, to build the source you need the build tool called Maven with a version greater than or equal to 2.0.4. Information about downloading, installing and setting up Maven can be found at <a
							href="http://maven.apache.org/">http://maven.apache.org/</a><br />
						<br />After installing and setting up Maven, go to the root of the source (downloaded using SVN or extracted from release) on your local system and simply issue the following command :<br />
						<br />
						<i><font face="Courier New">&quot;mvn&quot;<br />
						<br /></font></i>You can execute this command either from the sub-directory that contains all of SCA, SDO and DAS source code (if you have downloaded all of them) or inside one of the modules (or sub-directory within) - SCA or SDO or DAS.<br />
						<br />Ensure that you are connected to  the Internet when building since all dependencies required to build Tuscany SCA / SDO / DAS will be dynamically downloaded by Maven from various repositories on the Internet. Once you have successfully built, subsequent builds can be done offline (without connecting to the Internet) using the following command as long as no additional dependencies are added after the previous online build.<br />
						<br />
						<i><font face="Courier New">&quot;mvn -o&quot;</font></i></td>
					</tr>
					<tr bgcolor="#f8f8fb">
						<td width="17" align="center" valign="top">5.</td>
						<td width="605" valign="top">Now that Tuscany Source has be downloaed and built you can start any modifications or enhancements to the source. However, development is alwasy preferred to be done with the help of IDEs. In order to import the Tuscany Projects into various IDEs, you must have to first create the corresponding configuration (say project and classpath) information relevant to each IDE. This again is doen using the Maven tool specifying appropriate targets as follows: -<br />
						<br />
						<u>a) To import Tuscany projects into Eclipse IDE</u> execute the following command<br />
						<br />
						<i><i><font face="Courier New">&quot;mvn -Peclipse eclipse:eclipse&quot;</font></i></i>
						<br />
						<br />This will create the necessary &quot;.<i>project&quot; and &quot;.classpath&quot; </i>files inside the Tuscany source directories on your local system.
						Then you may open the Eclipse IDE and exercise the &quot;Import Projects' option, pointing to the Tuscany source directory for the location of the projects.</td>
					</tr>
				</tbody>
			</table>
			</td>
		</tr>
	</tbody>
</table>
<br />
<br />
<table border="0" bgcolor="white" width="100%">
	<tbody>
		<tr bgcolor="#e0e0c2">
			<td><b><font color="#004566">Building Tuscany C++ SCA / SDO </font></b></td>
		</tr>
		<tr bgcolor="white">
			<td bgcolor="white" valign="top">If you are building the source for
			Tuscany C++ SCA or C++ SDO then the procudure to be
			followed is the same for   both and is as follows:
			<br /><table border="0" width="100%">
				<tbody>
					<tr bgcolor="#f8f8fb">
						<td width="17" align="center" valign="top">1.</td>
						<td width="605" valign="top">
                The main Tuscany project repository is located at <a href="https://svn.apache.org/repos/asf/incubator/tuscany">
                https://svn.apache.org/repos/asf/incubator/tuscany</a>. 
                You can use SVN to check out the entire project, and you will get both the java and C++ repositories.
                Alternatively you can check out just the cpp directory at <a href="https://svn.apache.org/repos/asf/incubator/tuscany/cpp">
                https://svn.apache.org/repos/asf/incubator/tuscany/cpp</a>, to get the SCA and SDO implementations for C++.</td>
					</tr>
					<tr bgcolor="#f8f8fb">
						<td width="17" align="center" valign="top">2.</td>
						<td width="605" valign="top">
						You can find detailed instructions on how to configure the C++ runtime and tools for <a href="./cpp_setup_linux.html">Linux</a>
            				and <a href="./cpp_setup_win.html">Windows</a>
						</td>
					</tr>
					<tr bgcolor="#f8f8fb">
						<td width="17" align="center" valign="top">3.</td>
						<td width="605" valign="top">
                        In order to run the Tuscany C++ runtimes there are some minimum system requirements:
            			<table border="0">
							<tbody>
								<tr>
									<td width="10"></td>
									<td bgcolor="#fffff4" width="134">Operating System</td>
									<td bgcolor="#fffff4" width="324">
									<ul>
										<li>Windows XP SP2</li>
										<li>Linux</li>
									</ul>
									</td>
								</tr>
								<tr>
									<td width="10"></td>
									<td bgcolor="#fffff4" width="134">Other components</td>
									<td bgcolor="#fffff4" width="324">
									<ul>
										<li><a href="http://ws.apache.org/axis2/c/"> Apache Axis2/C
										verion 0.92 </a></li>
										<li><a href="http://xmlsoft.org/downloads.html"> Libxml2
										Parser version 2.6.20 </a></li>
									</ul>
									</td>
								</tr>
							</tbody>
						</table></td>
					</tr>
				</tbody>
			</table>
			</td>
		</tr>
	</tbody>
</table>
<p></p>

</section>

    </body>
</document>