How To: Installing The vFabric Hyperic 4.6.6 Server And Agent

Home



Welcome again!

This is the new beginning for the tutorials about vFabric Hyperic where you are going to learn how to work with this powerful Application Manager.

vFabric Hyperic is a valuable software for your consideration if you want Management and Monitor your Spring Enterprise applications.

Before to start the tutorial be sure to create an account in VMWare Home Page

Figure 01: The Log In VMWare Home Page

For this tutorial I am going to work with the follow software:

  • Linux Fedora Core 17
  • Oracle Java JDK 7 update 04
  • VMware vFabric Hyperic 4.6.6 Server and Agent

Step 01: Getting The vFabric Hyperic 4.6.6 Server And Agent

To make this step instruction easier, be sure to be already logged in VMware and just do click in All Downloads. Once done this, you must see the follow page.

Figure 02: The VMware’s All Downloads Page

In the same page, the section of our interest is Product Download Index how you can see below.

Figure 03: The Product Download Index Page

Now locate the sub section Application Management and do click in the item or option named VMware vFabric Hyperic. Once done this, you must arrive to the follow page.

Figure 04: The Download VMware vFabric Hyperic 4.6 Page (Top Part)

In the same page go below and you must see the follow.

Figure 05: The Download VMware vFabric Hyperic 4.6 Page (Bottom Part)

Now, we have two sections of our interest, these are:

  1. VMware vFabric Hyperic 4.6.6 Server and Agent
  2. VMware vFabric Hyperic 4.6.6 Agent Only

I am going to work with the first option, therefore, for the same item VMware vFabric Hyperic 4.6.6 Server and Agent, do click in View Download button. Therefore you must arrive to the follow page, I am including three images to complete the main page.

Figure 06: The Download VMware vFabric Hyperic 4.6.6 S… Page (Top Part)

Figure 07: The Download VMware vFabric Hyperic 4.6.6 S… Page (Middle Part)

Figure 08: The Download VMware vFabric Hyperic 4.6.6 S… Page (Bottom Part)

We are able to download the installer in many presentations according to the Operating System of our preference, for Linux these are:

  • hyperic-hqee-installer-4.6.6-x86-64-linux.tar.gz
  • hyperic-hqee-installer-4.6.6-x86-linux.tar.gz

And others based on .rpm

But we have a warning message (See Figure 06), we must do a registration process before, therefore do click in Download Free Trial (See Figure 06). Once done this, you must arrive to.

Figure 09: The VMware vFabric Hyperic Product Evaluation Center Page

Just do click in the Register button, you must arrive to the Accept End-User License Agreement page

Figure 10: The Accept End-User License Agreement Page (Top Part)

Proceed to fill the mandatory fields requested and accept the VMware vFabric Hyperic End User License Agreement and press the Continue button.

Figure 11: The Accept End-User License Agreement Page (Bottom Part)

Once done this, you must arrive again into the page VMware vFabric Hyperic Product Evaluation Center but now located in the tab pane named License & Download, for a better understanding see the follow image.

Figure 12: The VMware vFabric Hyperic Product Evaluation Center Page – (License & Download Part)

In the section Download Packages We have two sections to work, these are:

  • Binaries – VMware vFabric Hyperic Server and Agent
  • Binaries – VMware vFabric Hyperic Agent Only

Check the follow image for a better understanding (be advised, these two sections are collapsed):

Figure 13: The VMware vFabric Hyperic Product Evaluation Center Page – (Download Packages Part)

Note: Now with the Figure 13 where we have the software already registered, we must now ignore the Figures 06,07,08, because in such point, we had not the software registered.

Lets expand the section Binaries – VMware vFabric Hyperic Server and Agent to see what items we have available to download, I am using three images to show you the main page.

Figure 14: The VMware vFabric Hyperic Product Evaluation Center Page – (Download Packages Part) – (VMware vFabric Hyperic Server and Agent – Binaries Part) (Part I)

Figure 15: The VMware vFabric Hyperic Product Evaluation Center Page – (Download Packages Part) – (VMware vFabric Hyperic Server and Agent – Binaries Part) (Part II)

Figure 16: The VMware vFabric Hyperic Product Evaluation Center Page – (Download Packages Part) – (VMware vFabric Hyperic Server and Agent – Binaries Part) (Part III)

Since we are working in Linux, I am going to download the option Binary (.tar.gz) and for the architecture of 32 bits, therefore do click in Manually Download, you must get the hyperic-hqee-installer-4.6.6-x86-linux.tar.gz file. Take your time, this file has a size of 417MB. I downloaded the file into my Desktop directory

Figure 17: The hyperic-hqee-installer-4.6.6-x86-linux.tar.gz File Installer Downloaded Into The Desktop Directory

Note: Be sure to do a checksum for this file, it is a wise practice.

