~ubuntu-branches/ubuntu/natty/python-kinterbasdb/natty-updates

« back to all changes in this revision

Viewing changes to docs/installation-binary.html

Committer: Bazaar Package Importer
Author(s): Matthias Klose
Date: 2003-09-28 15:52:16 UTC
Revision ID: james.westby@ubuntu.com-20030928155216-3o2xngislqrw1wnr

Tags: upstream-3.0.1

Import upstream version 3.0.1

files added:

PKG-INFO

README

__init__.py

_kinterbasdb.c

docs

docs/Python-DB-API-2.0.html

docs/changelog.txt

docs/global.css

docs/index.html

docs/installation-binary.html

docs/installation-source.html

docs/license.txt

docs/links.html

docs/usage.html

setup.cfg

setup.py

version.txt

Show diffs side-by-side

added added

removed removed

docs/installation-binary.html

<html>

<head>

<title>KInterbasDB Installation Guide - Binary Distribution</title>

</head>

<body>

<a href="index.html">Table of Contents</a>

<hr>

<h1 class="compactHeading">KInterbasDB Installation Guide - Binary Distribution</h1>

If a binary distribution of KInterbasDB (e.g., Windows executable installer,

Linux RPM) is not available for your platform, you will need to

<a href="installation-source.html">install the source distribution</a>

instead.

</p>

<h3>Steps:</h3>

<ol>

<li><a href="#step_dependencies">Satisfy the Dependencies</a></li>

<li><a href="#step_run_installer">Run the Installer</a></li>

<li><a href="#step_test">Test Your KInterbasDB Installation</a></li>

</ol>

<hr>

<a name="step_dependencies"><h2>Step 1: Satisfy the Dependencies</h2></a>

<p>

KInterbasDB requires a valid combination of the dependencies in the

below.

</p>

<p>

Detailed instructions on how to install each dependency are beyond the scope

of this document; consult the dependency distributor for installation

instructions.

</p>

<p>

<strong>Satisfying the dependencies is not difficult</strong>!

For mainstream operating systems--including Windows and Linux--easily

installable binary distributions are available for

<em>all</em> of KInterbasDB's dependencies (see the download links below).

</p>

<a name="dependency_list"><h4>Dependencies:</h4></a>

<li>

Operating System and C Compiler - one of:<br>

<li>Win32 and a C compiler (

Microsoft Visual C++ 6.0

[<a href="http://msdn.microsoft.com/visualc/howtobuy/default.asp">buy here</a>],

the free Borland C++ Compiler 5.5

[<a href="http://www.borland.com/bcppbuilder/freecompiler/">download here</a>],

the MinGW version of GCC

[<a href="http://www.mingw.org/download.shtml">download here</a>]

)

</li>

<li>Linux and GCC</li>

<li>(?) Other Unix or Unix-like operating system and C compiler</li>

</ul>

</li>

<li>

Database - one of:<br>

<li><a href="http://www.interbase.com">Interbase®</a> 6.0 or later

- client or server installation

[<a href="http://www.borland.com/devsupport/interbase/opensource/">download here</a>]

</li>

<li><a href="http://sourceforge.net/projects/firebird">Firebird<a/> 1.0-rc1 or later

- client or server installation

[<a href="http://sourceforge.net/project/showfiles.php?group_id=9028">download here</a>]

</li>

<li>(?) Interbase® < 6.0</li>

</ul>

</li>

<li><a href="http://www.python.org">Python</a>

[<a href="http://www.python.org/download/">download here</a>]

- one of:

<br>

<li>2.0 or later - <span style="font-style: italic;">recommended</span></li>

<li>1.5.2, plus the separately installable

<a href="http://www.python.org/sigs/distutils-sig/">distutils</a>

package

100

</li>

101

</ul>

102

</li>

103

104

<li>

105

<a href="http://www.lemburg.com/files/python/eGenix-mx-Extensions.html">eGenix.com mx Extensions for Python</a>,

106

version 2.0.1 or later

107

[<a href="http://www.lemburg.com/files/python/eGenix-mx-Extensions.html#Download-mxBASE">download here</a>]

108

<br>

109

110

KInterbasDB uses the DateTime module of the

111

eGenix.com mx Extensions to represent date and time objects,

112

as <a href="Python-DB-API-2.0.html#hints">recommended</a> by the

113

Python DB API Specification.

114

</p>

115

</li>

116

117

</ol>

118

119

120

<hr>

121

122

<a name="step_run_installer"><h2>Step 2: Run the Installer</h2></a>

123

<p>

124

Once you have successfully installed the dependencies, you may proceed with

125

the installation of KInterbasDB itself.

126

</p>

