From 4b5d2c8208bd4e245ff22f5dc89d1cee0eef06bb Mon Sep 17 00:00:00 2001 From: Andreas Maier Date: Sun, 28 Jul 2024 08:03:20 +0200 Subject: [PATCH] Removed updating of pywbem.github.io from release instructions Signed-off-by: Andreas Maier --- pywbem/installation.html | 342 +-------------------------------------- 1 file changed, 5 insertions(+), 337 deletions(-) diff --git a/pywbem/installation.html b/pywbem/installation.html index caeec16..32215bd 100644 --- a/pywbem/installation.html +++ b/pywbem/installation.html @@ -26,348 +26,16 @@

PyWBEM Client - Installation

-

Downloads

- -

The following distribution archives are available for download:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
VersionReleasedStatusPyPIChange LogAPI Documentation
1.7.22024-04-18Latest stable release, in fix modePyPIChange LogAPI Documentation
1.6.32024-03-27Stable release, out of servicePyPIChange LogAPI Documentation
1.5.02022-10-12Stable release, out of servicePyPIChange LogAPI Documentation
1.4.22022-10-11Stable release, out of servicePyPIChange LogAPI Documentation
1.3.02021-12-04Stable release, out of servicePyPIChange LogAPI Documentation
1.2.12021-11-30Stable release, out of servicePyPIChange LogAPI Documentation
1.1.32021-01-01Stable release, out of servicePyPIChange LogAPI Documentation
1.0.32020-10-05Stable release, out of servicePyPIChange LogAPI Documentation
0.17.62020-10-05Stable release, fixed only in emergency casesPyPIChange LogAPI Documentation
0.16.02020-01-09Stable release, out of servicePyPIChange LogAPI Documentation
0.15.02019-12-01Stable release, out of servicePyPIChange LogAPI Documentation
0.14.62019-10-10Stable release, out of servicePyPIChange LogAPI Documentation
0.13.12019-03-14Stable release, out of servicePyPIChange LogAPI Documentation
0.12.62018-09-13Stable release, out of servicePyPIChange LogAPI Documentation
0.11.02017-09-27Stable release, out of servicePyPIChange LogAPI Documentation
0.10.12017-09-27Stable release, out of servicePyPIChange LogAPI Documentation
0.9.12016-11-30Stable release, out of servicePyPIChange LogAPI Documentation
0.8.42016-05-13Stable release, out of servicePyPIChange LogAPI Documentation
0.7.02008-12-12Stable release, out of servicePyPIChange LogN/A
- -

Older releases of the PyWBEM Client are available on -PyPI -and GitHub.

Installation

-

The PyWBEM Client can be installed quite easily by running its standard Python setup -script (setup.py) with the "install" command, or by using -pip install (which also invokes the setup script).

- -

As of PyWBEM Client v0.8, the setup script has support for installing its -prerequisites. This includes installing the M2Crypto Python package, installing -any prerequisite OS-level packages, and installing or building Swig, if needed. -For details, see the examples, below.

- -

OS-level prerequisites are installed using new setup.py commands 'install_os' -and 'develop_os'. They are supported for a number of well-known Linux -distributions. For other Linux distributions, these commands display the -OS-level packages that are needed. On Linux, these commands use 'sudo', so -your userid needs to be authorized accordingly.

- -

Installation of the PyWBEM Client is supported into the default system -Python, and (preferrable) into -virtual -Python environments. For details, see the examples, below.

- -

Examples

- - - -

The command syntax above is shown for Linux, but this works the same way on -Windows and on other operating systems supported by Python.

- -

Installation in development mode

- -

The installation of PyWBEM in development mode is supported as well. -Development mode means that any OS-level packages and Python packages needed for -development of the PyWBEM Client are being made available. These packages -are a superset of the packages needed for just using the PyWBEM client.

- -

Examples

- - - -

Test of the installation

- -

To test that PyWBEM is sucessfully installed, start up a Python interpreter -and try to import the pywbem module:

-
python -c "import pywbem"
-
- -

If you do not see any error messages after the import command, PyWBEM has -been sucessfully installed and its dependencies are available.

- -

Troubleshooting

- -

Here are some hints in case of trouble during the installation of -PyWBEM:

- -

AttributeError for 'NullHandler' during mkvirtualenv on Python 2.6

- -

If the mkvirtualenv command fails on Python 2.6 with this error:

-
-  . . .
-  File "/usr/lib/python2.6/site-packages/stevedore/__init__.py", line 23, in 
-    LOG.addHandler(logging.NullHandler())
-AttributeError: 'module' object has no attribute 'NullHandler'
-
-

then the 'stevedore' PyPI package is too recent(!) The owners of that -package spent effort to remove the previously existing Python 2.6 support in -some steps, starting with v1.10.

- -

The solution is to use v1.9. Note that for virtualenvwrapper to use it, it -must be installed into the system Python:

- -
sudo pip install stevedore==1.9
- -

TypeError about StreamHandler argument 'stream' during mkvirtualenv on Python 2.6

- -

If the mkvirtualenv command fails on Python 2.6 with this error:

-
-  . . .
-  File "/usr/lib/python2.6/site-packages/virtualenvwrapper/hook_loader.py", line 101, in main
-    console = logging.StreamHandler(stream=sys.stderr)
-TypeError: __init__() got an unexpected keyword argument 'stream'
-
-

then the 'virtualenvwrapper' PyPI package is too old. A fix for that is currently -only in the master branch of its source repository, and has not been released to PyPI -yet (currently, v4.7.1 is the latest version on PyPI.

- -

The solution is to clone its repository and to install from its working -directory. Note that it must be installed into the system Python:

- -
git clone https://bitbucket.org/dhellmann/virtualenvwrapper.git virtualenvwrapper
-cd virtualenvwrapper
-sudo python setup.py install
- -

Swig error 'Unrecognized option -builtin' during M2Crypto install

- -

On Python 2.x, PyWBEM uses the M2Crypto package from PyPI and installs it -during its own installation. The M2Crypto package invokes the Swig tool during -its installation. If the version of Swig is too old, the invocation of Swig -fails with:

- -
swig error : Unrecognized option -builtin
- -

The solution is to use Swig v2.0 or higher.

- -

If your operating system does not provide this version of Swig as a -package, you need to build it from its sources.

+

The PyWBEM Client can be installed directly from +PyPI. +using pip install.

-

The PyWBEM setup script is able to install Swig if available as a package, -or otherwise to build it from its sources, as described in -Install from a downloaded -distribution archive.

+For more details on the installation, see +Installation.

Next steps