Step 02: Creating The Installation Directory

I am going to create and work in the follow path directory whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent.

Then, open the terminal 01 to create the path directory suggested above, but before, be sure to be located in your home user directory, I mean, /home/username. Bear in mind, when you open a new terminal by default it is already located in your home user directory. If you want confirm explicitly where you are located in some terminal, you can use the command pwd.

[section1@localhost ~]$ pwd
/home/section1
[section1@localhost ~]$

Listing 01: Terminal 01 – Knowing The Current Location Within A Terminal

My username is section1. Then we can now create the path directory. In the current terminal 01 execute the command mkdir -p whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent.

[section1@localhost ~]$ mkdir -p whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent
[section1@localhost ~]$ 

Listing 02: Terminal 01 – Creating The whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent Path Directory

Below the new directory created after of the command execution.

Figure 18: The whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent Path Directory Empty

Step 03: Copying The File Installer To Our Customized Installation Directory

Proceed to copy (or move if you want it) the hyperic-hqee-installer-4.6.6-x86-linux.tar.gz installer to our path directory whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent. You must see the follow.

Figure 19: The whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent Path Directory With The hyperic-hqee-installer-4.6.6-x86-linux.tar.gz File Installer

Step 04: Moving Us To Our Customized Installation Directory

In the terminal 01 execute the command cd whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent

[section1@localhost ~]$ cd whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent
[section1@localhost serverandagent]$ 

Listing 03: Terminal 01 – Moving Us To The whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent Path Directory

You can know our new location executing again the command pwd in the terminal 01.

[section1@localhost serverandagent]$ pwd
/home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent
[section1@localhost serverandagent]$

Listing 04: Terminal 01 – Knowing The Current Location Within A Terminal

Step 05: Unpacking The .tar.gz File Installer

Now is the turn to work around with the .tar.gz file, we only need to unpack it. Therefore again in the terminal 01 execute the command tar -zxvf hyperic-hqee-installer-4.6.6-x86-linux.tar.gz

[section1@localhost serverandagent]$ tar -zxvf hyperic-hqee-installer-4.6.6-x86-linux.tar.gz
...
[section1@localhost serverandagent]$

Listing 05: Terminal 01 – Unpacking The .tar.gz File Installer

The three dots (…) represent a long output when you execute the command indicated.

After of the execution of the command a new directory named hyperic-hqee-installer-4.6.6 must appear, like shown below.

Figure 20: The hyperic-hqee-installer-4.6.6 New Directory Created After To Unpack The hyperic-hqee-installer-4.6.6-x86-linux.tar.gz File Installer

Step 06: Knowing The hyperic-hqee-installer-4.6.6 Directory (Optional)

Let’s see what directories exists within the hyperic-hqee-installer-4.6.6 directory

Figure 21: The hyperic-hqee-installer-4.6.6 Directory Content

Do realize yourself we have even other two packed files, these are:

  • server-4.6.6.tar.gz
  • hyperic-hqee-agent-4.6.6-x86-linux.tar.gz

Really from them, we are able to install the Server and the Agent through the setup.sh file script.

Step 07: Moving Us To The hyperic-hqee-installer-4.6.6 Directory

Again in the terminal 01 just execute the command cd hyperic-hqee-installer-4.6.6

[section1@localhost serverandagent]$ cd hyperic-hqee-installer-4.6.6
[section1@localhost hyperic-hqee-installer-4.6.6]$ 

Listing 06: Terminal 01 – Moving Us To The hyperic-hqee-installer-4.6.6 Path Directory

Step 08: Executing The setup.sh File Script (Part I)

Before to execute setup.sh file script, we must give it execution permission, therefore, in the terminal 01 execute the command chmod +x setup.sh

[section1@localhost hyperic-hqee-installer-4.6.6]$ chmod +x setup.sh
[section1@localhost hyperic-hqee-installer-4.6.6]$ 

Listing 07: Terminal 01 – Giving Execution Permission To The setup.sh File Script

Now we can execute the setup.sh file script, therefore in the terminal 01 execute the command (really the script) ./setup.sh. You should get the follow in your terminal.

[section1@localhost hyperic-hqee-installer-4.6.6]$ ./setup.sh
Unpacking JRE to temporary directory /tmp/jre
Please ignore references to missing tools.jar
Unable to locate tools.jar. Expected to find it in /tmp/lib/tools.jar
Loading taskdefs...
Taskdefs loaded
Initializing Hyperic HQ 4.6.6 Installation...
accepted=${accept.eula}...
show-eula...

VMWARE END USER LICENSE AGREEMENT

PLEASE NOTE THAT THE TERMS OF THIS END USER LICENSE AGREEMENT SHALL GOVERN 
YOUR USE OF THE SOFTWARE, REGARDLESS OF ANY TERMS THAT MAY APPEAR DURING THE 
INSTALLATION OF THE SOFTWARE.

