Professional Documents
Culture Documents
E58680-02
February 2015
Table of Contents
Preface .............................................................................................................................................. v
1 Release Notes ................................................................................................................................ 1
1.1 About Spacewalk 2.2 for Oracle Linux 6 ............................................................................... 1
1.2 Installing and Upgrading Spacewalk ...................................................................................... 1
1.2.1 Oracle Linux Requirements ........................................................................................ 1
1.2.2 Database Requirements ............................................................................................ 2
1.2.3 Storage Requirements ............................................................................................... 3
1.2.4 Network Requirements .............................................................................................. 3
1.2.5 Installing Spacewalk .................................................................................................. 3
1.2.6 Upgrading Spacewalk to Release 2.2 ......................................................................... 5
1.3 Configuring Spacewalk ......................................................................................................... 7
1.3.1 Configuring Software Channels Using ULN ................................................................. 8
1.3.2 Configuring Software Channels Using Public Yum ....................................................... 8
1.3.3 Synchronizing Software Channels .............................................................................. 9
1.3.4 Creating Activation Keys for Spacewalk Clients ......................................................... 10
1.4 Installing the Spacewalk Client and Registering Servers ....................................................... 11
1.5 Known Issues .................................................................................................................... 12
1.5.1 Spacewalk Fails to Install Due to slf4j Package ..................................................... 12
1.5.2 Tomcat Fails to Start After Spacewalk Configuration .................................................. 12
1.5.3 Spacewalk Client Fails to Install on Oracle Linux 5 .................................................... 13
1.5.4 Oracle Linux 5 Does Not Register with Spacewalk after Kickstart Installation ............... 13
1.5.5 PXE Booting Fails Due to Incorrect Host Name Configuration .................................... 13
1.5.6 Out of Memory Issues With Large Repositories or Data Sets ...................................... 13
1.5.7 Client Registration Issues ........................................................................................ 13
1.5.8 Clients Have to Prerequisite After an Upgrade .......................................................... 13
1.5.9 Issues With Kickstart After an Upgrade, .................................................................... 14
A Legal Notices ............................................................................................................................... 15
A.1 Oracle Legal Notices ......................................................................................................... 15
A.2 DocBook XSL License ....................................................................................................... 16
iii
iv
Preface
The Spacewalk 2.2 for Oracle Linux Release Notes provides details of the Spacewalk 2.2 release available
from Oracle.
Audience
This document is written for system administrators who want to use Spacewalk to manage Oracle Linux
systems. It is assumed that readers have a general understanding of the Linux operating system.
Conventions
The following text conventions are used in this document:
Convention
Meaning
boldface
italic
Italic type indicates book titles, emphasis, or placeholder variables for which
you supply particular values.
monospace
vi
Database Requirements
As a minimum, a Spacewalk server should have 8GB RAM. If the Spacewalk server also runs the
database for the Spacewalk data, this memory requirement is in addition to what is required to run the
database.
To connect to an Oracle Database, Oracle Instant Client release 11.2.0.3 or later must be installed on
the Spacewalk server. The Spacewalk server configuration fails if the Instant Client is missing. Oracle
recommends that you install the latest 11gR2 release of the Instant Client. You can download the Instant
Client from:
http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html
The following are the required packages:
Instant Client Package - Basic
Storage Requirements
Purpose
69/udp
80/tcp
443/tcp
5222/tcp
5269/tcp
If the Spacewalk server needs to connect though a proxy, you can configure the proxy in the following
places:
The /etc/rhn/rhn.conf file.
The Spacewalk web interface.
Go to Overview, then Configure Spacewalk, and then General.
Installing Spacewalk
To prevent the jta package from being installed when you install Spacewalk, either disable the Oracle
Linux 6 Add ons [ol6_addons] channel, or add the jta package to the exclude directive in the yum
configuration file /etc/yum.conf, for example:
exclude=jta*
3. Install Spacewalk.
If you are using an Oracle database:
# yum install spacewalk-oracle
You can safely ignore any SELinux restorecon messages that are displayed when the packages are
installed.
4. Configure Spacewalk.
If you are using an Oracle database, either on the same server or on a remote server, use the following
command:
# spacewalk-setup --disconnected --external-oracle
Password? **
Database: Testing database connection.
** Database: Populating database.
*** Progress: ############################################################
* Setting up users and groups.
** GPG: Initializing GPG and importing key.
** GPG: Creating /root/.gnupg directory
You must enter an email address.
Admin Email Address? my.email@domain.com
* Performing initial configuration.
* Activating Spacewalk.
** Loading Spacewalk Certificate.
** Verifying certificate locally.
** Activating Spacewalk.
* Enabling Monitoring.
* Configuring apache SSL virtual host.
Should setup configure apache's default ssl server for you (saves original ssl.conf) [Y]? y
** /etc/httpd/conf.d/ssl.conf has been backed up to ssl.conf-swsave
* Configuring tomcat.
** /etc/sysconfig//tomcat6 has been backed up to tomcat6-swsave
** /etc/tomcat6//server.xml has been backed up to server.xml-swsave
** /etc/tomcat6//web.xml has been backed up to web.xml-swsave
* Configuring jabberd.
* Creating SSL certificates.
CA certificate password?
Re-enter CA certificate password?
Organization? Oracle Demo
Organization Unit [spacewalk.domain.com]? spacewalk.domain.com
Email Address [your.email@domain.com]? my.email@domain.com
City? Redwood Shores
State? CA
Country code (Examples: "US", "JP", "IN", or type "?" to see a list)? US
** SSL: Generating CA certificate.
** SSL: Deploying CA certificate.
** SSL: Generating server certificate.
** SSL: Storing SSL certificates.
* Deploying configuration files.
* Update configuration in database.
* Setting up Cobbler..
Processing /etc/cobbler/modules.conf
`/etc/cobbler/modules.conf' -> `/etc/cobbler/modules.conf-swsave'
Processing /etc/cobbler/settings `/etc/cobbler/settings' -> `/etc/cobbler/settings-swsave'
cobblerd does not appear to be running/accessible
Cobbler requires tftp and xinetd services be turned on for PXE provisioning functionality.
Enable these services [Y]? y
cobblerd does not appear to be running/accessible
* Restarting services.
Installation complete.
Visit https://spacewalk.domain.com to create the Spacewalk administrator account.
b. (PostgreSQL database only) Run the following commands to create the pltclu language:
# /usr/bin/spacewalk-cfg-get db_name
rhnschema
# su - postgres -c 'PGPASSWORD=<password>; createlang pltclu <rhnschema>;'
c. (Oracle database only) Grant additional rights to the Spacewalk database user:
Configuring Spacewalk
The output of the spacewalk-schema-upgrade command confirms whether or not the schema
upgrade was successful. In the event of a failure:
Check the log files in the /var/log/spacewalk/schema-upgrade directory to establish the
cause.
Restore the database from the backup.
Fix the cause of the problem, for example by extending the tablespaces if there is insufficient
space.
Upgrade the database schema.
8. Upgrade the Spacewalk configuration.
If you are using an Oracle database:
# spacewalk-setup --disconnected --external-oracle --upgrade
If you have customized the Spacewalk installation, for example in /etc/rhn/rhn.conf, restore the
customizations from your backup.
9. (Optional) Enable monitoring and the monitoring scout.
To enable monitoring without enabling the monitoring scout:
# /usr/share/spacewalk/setup/upgrade/rhn-enable-monitoring.pl
After you edit the configuration file, ensure that the file permissions are read-only (0400) by root. This is
an important security step to protect the ULN credentials.
Once the ULN plug-in is configured, you create the Spacewalk software channels and repositories in the
normal way using the Spacewalk web interface. When you specify the URL for a ULN repository, use a
URL in the following format:
uln:///<ULN channel label>
Note
The URL must contain three forward slash (/) characters. For example:
uln:///ol6_x86_64_latest
You can get a list of available ULN channel labels by logging in to ULN (https://linux.oracle.com) and
selecting the Channels tab.
oraclelinux6-addons
oraclelinux6-uek
oraclelinux6-uek-r3
oraclelinux6-mysql
oraclelinux6-playground
oraclelinux6-spacewalk20-client
oraclelinux6-spacewalk20-server
oraclelinux6-spacewalk22-client
oraclelinux6-spacewalk22-server
For Oracle Linux 5 (i386 and x86_64):
oraclelinux5 (base channel)
oraclelinux5-addons
oraclelinux5-oracle-addons
oraclelinux5-unsupported
oraclelinux5-uek
oraclelinux5-spacewalk20-client
oraclelinux5-spacewalk22-client
For example, to create all the 32bit and 64bit software channels for Oracle Linux 6, install the
spacewalkutils package and then run the spacewalkcommonchannels tool, as follows:
# yum install spacewalkutils
# spacewalkcommonchannels -v -u <admin> -p <password> -a i386,x86_64 -k unlimited oraclelinux6*
For example:
# spacewalk-repo-sync -t uln -c oraclelinux6_x86_64_latest -u uln:///ol6_x86_64_latest
To synchronize a channel with an Oracle Public Yum repository, use the following format:
# spacewalk-repo-sync -c <Spacewalk channel label> -u http://<repo URL>
For example:
# spacewalk-repo-sync -c oraclelinux6_x86_64_latest \
-u http://public-yum.oracle.com/repo/OracleLinux/OL6/latest/x86_64/
For example, if you select oraclelinux-x86_64 as the label, the key that is actually created might
be called 1-oraclelinux-x86_64. This enables you to create multiple activation keys for the
same base channel, each with different configuration options. The name you use is presented during
Spacewalk client registration and creating your own key labels helps you to select the right key.
11
Known Issues
baseurl=http://public-yum.oracle.com/repo/OracleLinux/OL5/spacewalk22/client/$basearch/
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-oracle
gpgcheck=1
enabled=1
2. (Oracle Linux 5 only) Remove the pirut, up2date, and up2dategnome packages.
Use the rpm -e --nodeps command to remove these packages.
In your Oracle Linux 5 Kickstart profiles in Spacewalk, exclude these packages from installation by
inserting a dash character (-) in front of the package name in the Kickstart profile on the Software,
Package Group screen, for example:
@Base
-pirut
-up2date
-up2date-gnome
This command replaces the existing packages and deletes a registered server from ULN.
4. Register the server with Spacewalk using the rhnreg_ks command.
Before you can register a server, you must have already created a client activation key, as described in
Section 1.3.4, Creating Activation Keys for Spacewalk Clients. If enabled, a universal default key can
be used. However, using a specific activation key is better.
You can use the rhn_register command to register a server with Spacewalk but this command does
not use an activation key. If you use this command, you have to manually subscribe the registered
server to the correct channels and manually add it to any system groups.
5. Disable access to the Spacewalk Client repository.
Disable Spacewalk Client repository in the Oracle public yum repository configuration file, or delete
your Spacewalk Client .repo file.
12
1.5.4 Oracle Linux 5 Does Not Register with Spacewalk after Kickstart
Installation
If Oracle Linux 5 does not register with Spacewalk after Kickstart installation, add -up2date and up2date-gnome to the Kickstart profile on the Software, Package Group screen.
13
If this happens, use either the rhn_register or the rhnreg_ks --force command to re-register the
client.
14
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website
at
15
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Warranty
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH
OR ANY OTHER CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
16
The above copyright notice and this permission notice shall be included in all copies or substantial
portions of the Software.
Except as contained in this notice, the names of individuals credited with contribution to this software
shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software
without prior written authorization from the individuals in question.
Any stylesheet derived from this Software that is publicly distributed will be identified with a different
name and the version strings in any derived Software will be changed so that no possibility of confusion
between the derived package and this Software will exist.
Warranty: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL DAVID
CRAMER, KASUN GAJASINGHE, OR ANY OTHER CONTRIBUTOR BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
Certain search characteristics associated with the DocBook XSL webhelp stylesheets are provided as
javascript files generated using Apache Lucene and other fourth party technologies.
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use,
reproduction, and distribution as defined by Sections 1 through
9 of this document.
"Licensor" shall mean the copyright owner or entity authorized
by the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under
common control with that entity. For the purposes of this
definition, "control" means (i) the power, direct or indirect,
to cause the direction or management of such entity, whether by
contract or otherwise, or (ii) ownership of fifty percent (50%)
or more of the outstanding shares, or (iii) beneficial ownership
of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making
modifications, including but not limited to software source code,
documentation source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
17
18
19
20