networkserverSUITE

AIX & AIX VIOS Agent Installation

CopyrightCopyright 2009-2019 Halcyon - A division of HelpSystems. All rights reserved.

• Windows is a registered trademark of Microsoft Corporation in the United States and othercountries.

• UNIX is a registered trademark of The Open Group in the United States and other counties.

• Linux is a registered trademark of Linus Torvalds in the United States and other countries.

• AIX is a registered trademark of International Business Machines in the United States andother countries.

• RED HAT is a registered trademark of Red Hat, Inc. in the United States and other countries.

• SUSE is a registered trademark of Novell, Inc. in the United States and other countries

• IBM is a registered trademark of International Business Machines in the United States andother countries

This document is intended as a guide to using Network Server Suite from Halcyon Software. Thisdocumentation contains Halcyon proprietary and confidential information and may not bedisclosed, used, or copied without the prior consent of Halcyon Software, or as set forth in theapplicable license agreement. Users are solely responsible for the proper use of the softwareand the application of the results obtained.

Although Halcyon Software has tested the software and reviewed the documentation, the solewarranty for the software may be found in the applicable license agreement between HalcyonSoftware and the user.

Publication Revision: June 2019

C H A P T E R

CHAPTER 1AIX AGENT INSTALLATION

Pre-requisiteHalcyon UNIX Server Manager (HALUSM) can only be installed onto an AIX

partition running library bos.rte.libpthreads at level 7.2 or higher.

To check this, run the command:

lslpp -h bos.rte.libpthreads

An entry is displayed as:

There may be multiple versions shown. Only one version needs to be level 7.2or higher for the install to be successful.

If your AIX partition is not running at this level, you must upgrade beforeHALUSM can be installed on this partition.

Monitoring a Virtual I/O Server (VIOS)The Virtual I/O Server is part of the PowerVM Editions hardware feature and issoftware that is located in a logical partition. This software facilitates the sharingof physical I/O resources between client logical partitions within the server.

The Virtual I/O Server provides virtual SCSI target, virtual fibre channel, SharedEthernet Adapter, and PowerVM™ Active Memory Sharing capability to clientlogical partitions within the system.

A I X A g e n t I n s t a l l a t i o n 1-1

Client logical partitions can share SCSI devices, fibre channel adapters,Ethernet adapters, and expand the amount of memory available to logicalpartitions using paging space devices.

The Virtual I/O Server software requires that the logical partition be dedicatedsolely for its use.

Halcyon’s AIX VIOS monitoring has been certified by IBM as being ‘Ready forPower Systems Software’. The AIX VIOS solution can natively monitor theVirtual I/O Server by installing the AIX Server Manager directly onto the logicalpartition on which the Virtual I/O Server is installed.

Note: Use the following instructions to install AIX® Server Manager.

Downloading the software and using FTP to transfer to AIX® Server1 Download the file ‘NSS Managed Server (AIX) from:

http://www.halcyonsoftware.com/downloads

2 Once the download has completed, rename the downloaded file tohalusm.rpm

Creating a Directory on the AIX® Server

1 Copy the downloaded file; ‘halusm.rpm’ to the root ‘C:\’ drive of your localmachine.

2 Use Windows Start | Run | Cmd to display a popup dialog. Type thecommand ‘TELNET’ followed by the IP Address of the AIX® Server and pressEnter. Alternatively, we recommend using PuTTY (freeware) to perform thesame action.

3 Log on to the AIX® Server using the root user details.

4 Run the command; df -m to check available disk space across yourfilesystems.

5 Use the mount with the most available space to create a directory calledhalcyon. For example; [/]#mkdir /home/halcyon

1- 2 N e t w o r k S e r v e r S u i t e

FTP the file to the AIX® Server

1 On your local machine, use Windows Start | Run | Cmd to display a popupdialog. Type the command ‘FTP’ followed by the IP Address of the AIX®

Server and press Enter.

2 Log on to the AIX® Server using the root user details.

3 Now use the following commands:

ftp>bin

ftp>lcd c:\

ftp>put halusm.rpm /home/halcyon/halusm.rpm

4 Once FTP has been successful, use the following command to exit:

ftp>quit

Natively installing the AIX and AIX(VIOS) agent

1 Log on to the AIX® Server using the root user details.

Note: For VIOS installations you must run the following command to swap to the AIX command line instead of using the restricted VIOS shell.

oem_setup_env

2 Use the command; ‘[:/]# smit’ to access the AIX System ManagementConsole.

3 From the menu displayed, select Software Installation and Maintenance.

A I X A g e n t I n s t a l l a t i o n 1-3

4 From the next menu, select Install and Update Software.

5 From the subsequent menu, select Install Software.

6 Type the name of the directory location that you previously created, forexample; ‘/home/halcyon’ and press Enter.

1- 4 N e t w o r k S e r v e r S u i t e

7 On the next display, press F4 to prompt for a list of software available forinstallation.

8 The display now shows the software available for installation in the specifieddirectory. Position the cursor so that the halusm entry is highlighted andpress Enter.