... ... ...

Additional License Terms

You may install and use the Software on Application Cache Nodes and Data 
Management Nodes which contain up to the maximum aggregate number of 
Processors, for which you have paid the applicable license fees.  

If you have purchased the "Unlimited Client Upgrade" for all of the Data 
Management Nodes within a Data Management Network, then you may connect an 
unlimited number of Application Cache Nodes to any Data Management Node 
within the Data Management Network.

If you have purchased the "Global WAN Upgrade" for all of the Data 
Management Nodes within a Data Management Network, then you may enable the 
Wide Area Network (WAN) communication for any Data Management Node within 
the Data Management Network.   




Do you accept the terms of the agreement? (y, n)

Listing 08: Terminal 01 – Executing The setup.sh File Script A First Time (Part I)

The three pattern dots (… … …) represent a long output about the licence when you execute the command indicated. Furthermore, the terminal 01 is waiting a user input, then write y where the terminal’s cursor is located, it is not shown in the previous listing, but is located just below of the last line, I mean Do you accept the terms of the agreement? (y, n).

When in the terminal 01 you write or choice y and press the intro key, you must see the follow output

Do you accept the terms of the agreement? (y, n)
y
Choose which software to install:
1: Hyperic HQ Server
2: Hyperic HQ Agent
You may enter multiple choices, separated by commas.

Listing 09: Terminal 01 – Executing The setup.sh File Script A First Time (Part II)

Because I want to start to work with the server firstly, within the terminal 01 yet, I am going to choice the option 1, it is Hyperic HQ Server, and press the intro key. Continuing with the setup process, it is going to ask for three things:

  • HQ server installation path
  • email address
  • database password

For these three requested values I am going to use:

  • /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6
  • default available, it is hqadmin@localhost.localdomain, therefore, just press the intro key
  • springsource, I am ignoring the default available, therefore I choice 2 and press the intro key and then I write the springsource value

For a better understanding, below the output in my terminal 01. How you can see, firstly, I must choice 1 and press the intro key to continue the setup process, then, I can write the values listed above:

Choose which software to install:
1: Hyperic HQ Server
2: Hyperic HQ Agent
You may enter multiple choices, separated by commas.
1
HQ server installation path [default '/home/hyperic']:
/home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6
Enter the email address that HQ will use as the sender for email messages [default 'hqadmin@localhost.localdomain']:

Choices:
	1: Yes
	2: No
Would you like to use an auto generated encryption key to encrypt the database password? [default '1']:
2
Enter an encryption key to use to encrypt the database password.:
springsource

Listing 10: Terminal 01 – Executing The setup.sh File Script A First Time (Part III)

Then, you must fill important data requested. It is about the admin user. I am going to use the follow values:

  • username: hqadmin, it is the default value, just press intro key
  • password: same value than the username, therefore, hqadmin.
  • email address: hqadmin@localhost.localdomain, it is the default value, just press intro key

Note: about the password data.It is requested twice and you can’t see the characters when they are written in the terminal.

Below the output in the terminal 01 for a better understanding.

What should the username be for the initial admin user? [default 'hqadmin']:

What should the password be for the initial admin user?: 
(again): 
What should the email address be for the initial admin user? [default 'hqadmin@localhost.localdomain']:

Listing 11: Terminal 01 – Executing The setup.sh File Script A First Time (Part IV)

To avoid some confusions and to give you a better panorama, below the complete visualization within the terminal 01 after to accept the terms of the agreement:

Do you accept the terms of the agreement? (y, n)
y
Choose which software to install:
1: Hyperic HQ Server
2: Hyperic HQ Agent
You may enter multiple choices, separated by commas.
1
HQ server installation path [default '/home/hyperic']:
/home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hq$
Enter the email address that HQ will use as the sender for email messages [default 'hqadmin@localhost.localdomain']:

Choices:
	1: Yes
	2: No
Would you like to use an auto generated encryption key to encrypt the database password? [default '1']:
2
Enter an encryption key to use to encrypt the database password.:
springsource
What should the username be for the initial admin user? [default 'hqadmin']:

What should the password be for the initial admin user?: 
(again): 
What should the email address be for the initial admin user? [default 'hqadmin@localhost.localdomain']:

Listing 12: Terminal 01 – Executing The setup.sh File Script A First Time – Complete Visualization After To Accept The Terms Of The Agreement

Once written the data for the admin user, you must see the follow output:

Loading install configuration...
Install configuration loaded.
Preparing to install...
Validating server install configuration...
Checking server webapp port...
Checking server secure webapp port...
Verifying admin user properties
Validating server DB configuration...
Installing the server...
Unpacking server to: /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6...
Creating server configuration files...
Using "small" installing profile...
Copying binaries and libraries to server installation...
Copying server configuration file...
Copying server db-upgrade files...
Copying server libs...
Setting up server database...

