Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.
3. JBoss Operations Network Prerequisites and Basic Installation
The list of supported platforms for JBoss Operations Network are listed at https://access.redhat.com/site/articles/112523.
3.1. Supported Configuration Information Link kopierenLink in die Zwischenablage kopiert!
Link kopierenLink in die Zwischenablage kopiert!
3.1.1. Changes in Required Java Versions Link kopierenLink in die Zwischenablage kopiert!
Link kopierenLink in die Zwischenablage kopiert!
JBoss ON supports two versions of Java:
- Java 6 (deprecated)
- Java 7 (new)
Both Oracle and OpenJDK Java are supported.
The server requires the JDK, while the agent only requires the JRE.
3.1.2. Changes in Supported Web Browsers Link kopierenLink in die Zwischenablage kopiert!
Link kopierenLink in die Zwischenablage kopiert!
JBoss ON has added these browsers that are used for testing and are supported for version 3.2.
- Firefox 17 ESR (new)
- Internet Explorer 9 (new)
3.2. Quick Setup for JBoss Operations Network 3.2 Link kopierenLink in die Zwischenablage kopiert!
Link kopierenLink in die Zwischenablage kopiert!
The Installation Guide has more information on configuring databases for the JBoss ON server, upgrading servers, and other installation information. This is a quick summary of performing an initial installation.
- Set up a database named
rhq
and a database user namedrhqadmin
. Make sure the database user has adequate permissions to perform operations on the JBoss ON database.For more detailed database setup information: - Download the JBoss ON binaries from the Customer Portal.
- In the Customer Portal, click the Downloads tab, and then the Downloads icon in the page.
- Select the JBoss Operations Network link under the System Management area in the Downloads page.
- Download the JBoss Operations Network 3.2 Base Distribution package by clicking the Download icon.
- There are additional plug-in packs available for EAP, EDS, EWS, and SOA-P. If any of those plug-ins will be used with the JBoss ON server, then download them as well.
- Unzip the server distribution to the desired home directory for JBoss ON. For example:
unzip jon-server-3.2.zip -d /opt/jon
[root@server ~]# unzip jon-server-3.2.zip -d /opt/jon
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This creates a version-specific installation directory,/opt/jon/jon-server-3.2
. A directory with this name should not exist prior to the unzip operation. - Optional. By default, the installer script assumes that the backend database is a PostgreSQL server running on the same system as the server. The server configuration settings — such as the database password, the server port numbers, the server name, and the way it handles database schema — use predefined defaults. One parameter, the bind address for the server, is empty and prompted by the control script if it is not set.The parameters are set in the
serverRoot/jon-server-3.2/bin/rhq-server.properties
file. - Run the JBoss ON control script to configure the server and other services. If the
rhq-server.properties
file is not edited, then the script prompts for a bind address for the server; this can be set to0.0.0.0
.Copy to Clipboard Copied! Toggle word wrap Toggle overflow This command does two things:- Configure the JBoss ON server, a storage node, and an agent.
- Start all services when the configuration process is complete.
3.3. Upgrading to JBoss Operations Network 3.2 Link kopierenLink in die Zwischenablage kopiert!
Link kopierenLink in die Zwischenablage kopiert!
Warning
It is not possible to revert your JBoss ON server to the previous version after it is upgraded. Back up all data before upgrading.
The Installation Guide has more information on configuring databases for the JBoss ON server, upgrading servers, and other installation information. This is a quick summary of performing an initial installation.
- Stop the JBoss ON agent running on the server machine. Agents installed with the server are not autoupdated and must be updated with the JBoss ON server. All other agents will update themselves automatically when the server is upgraded.This is done by stopping the agent service or by using the
exit
command at the agent command prompt.agentRoot/rhq-agent/bin/rhq-agent.sh exit
[root@server ~]# agentRoot/rhq-agent/bin/rhq-agent.sh > exit
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Windows only. If the
RHQ_AGENT_RUN_AS
orRHQ_AGENT_RUN_AS_ME
parameter was set in the agent'srhq-agent-env.bat
file, then there must be a password and the password prompt must be disabled.RHQ_AGENT_PASSWORD=secret RHQ_AGENT_PASSWORD_PROMPT=false
RHQ_AGENT_PASSWORD=secret RHQ_AGENT_PASSWORD_PROMPT=false
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Note
If one of theRHQ_AGENT_RUN_AS*
parameters is set without a password, then the agent upgrade process hangs.Alternatively, theRHQ_AGENT_RUN_AS*
parameter can be removed prior to upgrading. - Stop any currently running JBoss ON instances.If the JBoss ON server being upgraded is part of a high availability cloud, then all of the existing JBoss ON instances must also be stopped.
serverRoot/jon-server-3.1.0.GA/rhq-server.sh stop
[root@server ~]# serverRoot/jon-server-3.1.0.GA/rhq-server.sh stop
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Download the server packages from the Customer Portal.
- Click Software in the top menu.
- In the Product field, select the product.
- Back up the server database before going through the upgrade script. In case there is a problem with the upgrade process, the backup allows you to restore to its previous state.
- Unzip the server packages.
unzip jon-server-3.2.zip -d serverRoot/jon-server-3.2
[root@server ~]# unzip jon-server-3.2.zip -d serverRoot/jon-server-3.2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Important
Do not copy the new server installation on top of a previous server installation.The directory structure within the server package gives the new server installation directory a version-specific name, such as/opt/jon/jon-server-3.2
. - Optional. Copy over any changes in the original
rhq-server.properties
file to the new file inserverRoot/jon-server-3.2/bin
. Changes to this file include things like setting up SSL and enabling SMTP for email notifications. - Run the
rhqctl
script with theupgrade
subcommand and options for the original server and agent installation directories. For example:./serverRoot/jon-server-3.2/bin/rhqctl upgrade --server-dir /opt/rhq/rhq-server-old --from-agent-dir /home/rhq/rhq-agent-old --run-data-migrator
[root@server ~]# ./serverRoot/jon-server-3.2/bin/rhqctl upgrade --server-dir /opt/rhq/rhq-server-old --from-agent-dir /home/rhq/rhq-agent-old --run-data-migrator
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Theupgrade
command installs and configures a storage database automatically as part of upgrade; the--run-data-migrator
option migrates the existing monitoring data into the new database. Otherwise, all historic monitoring data would be lost. - Start the JBoss ON server and agent.
serverRoot/jon-server-3.2/bin/rhqctl start
[root@server ~]# serverRoot/jon-server-3.2/bin/rhqctl start
Copy to Clipboard Copied! Toggle word wrap Toggle overflow