BMI server functions require a DHCP server. If the network that you want to manage does not have a DHCP server, you can configure the BMI server to use an embedded DHCP server.
The BMI software must be installed on one system, which must be dedicated to Sun Update Connection – Enterprise system dependency server (SDS) and the BMI server. It is referred to as the local host throughout these instructions.
Perform the following procedures to install the BMI server:
If the local environment calls for different options not explained in this section, contact Technical Support.
The Sun Update Connection – Enterprise components (system dependency server, agent, and console) must be installed before you install the BMI server.
To get information about system requirements and detailed installation instructions, see Sun Update Connection - Enterprise 1.0 Quick Start Guide: Getting Started.
Install the Sun Update Connection – Enterprise SDS using ezInstaller and the -channels option:
# ./ezInstaller -channels
If an SDS is already installed, the SDS is reinstalled with additional channels.
In the ezInstaller list of supported distributions, activate all the channels that you want to be able to provision with the BMI.
Install the agent and the console.
Do not change the name of the BMI system in the console. The BMI server name must be the system's host name.
The following distributions require that you install additional software on the BMI server system:
The software is not included in the BMI or Sun Update Connection – Enterprisepackages.
If your BMI server is using Red Hat, verify that the following software is installed on your BMI server:
Python
Python-xml
TFTP server
If you are going to provision Solaris systems, you also need nfs-utils, configured to export /tftpboot/pxelinux.cfg as read only (ro)
Work Station 3.0 does not have tftp-server; use the RPM from the Advanced Server distribution.
If your BMI server is using SUSE, verify that the following software is installed on your BMI server:
Python
TFTP server
Python-xml
If you are going to provision Solaris systems, you also need nfs-utils, configured to export /tftpboot/pxelinux.cfg (ro)
The BMI tool application and files are in the UCE-BMI-*.tgz file, which is located in the /plugins directory in Sun Update Connection – Enterprise. Expand the file to access the files.
Copy the UCE-BMI-*.tgz file to a directory where you want to work.
This path is referred to as your installation directory throughout this section.
Expand the contents of the tar file.
# tar xPfzv UCE-BMI-*.tgz |
The UCE-BMI-plugin-version-release directory is created.
This directory contains a ReadMe file and a subdirectory, RPMS, which contains the following packages:
Dependent package – sun-uce-api-version-release.platform.rpm
Dependent package – sun-uce-api-python-version-release.platform.rpm
BMI Server package – sun-uce-bmi-version-release.platform.rpm
Download the syslinux-3.11.tar.gz file from http://www.kernel.org/pub/linux/utils/boot/syslinux/.
Newer versions of syslinux might work, but are not tested.
Extract the syslinux-3.11.tar.gz file.
# gunzip syslinux-3.11.tar.gz.tar.gz
# tar -xvf syslinux-3.11.tar
Copy the pxelinux.0 file to the /tftpboot directory.
Change to the RPMS directory.
Install the API.
# rpm -iv sun-uce-api-version-release.platform.rpm |
Install the Python API.
# rpm -iv sun-uce-api-python-version-release.platform.rpm |
Install the BMI server.
# rpm -iv sun-uce-bmi-version-release.platform.rpm |
Restart the Sun Update Connection – Enterprise server.
# /etc/init.d/uce_server restart |
The following procedures explain how to configure the environment for operations of the software required by the BMI server.
Open the /etc/xinetd.d/tftp file for editing and replace disable = yes with disable = no.
Restart xinetd.
# /etc/init.d/xinetd restart |
Copy the agent tarball and change the name.
# cp /usr/local/uce/install/agent-date.tar.gz /tftpboot/shared/agent.tar.gz |
When you copy the file, change the name. For example, change it from agent-date.tar.gz to agent.tar.gz.
A restart script is provided during installation of the sun-uce-bmi RPM. Upload the restart script to the knowledge base for the BMI server to use, as needed.
If you have one or more client systems on a SPARC platform, you must upload the restart script. If your client systems are all Intel architectures, you can skip this procedure.
In the Components list of the Inventory Panel, select Local\Post-Actions and create a new category called reboot_host. Apply it to all distributions.
Select the reboot_host category and click Add to open the Add Post Action window.
In the Post Action Name field, type reboot_host_script.
In the File Name field, type the real path name, which is /usr/local/uce/server/bmis/reboot.sh.
Make sure all relevant distributions are selected, then click Apply.
You must create a bmi_admin user account and a policy file in the console before you can use the BMI server. You can also create profiles for your BMI server in the console.
For more information about user accounts, policy files, and profiles, see the Sun Update Connection – Enterprise 1.0 User’s Guide.
In this procedure you create a bmi_admin user accounts with full permissions over all jobs, hosts, groups, and components.
Any Sun Update Connection – Enterprise admin user can access the BMI server, but only the bmi_admin user can configure the BMI server.
Start the console.
$ uce_console |
The Login window appears.
Log in as the admin user.
The console initializes and the main window appears.
Open the Users window.
Open the User Editor window:
Complete the User Editor fields for the new user.
In the User Name field, type bmi_admin
Type a password for the user and then verify it.
Type a description of the account.
Check the Grant Full Permissions checkbox.
(Optional) If you want to receive Sun Update Connection – Enterprise notification emails, complete the Notifications section. Provide an email address and check the relevant Notify When options.
Click OK.
The User Editor window closes. The new user name, with full permissions, is added to the Users window.
If you create a profile after you log into the BMI server, the profile is displayed the next time that you log in.
Start the console.
$ uce_console |
The Login window appears.
Log in as the admin user.
The console initializes and the main window appears.
Open the Policies window.
Open the Policy Editor window.
Create a new policy that predefines the actions.
If you have more than one client distribution, click Multi Distro.
In the window that opens, expand all categories and select all the options. This ensures that the policy is relevant for any distribution you choose to provision.
Click OK.
The Policy Editor window closes. The policy is created and appears in the Policies window.
(Optional) Create the profiles that you will use in the BMI server to provision systems.
If you have more than one client distribution, click Multi Distro for each profile and in the window that opens, expand all categories and select all the options. This ensures that each profile can be deployed on any remote computer that is being provisioned with any of your selected distributions. For more detailed information about creating profiles, see Chapter 9, Profiles, in Sun Update Connection – Enterprise 1.0 User’s Guide.