Now login to another terminal as root and execute this script:

    /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/installer/data/hqdb/tune-os.sh

This script sets up the proper shared memory settings to run the
built-in database.

Press Enter after you run the script to continue this installation.

Listing 13: Terminal 01 – Executing The setup.sh File Script A First Time (Part V)

From the output shown above, we have the follow important message

Now login to another terminal as root and execute this script:
/home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/installer/data/hqdb/tune-os.sh

To do that, see the follow step instruction

Step 09: Executing The tune-os.sh File Script

Open a terminal 02, you can do it in two ways:

  • Combination of keys within your terminal 01, it is Shift + Control + T
  • Through the Menu Bar, and proceed to select File / Open Tab

If you did realize, the new terminal 02 is located in the path directory /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6. Let’s get access to root privileges. Therefore, in the terminal 02 execute the command
su

[section1@localhost hyperic-hqee-installer-4.6.6]$ su
Password: 
[root@localhost hyperic-hqee-installer-4.6.6]# 

Listing 14: Terminal 02 – Executing The su Command

Now execute in the terminal 02 the command cd /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/installer/data/hqdb

[root@localhost hyperic-hqee-installer-4.6.6]# cd /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/installer/data/hqdb
[root@localhost hqdb]# 

Listing 15: Terminal 02 – Executing The cd /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/installer/data/hqdb Command

Now we can execute the tune-os.sh file script, therefore, in the terminal 02 execute the command (really the script) ./tune-os.sh

[root@localhost hqdb]# ./tune-os.sh 
/etc/sysctl.conf does not define kernel.shmmax, adding it

Tuning completed successfully!

[root@localhost hqdb]# 

Listing 16: Terminal 02 – Executing The tune-os.sh File Script

Now, you must remember the last line shown in the terminal 01, it says Press Enter after you run the script to continue this installation. To do that, see the follow step instruction.

Step 10: Executing The setup.sh File Script (Part II)

Proceed to return to the terminal 01 and press the intro key.

Note: It is going to take some time

Below the long output shown in the terminal 01

Press Enter after you run the script to continue this installation.


Setting up JDBC driver...
Copying database files...
Configuring database...
Loading taskdefs...
Taskdefs loaded
Starting repopulation of configuration table...
Starting built-in database...
Waiting for built-in database to start (on port 9432)...
Preparing database...
Loading taskdefs...
Taskdefs loaded
Loading taskdefs...
Taskdefs loaded
Loading taskdefs...
Taskdefs loaded
Waiting for server to stop...
Stopping built-in database...
Built-in database stopped.
Installing the server JRE ...
Unpacking JRE x86-linux-1.6_30.tar.gz to: /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE...
Setting permissions on /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE...
Setting permissions on server binaries...
Fixing line endings on text files...
--------------------------------------------------------------------------------
Installation Complete:
  Server successfully installed to: /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE
--------------------------------------------------------------------------------


 You can now start your HQ server by running this command:

  /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE/bin/hq-server.sh start

 Note that the first time the HQ server starts up it may take several minutes
 to initialize.  Subsequent startups will be much faster.

 Once the HQ server reports that it has successfully started, you can log in
 to your HQ server at: 

http://localhost.localdomain:7080/

  username: hqadmin
  password: hqadmin

 To change your password, log in to the HQ server, click the "Administration" 
 link, choose "List Users", then click on the "hqadmin" user.


Setup completed.
A copy of the output shown above has been saved to:
  /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/installer/logs/hq-install.log

Deleting temporary JRE
[section1@localhost hyperic-hqee-installer-4.6.6]$ 

Listing 17: Terminal 01 – Executing The setup.sh File Script A First Time (Part VI)

Let’s analyse some important parts of the output shown above.

  • Unpacking JRE x86-linux-1.6_30.tar.gz to: /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE…

Really this new server-4.6.6-EE directory was created before while the setup process in the terminal 01, just now, we are being notified about this.

  • You can now start your HQ server by running this command:
    /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE/bin/hq-server.sh start

Soon we are going to use this hq-server.sh file script.

  • Once the HQ server reports that it has successfully started, you can log in
    to your HQ server at:

    http://localhost.localdomain:7080/
    username: hqadmin
    password: hqadmin

    To change your password, log in to the HQ server, click the “Administration”
    link, choose “List Users”, then click on the “hqadmin” user.

Soon we are going to use do that.

  • Setup completed.
    A copy of the output shown above has been saved to:
    /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/installer/logs/hq-install.log

If we open the file hq-install.log, we are going to see practically all the output shown in the terminal 01 while the all setup process

Step 11: Knowing The server-4.6.6-EE Directory (Optional)

