Skip to content

Commit b9b5974

Browse files
andy-maierandy-maier
authored
Removed updating of pywbem.github.io from release instructions (#15)
Signed-off-by: Andreas Maier <[email protected]>
1 parent 7acd353 commit b9b5974

File tree

1 file changed

+5
-337
lines changed

1 file changed

+5
-337
lines changed

‎pywbem/installation.html‎

Lines changed: 5 additions & 337 deletions
Original file line numberDiff line numberDiff line change
@@ -26,348 +26,16 @@ <h1 align="center">PyWBEM Client - Installation</h1>
2626
</script>
2727
<!-- end of page header -->
2828

29-
<h2>Downloads</h2>
30-
31-
<p>The following distribution archives are available for download:</p>
32-
33-
<a name="table1"></a>
34-
<table border="1" style="width:100%">
35-
<tr>
36-
<th>Version</th>
37-
<th>Released</th>
38-
<th>Status</th>
39-
<th>PyPI</th>
40-
<th>Change Log</th>
41-
<th>API Documentation</th>
42-
</tr>
43-
<tr>
44-
<td>1.7.3</td>
45-
<td>2025-03-02</td>
46-
<td>Latest stable release, in fix mode</td>
47-
<td><a href="https://pypi.python.org/pypi/pywbem/1.7.3">PyPI</a></td>
48-
<td><a href="https://pywbem.readthedocs.org/en/1.7.3/changes.html">Change Log</a></td>
49-
<td><a href="https://pywbem.readthedocs.org/en/1.7.3/">API Documentation</a></td>
50-
</tr>
51-
<tr>
52-
<td>1.6.3</td>
53-
<td>2024-03-27</td>
54-
<td>Stable release, out of service</td>
55-
<td><a href="https://pypi.python.org/pypi/pywbem/1.6.3">PyPI</a></td>
56-
<td><a href="https://pywbem.readthedocs.org/en/1.6.3/changes.html">Change Log</a></td>
57-
<td><a href="https://pywbem.readthedocs.org/en/1.6.3/">API Documentation</a></td>
58-
</tr>
59-
<tr>
60-
<td>1.5.0</td>
61-
<td>2022-10-12</td>
62-
<td>Stable release, out of service</td>
63-
<td><a href="https://pypi.python.org/pypi/pywbem/1.5.0">PyPI</a></td>
64-
<td><a href="https://pywbem.readthedocs.org/en/1.5.0/changes.html">Change Log</a></td>
65-
<td><a href="https://pywbem.readthedocs.org/en/1.5.0/">API Documentation</a></td>
66-
</tr>
67-
<tr>
68-
<td>1.4.2</td>
69-
<td>2022-10-11</td>
70-
<td>Stable release, out of service</td>
71-
<td><a href="https://pypi.python.org/pypi/pywbem/1.4.2">PyPI</a></td>
72-
<td><a href="https://pywbem.readthedocs.org/en/1.4.2/changes.html">Change Log</a></td>
73-
<td><a href="https://pywbem.readthedocs.org/en/1.4.2/">API Documentation</a></td>
74-
</tr>
75-
<tr>
76-
<td>1.3.0</td>
77-
<td>2021-12-04</td>
78-
<td>Stable release, out of service</td>
79-
<td><a href="https://pypi.python.org/pypi/pywbem/1.3.0">PyPI</a></td>
80-
<td><a href="https://pywbem.readthedocs.org/en/1.3.0/changes.html">Change Log</a></td>
81-
<td><a href="https://pywbem.readthedocs.org/en/1.3.0/">API Documentation</a></td>
82-
</tr>
83-
<tr>
84-
<td>1.2.1</td>
85-
<td>2021-11-30</td>
86-
<td>Stable release, out of service</td>
87-
<td><a href="https://pypi.python.org/pypi/pywbem/1.2.1">PyPI</a></td>
88-
<td><a href="https://pywbem.readthedocs.org/en/1.2.1/changes.html">Change Log</a></td>
89-
<td><a href="https://pywbem.readthedocs.org/en/1.2.1/">API Documentation</a></td>
90-
</tr>
91-
<tr>
92-
<td>1.1.3</td>
93-
<td>2021-01-01</td>
94-
<td>Stable release, out of service</td>
95-
<td><a href="https://pypi.python.org/pypi/pywbem/1.1.3">PyPI</a></td>
96-
<td><a href="https://pywbem.readthedocs.org/en/stable_1.1/changes.html">Change Log</a></td>
97-
<td><a href="https://pywbem.readthedocs.org/en/stable_1.1/">API Documentation</a></td>
98-
</tr>
99-
<tr>
100-
<td>1.0.3</td>
101-
<td>2020-10-05</td>
102-
<td>Stable release, out of service</td>
103-
<td><a href="https://pypi.python.org/pypi/pywbem/1.0.3">PyPI</a></td>
104-
<td><a href="https://pywbem.readthedocs.org/en/stable_1.0/changes.html">Change Log</a></td>
105-
<td><a href="https://pywbem.readthedocs.org/en/stable_1.0/">API Documentation</a></td>
106-
</tr>
107-
<tr>
108-
<td>0.17.6</td>
109-
<td>2020-10-05</td>
110-
<td>Stable release, fixed only in emergency cases</td>
111-
<td><a href="https://pypi.python.org/pypi/pywbem/0.17.6">PyPI</a></td>
112-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.17/changes.html">Change Log</a></td>
113-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.17/">API Documentation</a></td>
114-
</tr>
115-
<tr>
116-
<td>0.16.0</td>
117-
<td>2020-01-09</td>
118-
<td>Stable release, out of service</td>
119-
<td><a href="https://pypi.python.org/pypi/pywbem/0.16.0">PyPI</a></td>
120-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.16/changes.html">Change Log</a></td>
121-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.16/">API Documentation</a></td>
122-
</tr>
123-
<tr>
124-
<td>0.15.0</td>
125-
<td>2019-12-01</td>
126-
<td>Stable release, out of service</td>
127-
<td><a href="https://pypi.python.org/pypi/pywbem/0.15.0">PyPI</a></td>
128-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.15/changes.html">Change Log</a></td>
129-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.15/">API Documentation</a></td>
130-
</tr>
131-
<tr>
132-
<td>0.14.6</td>
133-
<td>2019-10-10</td>
134-
<td>Stable release, out of service</td>
135-
<td><a href="https://pypi.python.org/pypi/pywbem/0.14.6">PyPI</a></td>
136-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.14/changes.html">Change Log</a></td>
137-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.14/">API Documentation</a></td>
138-
</tr>
139-
<tr>
140-
<td>0.13.1</td>
141-
<td>2019-03-14</td>
142-
<td>Stable release, out of service</td>
143-
<td><a href="https://pypi.python.org/pypi/pywbem/0.13.1">PyPI</a></td>
144-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.13/changes.html">Change Log</a></td>
145-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.13/">API Documentation</a></td>
146-
</tr>
147-
<tr>
148-
<td>0.12.6</td>
149-
<td>2018-09-13</td>
150-
<td>Stable release, out of service</td>
151-
<td><a href="https://pypi.python.org/pypi/pywbem/0.12.6">PyPI</a></td>
152-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.12/changes.html">Change Log</a></td>
153-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.12/">API Documentation</a></td>
154-
</tr>
155-
<tr>
156-
<td>0.11.0</td>
157-
<td>2017-09-27</td>
158-
<td>Stable release, out of service</td>
159-
<td><a href="https://pypi.python.org/pypi/pywbem/0.11.0">PyPI</a></td>
160-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.11/changes.html">Change Log</a></td>
161-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.11/">API Documentation</a></td>
162-
</tr>
163-
<tr>
164-
<td>0.10.1</td>
165-
<td>2017-09-27</td>
166-
<td>Stable release, out of service</td>
167-
<td><a href="https://pypi.python.org/pypi/pywbem/0.10.1">PyPI</a></td>
168-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.10/changes.html">Change Log</a></td>
169-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.10/">API Documentation</a></td>
170-
</tr>
171-
<tr>
172-
<td>0.9.1</td>
173-
<td>2016-11-30</td>
174-
<td>Stable release, out of service</td>
175-
<td><a href="https://pypi.python.org/pypi/pywbem/0.9.1">PyPI</a></td>
176-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.9/changes.html">Change Log</a></td>
177-
<td><a href="https://pywbem.readthedocs.org/en/stable_0.9/">API Documentation</a></td>
178-
</tr>
179-
<tr>
180-
<td>0.8.4</td>
181-
<td>2016-05-13</td>
182-
<td>Stable release, out of service</td>
183-
<td><a href="https://pypi.python.org/pypi/pywbem/0.8.4">PyPI</a></td>
184-
<td><a href="pywbem/doc/0.8.4/changelog.html">Change Log</a></td>
185-
<td><a href="pywbem/doc/0.8.4/index.html">API Documentation</a></td>
186-
</tr>
187-
<tr>
188-
<td>0.7.0</td>
189-
<td>2008-12-12</td>
190-
<td>Stable release, out of service</td>
191-
<td><a href="https://pypi.python.org/pypi/pywbem/0.7.0">PyPI</a></td>
192-
<td><a href="pywbem/doc/0.7.0/changelog.html">Change Log</a></td>
193-
<td>N/A</td>
194-
</tr>
195-
</table>
196-
197-
<p>Older releases of the PyWBEM Client are available on
198-
<a href="https://pypi.python.org/pypi/pywbem" target="_blank">PyPI</a>
199-
and
20029
<a href="https://github.com/pywbem/pywbem/tree/master/dist" target="_blank">GitHub</a>.</p>
20130

20231
<h2>Installation</h2>
20332

204-
<p>The PyWBEM Client can be installed quite easily by running its standard Python setup
205-
script (setup.py) with the "install" command, or by using
206-
<code>pip install</code> (which also invokes the setup script).</p>
207-
208-
<p>As of PyWBEM Client v0.8, the setup script has support for installing its
209-
prerequisites. This includes installing the M2Crypto Python package, installing
210-
any prerequisite OS-level packages, and installing or building Swig, if needed.
211-
For details, see the examples, below.</p>
212-
213-
<p>OS-level prerequisites are installed using new setup.py commands 'install_os'
214-
and 'develop_os'. They are supported for a number of well-known Linux
215-
distributions. For other Linux distributions, these commands display the
216-
OS-level packages that are needed. On Linux, these commands use 'sudo', so
217-
your userid needs to be authorized accordingly.</p>
218-
219-
<p>Installation of the PyWBEM Client is supported into the default system
220-
Python, and (preferrable) into
221-
<a href="http://docs.python-guide.org/en/latest/dev/virtualenvs/" target="_blank">virtual
222-
Python environments</a>. For details, see the examples, below.</p>
223-
224-
<h3>Examples</h3>
225-
226-
<ul>
227-
<li>
228-
<p>Install latest version from PyPI into default system Python (assuming
229-
OS-level prerequisites are already satisfied):</p>
230-
<pre><code>sudo pip install pywbem
231-
</code></pre>
232-
</li>
233-
<li>
234-
<p>Install latest version from PyPI into new Python 2.7 virtual environment
235-
(assuming OS-level prerequisites are already satisfied):</p>
236-
<pre><code>mkvirtualenv -p python2.7 pywbem27
237-
pip install pywbem
238-
</code></pre>
239-
</li>
240-
<li>
241-
<p>Install from master branch on GitHub into new Python 2.7 virtual environment
242-
(assuming OS-level prerequisites are already satisfied):</p>
243-
<pre><code>git clone [email protected]:pywbem/pywbem.git pywbem
244-
cd pywbem/src
245-
mkvirtualenv -p python2.7 pywbem27
246-
python setup.py install
247-
</code></pre>
248-
</li>
249-
<li>
250-
<p><a name="inst_arch">
251-
Install from a downloaded distribution archive
252-
(links are in the <a href="pywbem/installation.html#table1">table above</a>),
253-
into new Python 2.7 virtual environment, installing OS-level prerequisites
254-
(such as Swig) as needed (requires sudo rights):</p>
255-
<pre><code># Have pywbem-{version}.zip downloaded from the table, or run "pip download pywbem"
256-
tar -xf pywbem-{version}.zip
257-
cd pywbem-{version}
258-
mkvirtualenv -p python2.7 pywbem27
259-
python setup.py install_os install
260-
</code></pre>
261-
</li>
262-
</ul>
263-
264-
<p>The command syntax above is shown for Linux, but this works the same way on
265-
Windows and on other operating systems supported by Python.</p>
266-
267-
<h2>Installation in development mode</h2>
268-
269-
<p>The installation of PyWBEM in development mode is supported as well.
270-
Development mode means that any OS-level packages and Python packages needed for
271-
development of the PyWBEM Client are being made available. These packages
272-
are a superset of the packages needed for just using the PyWBEM client.</p>
273-
274-
<h3>Examples</h3>
275-
276-
<ul>
277-
<li>
278-
<p>Install from master branch on GitHub into new Python 2.7 virtual environment,
279-
installing OS-level prerequisites as needed (requires sudo rights):</p>
280-
<pre><code>git clone [email protected]:pywbem/pywbem.git pywbem
281-
cd pywbem/src
282-
mkvirtualenv -p python2.7 pywbem27
283-
python setup.py develop_os develop
284-
</code></pre>
285-
</li>
286-
<li>
287-
<p>Install from a downloaded distribution archive
288-
(links are in the <a href="pywbem/installation.html#table1">table above</a>),
289-
into new Python 2.7 virtual environment (assuming OS-level prerequisites are
290-
already satisfied):</p>
291-
<pre><code># Have pywbem-{version}.zip downloaded
292-
tar -xf pywbem-{version}.zip
293-
cd pywbem-{version}
294-
mkvirtualenv -p python2.7 pywbem27
295-
python setup.py develop
296-
</code></pre>
297-
</li>
298-
</ul>
299-
300-
<h2>Test of the installation</h2>
301-
302-
<p>To test that PyWBEM is sucessfully installed, start up a Python interpreter
303-
and try to import the pywbem module:</p>
304-
<pre><code>python -c "import pywbem"
305-
</code></pre>
306-
307-
<p>If you do not see any error messages after the import command, PyWBEM has
308-
been sucessfully installed and its dependencies are available.</p>
309-
310-
<h2>Troubleshooting</h2>
311-
312-
<p>Here are some hints in case of trouble during the installation of
313-
PyWBEM:</p>
314-
315-
<h3>AttributeError for 'NullHandler' during mkvirtualenv on Python 2.6</h3>
316-
317-
<p>If the mkvirtualenv command fails on Python 2.6 with this error:</p>
318-
<pre>
319-
. . .
320-
File "/usr/lib/python2.6/site-packages/stevedore/__init__.py", line 23, in <module>
321-
LOG.addHandler(logging.NullHandler())
322-
AttributeError: 'module' object has no attribute 'NullHandler'
323-
</pre>
324-
<p>then the 'stevedore' PyPI package is too recent(!) The owners of that
325-
package spent effort to remove the previously existing Python 2.6 support in
326-
some steps, starting with v1.10.</p>
327-
328-
<p>The solution is to use v1.9. Note that for virtualenvwrapper to use it, it
329-
must be installed into the system Python:</p>
330-
331-
<pre><code>sudo pip install stevedore==1.9</code></pre>
332-
333-
<h3>TypeError about StreamHandler argument 'stream' during mkvirtualenv on Python 2.6</h3>
334-
335-
<p>If the mkvirtualenv command fails on Python 2.6 with this error:</p>
336-
<pre>
337-
. . .
338-
File "/usr/lib/python2.6/site-packages/virtualenvwrapper/hook_loader.py", line 101, in main
339-
console = logging.StreamHandler(stream=sys.stderr)
340-
TypeError: __init__() got an unexpected keyword argument 'stream'
341-
</pre>
342-
<p>then the 'virtualenvwrapper' PyPI package is too old. A fix for that is currently
343-
only in the master branch of its source repository, and has not been released to PyPI
344-
yet (currently, v4.7.1 is the latest version on PyPI.</p>
345-
346-
<p>The solution is to clone its repository and to install from its working
347-
directory. Note that it must be installed into the system Python:</p>
348-
349-
<pre><code>git clone https://bitbucket.org/dhellmann/virtualenvwrapper.git virtualenvwrapper
350-
cd virtualenvwrapper
351-
sudo python setup.py install</code></pre>
352-
353-
<h3>Swig error 'Unrecognized option -builtin' during M2Crypto install</h3>
354-
355-
<p>On Python 2.x, PyWBEM uses the M2Crypto package from PyPI and installs it
356-
during its own installation. The M2Crypto package invokes the Swig tool during
357-
its installation. If the version of Swig is too old, the invocation of Swig
358-
fails with:</p>
359-
360-
<pre>swig error : Unrecognized option -builtin</pre>
361-
362-
<p>The solution is to use Swig v2.0 or higher.</p>
363-
364-
<p>If your operating system does not provide this version of Swig as a
365-
package, you need to build it from its sources.</p>
33+
<p>The PyWBEM Client can be installed directly from
34+
<a href="https://pypi.python.org/pypi/pywbem" target="_blank">PyPI</a>.
35+
using <code>pip install</code>.</p>
36636

367-
<p>The PyWBEM setup script is able to install Swig if available as a package,
368-
or otherwise to build it from its sources, as described in
369-
<a href="pywbem/installation.html#inst_arch">Install from a downloaded
370-
distribution archive</a>.</p>
37+
For more details on the installation, see
38+
<a href="https://pywbem.readthedocs.io/en/latest/intro.html#installation" target="_blank">Installation</a>.</p>
37139

37240
<h2>Next steps</h2>
37341

0 commit comments

Comments
 (0)