127

128

<ul>

129

<li><a href="#run_installer_windows">Windows</a></li>

130

<li><a href="#run_installer_rpm">Linux (RPM-based distributions)</a></li>

131

<li><a href="#run_installer_other">Linux (non-RPM-based distributions) and Other Unix Variants</a></li>

132

</ul>

133

134

<a name="run_installer_windows"><h4>Windows</h4></a>

135

<p>

136

Binary distributions of KInterbasDB for Windows come in the form of a

137

conventional executable installer. Just invoke the installer and follow

138

the wizard prompts.

139

</p>

140

<p>

141

Note that because KInterbasDB contains an extension module written in C,

142

you must use an installer created specifically for your Python version.

143

If you do not have the correct installer, the wizard page entitled

144

"Select Python installation to use:"

145

will not display any Python installations; you must either

146

download the correct installer from the

147

<a href="http://kinterbasdb.sourceforge.net">KInterbasDB web site</a>

148

149

download and

150

<a href="installation-source.html">install the source distribution</a>.

151

</p>

152

153

<a name="run_installer_rpm"><h4>Linux (RPM-based distributions)</h4></a>

154

<span class="XXX_ADDRESS_THIS">XXX RPM support has not yet been finalized.</span>

155

<p>

156

Binary distributions of KInterbasDB for Linux come in the form of an

157

RPM package. Some Linux distributions offer a graphical interface to

158

RPM, but in general, you should issue the following

159

command to install the RPM (while logged in as <code>root</code>):<br>

160

161

</p>

162

<p>

163

In order to function properly, the RPM system requires that all of a

164

package's dependencies also be installed using RPM. Binary RPM packages

165

are available for all of KInterbasDB's

166

<a href="#dependency_list">dependencies</a>.

167

</p>

168

<p>

169

Also note that because KInterbasDB contains an extension module written in C,

170

you must use an RPM created specifically for your Python version (and possibly

171

also specifically for your Linux distribution and version). If you do not

172

have the correct RPM, and cannot find it at the

173

<a href="http://kinterbasdb.sourceforge.net">KInterbasDB web site</a>

174

175

<a href="http://rpmfind.net">RPMFind.net</a>,

176

you must

177

<a href="installation-source.html">install the source distribution</a>

178

instead. Because the KInterbasDB source distribution supports the

179

standard Python package installation facility

180

(<a href="http://www.python.org/sigs/distutils-sig/"><code>distutils</code></a>),

181

installing the source distribution on a typical Linux system is downright

182

easy.

183

</p>

184

<p>

185

If you are unable to overcome a problem with the KInterbasDB RPM installation

186

process, either visit the

187

<a href="http://sourceforge.net/forum/forum.php?forum_id=133872">KInterbasDB Help Forum</a>

188

189

<a href="installation-source.html">install the source distribution</a>

190

instead.

191

</p>

192

193

<a name="run_installer_other"><h4>Linux (non-RPM-based distributions) and Other Unix Variants</h4></a>

194

<p>

195

Users of Linux distributions without RPM support must

196

<a href="installation-source.html">install the source distribution</a>

197

instead. The source distribution will <em>probably</em> also install

198

(and function) on most other Unix variants, as long as all of the

199

<a href="dependency_list">dependencies</a> are also installed

200

(and functional).

201

</p>

202

<p>

203

Because the KInterbasDB source distribution supports the

204

standard Python package installation facility

205

(<a href="http://www.python.org/sigs/distutils-sig/"><code>distutils</code></a>),

206

installing the source distribution on a typical Linux system is downright

207

easy.

208

</p>

209

210

<hr>

211

212

<a name="step_test"><h2>Step 3: Test Your KInterbasDB Installation</h2></a>

213

<p>

214

A test suite is planned for a future version of KInterbasDB,

215

but it was not written in time for version 3.0.

216

</p>

217

<p>

218

In the meantime, verify the integrity of your KInterbasDB installation by

219

opening a command prompt and issuing the following command:<br>

220

<code>python -c "import kinterbasdb"</code><br>

221

</p>

222

<p>

223

If the import attempt does not encounter any errors, you are finished.

224

Next, consider reading the <a href="usage.html">KInterbasDB Usage Guide</a>.

225

</p>

226

227

<p>

228

You should not encounter any errors at this stage since you have

229

already completed the installation step successfully.

230

If you do, please report them to the

231

<a href="http://sourceforge.net/forum/forum.php?forum_id=133872">KInterbasDB Help Forum</a>.

232

</p>

233

234

<hr>

235

236

<a href="index.html">Table of Contents</a>

237

238

</body>

239

</html>

b'\\ No newline at end of file'

Older »