Firstly, let’s see the new server-4.6.6-EE directory created within the hyperic-hqee-installer-4.6.6 directory.

Note: practically the server-4.6.6.tar.gz file installer was unpacked into the server-4.6.6-EE directory.

Figure 22: The server-4.6.6-EE New Directory Created After To Unpack The server-4.6.6.tar.gz File Installer

Always is nice be curious, let’s see what content we have within the server-4.6.6-EE directory.

Figure 23: The server-4.6.6-EE Directory Content

Step 12: Knowing The Installer Directory (Optional)

Something to notice is that if you remember when we worked in the terminal 02 to execute the tune-os.sh file script, we had move within the hyperic-hqee-installer-4.6.6/installer/… directory hierarchy. Furthemore our hq-install.log file is located within such hierarchy too. It is hyperic-hqee-installer-4.6.6/installer/logs.

Therefore, let’s see the installer directory within the hyperic-hqee-installer-4.6.6 directory.

Figure 24: The hyperic-hqee-installer-4.6.6/installer Directory Content

Since I did mention about the tune-os.sh file script, let’s see its location, it is located in the hyperic-hqee-installer-4.6.6/installer/data/hqdb directory.

Figure 25: The hyperic-hqee-installer-4.6.6/installer/data/hqdb Directory Content

Same apreciation about the hq-install.log file, let’s see its location, it is located in the hyperic-hqee-installer-4.6.6/installer/logs directory.

Figure 26: The hyperic-hqee-installer-4.6.6/installer/logs Directory Content

Step 13: Startup The Server

In the Step 10, it has the Listing 17 where we have the follow indication:

You can now start your HQ server by running this command:
/home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE/bin/hq-server.sh start

Therefore to do this, open the terminal 03 from the terminal 01, do realize yourself that within the terminal 03 we are located within hyperic-hqee-installer-4.6.6 directory yet.

We must move to the indicated directory. Therefore execute the command
cd /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE/bin

[section1@localhost hyperic-hqee-installer-4.6.6]$ cd /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE/bin
[section1@localhost bin]$ 

Listing 18: Terminal 03 – Moving Us To The /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/server-4.6.6-EE/bin Path Directory

Now execute the command (really the script) with the parameter indicated ./hq-server.sh start

[section1@localhost bin]$ ./hq-server.sh start
Starting HQ Server...
[section1@localhost bin]$

Listing 19: Terminal 03 – Executing The hq-server.sh File Script With Parameters – (Start Mode)

Step 14: Checking The Server Status (Part I) (Optional)

To understand this step, in the terminal 03 first execute the file script ./hq-server.sh

[section1@localhost bin]$ ./hq-server.sh 
Usage: ./hq-server.sh { start | stop | restart | status | dump }
[section1@localhost bin]$

Listing 20: Terminal 03 – Executing The hq-server.sh File Script

Do realize yourself that we have many parameters available to use for this file script, for this instruction, I am going to use the status parameter. Therefore again in the terminal 03 execute the file script in this way ./hq-server.sh status

[section1@localhost bin]$ ./hq-server.sh status
HQ Server is running (PID:8783).
[section1@localhost bin]$ 

Listing 21: Terminal 03 – Executing The hq-server.sh File Script With Parameters – (Status Mode)

We can know easily that our server is running, even we have available the PID

Step 15: Log In To vFabric Hyperic

Again in the Step 10, it has the Listing 17 where we have the follow indication:

Once the HQ server reports that it has successfully started, you can log in
to your HQ server at:

http://localhost.localdomain:7080/
username: hqadmin
password: hqadmin

To change your password, log in to the HQ server, click the “Administration”
link, choose “List Users”, then click on the “hqadmin” user.

Open your favourite Web Browser and use the URL http://localhost.localdomain:7080/. You should see the follow image:

Figure 27: The Log In vFabric Hyperic Home Page

Write your username and password configured, I am working with hqadmin for both, see the follow image:

Figure 28: The Log In vFabric Hyperic Home Page – (username and password)

Once filled both fields, press the Sign in button, you must arrive to vFabric Hyperic Home Page, below I use two images for a better understanding.

Note: since the main page is big about its width, the two images below are not complete. When you are logged, you must see the complete main page.

Figure 29: The vFabric Hyperic Home Page (Part I)

Figure 30: The vFabric Hyperic Home Page (Part II)

I am not going to explain the structure now, for future tutorials be sure that yes.

Note: Take in consideration the message within the orange area: The Hyperic built-in database is provided for EVALUATION PURPOSES ONLY. For production use, MySQL or Oracle is recommended.

Step 16: Shutdown The Server

If you want to shutdown the server, we must use the same file script but with the opposite value for the parameter, therefore execute the follow command (really the script) ./hq-server.sh stop