9 When returned to the initial installation screen, use the arrow keys to movebetween options and the tab key to change the field setting for each option tothe following:

Option Setting

PREVIEW only? no

COMMIT software updates? yes

SAVE replaced files? no

A I X A g e n t I n s t a l l a t i o n 1-5

AUTOMATICALLY installed requisite software? yes

EXTEND file systems if space needed? yes

OVERWRITE same or newer versions? no

VERIFY install and check file sizes? no

Include corresponding LANGUAGE filesets? yes

DETAILED output? no

Process multiple volumes? yes

ACCEPT new license agreements? yes

Preview new LICENSE agreements? no

10Press Enter to begin the installation. Press Enter again at the confirmationscreen to continue.

11When the following screen is displayed, installation is complete. Press F10 toreturn from SMIT to the command line.

1- 6 N e t w o r k S e r v e r S u i t e

What happens during the installation processDuring the installation process the following events occur:

• The user profile ‘halcyon’ is created which has authority to the Halcyonmonitor and commands.

• The following commands are added to /etc/rc.d/rc2.d in order that the halusm process is automatically started when the AIX® system is started or ended if the AIX® run-level is changed.

• Shalusm (start)

• Khalusm (kill)

• The ‘/etc/group’ and ’/etc/passwd’ files for the halcyon user are modified.

• Active logs are stored in ‘/tmp/ServerManager.hlf’ and ‘/usr/log/usr’.

Additional folders that are created as part of the installation:

• /etc/rc.d/rc2.d/Shalusm

• /etc/rc.d/rc2.d/Khalusm

• /usr/bin/halusm.sh

• /usr/libexec/halcyon

• /var/lib/halcyon

Porting RequirementsEnsure that the port 15000 is available on the AIX® Server as this is used for allcommunications between this device and the Enterprise Server.

To check if port 15000 is active, enter the command:

netstat -na | grep 15000

This displays any IP address with port 15000 to any IP address and port on thenetwork in LISTEN status. This is only displayed if the HALUSM subsystem isactive.

Checking and controlling the halusm processUse the command; lssrc -s halusm to check the status of the halusmprocess.

If the process is inoperative use the command:

startsrc -s halusm

A I X A g e n t I n s t a l l a t i o n 1-7

To stop the process use the command:

stopsrc -s halusm

Configuring the AIX® Server for use within Network Server Suite

Adding the AIX Server to the Device Manager

1 At the Windows Start menu, select Start | Programs | Halcyon NetworkServer Suite | Device Manager.

2 From the menu bar select Devices | Add Device.

3 At this stage, leave the Group setting as (default). Enter the Name andDescription of the server.

4 Select AIX Server as the Device Type.

5 Enter the IP Address of the server.

6 Click OK. The Server is now displayed in the Defined Devices pane of theHalcyon Device Manager dialog.

7 Close the Device Manager.

1- 8 N e t w o r k S e r v e r S u i t e

Adding a new Enterprise Server entryThis step is only required if the AIX® Server is not configured to use local DNSand ensures your existing enterprise server uses the IP Address asidentification, rather than the host name so that the Enterprise Server and AIX®

Server can communicate.

1 At the Windows Start menu, select Start | Programs | Halcyon NetworkServer Suite | Device Manager.

2 From the menu bar select Devices | Add Device.

3 Leave the Group setting as (default). Enter the Name and Description of theenterprise server.

4 Select Windows Server as the Device Type.

5 Enter the IP Address (not the Host Address) of the server.

6 Click OK. The Server is now displayed in the Defined Devices pane of theHalcyon Device Manager dialog.

7 Close the Device Manager.

Adding the AIX Server to Central Console ManagerThe AIX® Server agent must be installed and active prior to these steps beingactioned.

1 At the Windows Start menu, select Start | Programs | Halcyon NetworkServer Suite | CCM Console.

2 From the Central Configuration Manager menu bar select Tools | ReloadDevices to update the changes made within Device Manager.

3 From the left-hand pane, select the top (default) group so that it is highlighted and then click Add System from the tool bar. The Select System dialog is displayed.

4 Select the AIX® Server so that it is highlighted and click Select. Confirmation that the system has been added is shown in the Add System dialog.

A I X A g e n t I n s t a l l a t i o n 1-9

5 Click OK to add the AIX® Server system to the Central Configuration Manager.

6 Select File | Save Settings to send the setting to the AIX Server agent.

7 Close the Central Configuration Manager.

The installation of the AIX® Server agent is now complete.

Checking the version of the AIX® Server ManagerTo check which version of AIX® Server Manager you are running, please use the command:

rpm -qi halusm

1- 1 0 N e t w o r k S e r v e r S u i t e

Upgrading the AIX® Server ManagerAt present, there is no dedicated routine to upgrade a version of the AIX®

Server Manager.

Where an upgrade of the AIX® Server Manager needs to be undertaken, useSMITTY to remove the existing halusm-n.n-n software.

A fresh installation of the latest version can now be started, using theinstructions provided in this document.

A I X A g e n t I n s t a l l a t i o n 1-11