[section1@localhost bin]$ ./hq-server.sh stop
Stopping HQ Server...
Waiting for HQ Server to exit...
Stopped HQ Server.
[section1@localhost bin]$ 

Listing 22: Terminal 03 – Executing The hq-server.sh File Script With Parameters – (Stop Mode)

Step 17: Checking The Server Status (Part II) (Optional)

Just being curious, execute again in the terminal 03 the file script in this way ./hq-server.sh status

[section1@localhost bin]$ ./hq-server.sh status
HQ Server is not running.
[section1@localhost bin]$ 

Listing 23: Terminal 03 – Executing The hq-server.sh File Script With Parameters – (Status Mode)

Again, We can know easily that our server is not running.

Step 18: Install The Agent

Now is the turn to install the Agent, we must return to the terminal 01. Then, again execute the setup file script.

[section1@localhost hyperic-hqee-installer-4.6.6]$ ./setup.sh 
Unpacking JRE to temporary directory /tmp/jre
Please ignore references to missing tools.jar
Unable to locate tools.jar. Expected to find it in /tmp/lib/tools.jar
Loading taskdefs...
Taskdefs loaded
Initializing Hyperic HQ 4.6.6 Installation...
accepted=${accept.eula}...
show-eula...

VMWARE END USER LICENSE AGREEMENT

PLEASE NOTE THAT THE TERMS OF THIS END USER LICENSE AGREEMENT SHALL GOVERN 
YOUR USE OF THE SOFTWARE, REGARDLESS OF ANY TERMS THAT MAY APPEAR DURING THE 
INSTALLATION OF THE SOFTWARE.

... ... ...

Additional License Terms

You may install and use the Software on Application Cache Nodes and Data 
Management Nodes which contain up to the maximum aggregate number of 
Processors, for which you have paid the applicable license fees.  

If you have purchased the "Unlimited Client Upgrade" for all of the Data 
Management Nodes within a Data Management Network, then you may connect an 
unlimited number of Application Cache Nodes to any Data Management Node 
within the Data Management Network.

If you have purchased the "Global WAN Upgrade" for all of the Data 
Management Nodes within a Data Management Network, then you may enable the 
Wide Area Network (WAN) communication for any Data Management Node within 
the Data Management Network.   




Do you accept the terms of the agreement? (y, n)

Listing 24: Terminal 01 – Executing The setup.sh File Script A Second Time (Part I)

Again, the three pattern dots (… … …) represent a long output about the licence when you execute the command indicated. Furthermore, the terminal 01 is waiting a user input, then write y where the terminal’s cursor is located, it is not shown in the previous listing, but is located just below of the last line, I mean Do you accept the terms of the agreement? (y, n).

When in the terminal 01 you write or choice y and press the intro key, you must see the follow output

Choose which software to install:
1: Hyperic HQ Server
2: Hyperic HQ Agent
You may enter multiple choices, separated by commas.

Listing 25: Terminal 01 – Executing The setup.sh File Script A Second Time (Part II)

Now we must choice the option 2, it is Hyperic HQ Agent, and press the intro key. Continuing with the setup process, it is going to ask for one thing:

  • HQ agent installation path

For this requested value I am going to use again:

  • /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6

For a better understanding, below my output in my terminal 01. How you can see, I must choice 2 and press the intro key to continue the setup process, then, I can write the value listed above:

You may enter multiple choices, separated by commas.
2
HQ agent installation path [default '/home/hyperic']:
/home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6
Loading install configuration...
Install configuration loaded.
Preparing to install...
Validating agent install configuration...
Installing the agent...
Looking for previous installation
Unpacking /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/hyperic-hqee-agent-4.6.6-x86-linux.tar.gz to: /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/agent-4.6.6-EE...
Setting permissions on /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/agent-4.6.6-EE...
Setting permissions on agent binaries...
Fixing line endings on text files...
--------------------------------------------------------------------------------
Installation Complete:
  Agent successfully installed to: /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6
--------------------------------------------------------------------------------
You can now start your HQ agent by running this command:

       /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/agent-4.6.6-EE/bin/hq-agent.sh start

Setup completed.
A copy of the output shown above has been saved to:
  /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/installer/logs/hq-install.log

Deleting temporary JRE
[section1@localhost hyperic-hqee-installer-4.6.6]$ 

Listing 26: Terminal 01 – Executing The setup.sh File Script A Second Time (Part III)

How can realize yourself, to install the agent is less complex and more quick.

Let’s analyse some important parts of the output shown above.

  • Unpacking /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/hyperic-hqee-agent-4.6.6-x86-linux.tar.gz to: /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/agent-4.6.6-EE…

We have the new agent-4.6.6-EE directory, we are being notified about this.

  • You can now start your HQ agent by running this command:
    /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/agent-4.6.6-EE/bin/hq-agent.sh start

Soon we are going to use this hq-agent.sh file script.

  • Setup completed.
    A copy of the output shown above has been saved to:
    /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/installer/logs/hq-install.log

If we open the file hq-install.log, we are going to see practically all the output shown in the terminal 01 while the all setup process

Step 19: Knowing The agent-4.6.6-EE Directory (Optional)

Firstly, let’s see the new agent-4.6.6-EE directory created within the hyperic-hqee-installer-4.6.6 directory.

Note: practically the hyperic-hqee-agent-4.6.6-x86-linux.tar.gz file installer was unpacked into the agent-4.6.6-EE directory.

Figure 31: The agent-4.6.6-EE New Directory Created After To Unpack The hyperic-hqee-agent-4.6.6-x86-linux.tar.gz File Installer

Check carefully the image shown above, can you see something new?. Yes, we have other extra new directory. It is named hq-plugins. It will covered in other tutorials.

Always is nice be curious, let’s see what content we have within the server-4.6.6-EE directory.

Figure 32: The agent-4.6.6-EE Directory Content

To be fair, let’s see what content we have within the hq-plugins directory.

Figure 33: The hq-plugins Directory Content

Yes, it is empty, we have none plugin to use.

Step 20: Startup The Agent

In the Step 18, it has the Listing 26 where we have the follow indication:

  • You can now start your HQ agent by running this command:
    /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/agent-4.6.6-EE/bin/hq-agent.sh start

Therefore to do this, open the terminal 04 from the terminal 01, do realize yourself that within the terminal 04 we are located within hyperic-hqee-installer-4.6.6 directory yet.

We must move to the indicated directory. Therefore execute the command cd /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/agent-4.6.6-EE/bin

[section1@localhost hyperic-hqee-installer-4.6.6]$ cd /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/agent-4.6.6-EE/bin
[section1@localhost bin]$

Listing 27: Terminal 04 – Moving US To The /home/section1/whiteroom/vmware/vfabrichyperic/4.6.6/serverandagent/hyperic-hqee-installer-4.6.6/agent-4.6.6-EE/bin Path Directory

Now execute the command (really the script) with the parameter indicated ./hq-agent.sh start. I am going to use the default values except for one part where is mandatory write a specific data, it is for the HQ server IP address. For a better understanding see the follow:

[section1@localhost bin]$ ./hq-agent.sh start
Starting HQ Agent...... running (8413).
[ Running agent setup ]
Should Agent communications to HQ be unidirectional [default=no]: 
What is the HQ server IP address: 127.0.0.1
Should Agent communications to HQ always be secure [default=yes]: 
What is the HQ server SSL port [default=7443]: 
- Testing secure connection ... Failure
What is the HQ server IP address: 

Listing 28: Terminal 04 – Executing The hq-agent.sh File Script With Parameters – (Start Mode) – Try 01

Mmmm, a Testing secure connection … Failure???. Why?. That’s correct, in the Step 16 I did shutdown the server, therefore in the terminal 03 proceed to startup the server again. Read the Step 13 to know where and how start it. Once done this, lets try again where we are.

Again, I am going to use the default values.

Note: remember that in Step 08 for the fields username and password, I assigned for both the value hqadmin. So, be careful with that, you must use your own values.

Note: about the password data. You can’t see the characters when they are written in the terminal.

For a better understanding see the follow:

What is the HQ server IP address: 127.0.0.1
Should Agent communications to HQ always be secure [default=yes]: 
What is the HQ server SSL port [default=7443]: 
- Testing secure connection ... Success
What is your HQ login [default=hqadmin]: 
What is your HQ password: 
What IP should HQ use to contact the agent [default=192.168.1.34]: 
What port should HQ use to contact the agent [default=2144]: 
- Received temporary auth token from agent
- Registering agent with HQ
The server to agent communication channel is using a self-signed certificate and could not be verified
Are you sure you want to continue connecting? [default=no]: 
- Unable to register agent: Failed to connect to agent: Error sending argument: Unable to connect to 192.168.1.34:2144: java.security.cert.CertificateException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target, retried 5 times, cmd=agent:ping
[section1@localhost bin]$ 

Listing 29: Terminal 04 – Executing The hq-agent.sh File Script With Parameters – (Start Mode) – Try 02

Even when we have the follow error message: Unable to register agent: Failed to connect to agent: Error sending argument: Unable to connect to 192.168.1.34:2144: java.security.cert.CertificateException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target, retried 5 times, cmd=agent:ping the agent has been started.

If you execute again the command (really the script) ./hq-agent.sh start, you must see the follow

[section1@localhost bin]$ ./hq-agent.sh start
Starting HQ Agent...HQ Agent is already running.
[section1@localhost bin]$ 

Listing 30: Terminal 04 – Executing The hq-agent.sh File Script With Parameters – (Start Mode) – Verification

Step 21: Checking The Agent Status (Part I) (Optional)

To understand this step, in the terminal 04 execute the file script ./hq-agent.sh

[section1@localhost bin]$ ./hq-agent.sh
./hq-agent.sh: line 29: [: =: unary operator expected
Usage: ./bundles/agent-4.6.6/bin/hq-agent.sh { start | stop | restart | status | dump | ping | setup | set-property }
[section1@localhost bin]$ 

Listing 31: Terminal 04 – Executing The hq-agent.sh File Script

Again, do realize yourself that we have many parameters available to use for this file script, for this instruction, I am going to use the status parameter. Therefore again in the terminal 04 execute the file script in this way ./hq-agent.sh status

[section1@localhost bin]$ ./hq-agent.sh status
HQ Agent is running (PID:8413).
Current agent bundle: agent-4.6.6
Agent not yet setup
[section1@localhost bin]$ 

Listing 32: Terminal 04 – Executing The hq-agent.sh File Script With Parameters – (Status Mode)

We can know easily that our agent is running, even we have available the PID, but check carefully the last line, the agent is not yet setup. It is because we have an error message, check the Listing 29. The key line is Are you sure you want to continue connecting? [default=no]:

To fix this situation, see the next step instruction

Step 22: Setup The Agent

To fix the error message shown in the Listing 29, I am going to use again the hq-agent.sh file script but for setup purposes.

Note: the agent is still running

Therefore in the terminal 04 execute again the file script with the parameter indicated ./hq-agent.sh setup.

But, how we fix this problem executing the hq-agent.sh file script?. Is simple, when we arrive to the question Are you sure you want to continue connecting? [default=no]: we must not work with the default value, we must write yes and press the intro key. For a better understanding check the follow.

[section1@localhost bin]$ ./hq-agent.sh setup
[ Running agent setup ]
Should Agent communications to HQ be unidirectional [default=no]: 
What is the HQ server IP address: 127.0.0.1
Should Agent communications to HQ always be secure [default=yes]: 
What is the HQ server SSL port [default=7443]: 
- Testing secure connection ... Success
What is your HQ login [default=hqadmin]: 
What is your HQ password: 
What IP should HQ use to contact the agent [default=192.168.1.34]: 
What port should HQ use to contact the agent [default=2144]: 
- Received temporary auth token from agent
- Registering agent with HQ
The server to agent communication channel is using a self-signed certificate and could not be verified
Are you sure you want to continue connecting? [default=no]: yes
- HQ gave us the following agent token
    1341165179567-269639513342177287-5375742235727205304
- Informing agent of new HQ server
- Validating
- Successfully setup agent
[section1@localhost bin]$ 

Listing 33: Terminal 04 – Executing The hq-agent.sh File Script With Parameters – (Setup Mode)

The error has gone and now we have a token. And the best part, in the last line we have the message Successfully setup agent

Step 23: Checking The Agent Status (Part II) (Optional)

To see that all goes well now, in the terminal 04, execute again /hq-agent.sh status

[section1@localhost bin]$ ./hq-agent.sh status
HQ Agent is running (PID:8413).
Current agent bundle: agent-4.6.6
Server IP address: 127.0.0.1
Server (SSL) port: 7443
Agent listen port: 2144
[section1@localhost bin]$ 

Listing 34: Terminal 04 – Executing The hq-agent.sh File Script With Parameters – (Status Mode)

Now, all is fine

Step 24: Shutdown The Agent

In the terminal 04 we must use again the hq-agent.sh file script, but with the stop parameter, therefore, execute the follow ./hq-agent.sh stop

[section1@localhost bin]$ ./hq-agent.sh stop
Stopping HQ Agent...
Waiting for HQ Agent to exit...
Waiting for HQ Agent to exit...
Waiting for HQ Agent to exit...
Waiting for HQ Agent to exit...
Waiting for HQ Agent to exit...
Stopped HQ Agent.
[section1@localhost bin]$ 
[section1@localhost bin]$ 

Listing 35: Terminal 04 – Executing The hq-agent.sh File Script With Parameters – (Shutdown Mode)

Note: It would take some time

Step 25: Checking The Agent Status (Part III) (Optional)

Just being curious, in the terminal 04, execute again /hq-agent.sh status

[section1@localhost bin]$ ./hq-agent.sh status
HQ Agent is not running.
[section1@localhost bin]$ 

Listing 36: Terminal 04 – Executing The hq-agent.sh File Script With Parameters – (Status Mode)

The message is clear by itself

Final Notes:

Congratulations!!!. You have learned how adquire, install, startup and shutdown vFabric Hyperic 4.6.6 for Server and Agent presentations.

Home

About these ads

Tags: , ,

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s


Follow

Get every new post delivered to your Inbox.

Join 40 other followers

%d bloggers like this: