Abiquo Enterprise Remote Services 1.6 - RPM Network Install

Network Install (Recommended)

Follow these steps to to install the Abiquo Enterprise Remote Services. Use this installation method ONLY if you can access the Internet from your server.

This document will guide you through the required steps to install Abiquo Enterprise Remote Services and all it's dependencies.

This remote services includes:

  • abiquo-am
  • abiquo-nodecollector
  • abiquo-ssm
  • abiquo-v2v
  • abiquo-virtualfactory
  • abiquo-vsm
  • samba
  • nfs
  • dhcpd

Minimum and Recommended System Requirements

In addition to the hardware and software requirements specified in [Abiquo:Requirements], You will need to install additional software from third-party:

  • Sun JDK >= 1.6
  • Oracle VirtualBox >= 3.1

Important services installed in the Abiquo Enterprise Remote Services host

The following packages will be installed when you install the abiquo-remote-services RPM:

  • MySQL 5 (Centos5 package)
  • DHCP server 3.0 (Centos5 package)
  • NFS Server (Centos5 package)
  • CIFS Server 3.0 (Centos5 package, samba only for hyper-v users)
  • Apache Tomcat 6.0 (included in the abiquo-core RPM)

A Few things to note before installing Abiquo Enterprise Remote Services

Abiquo Enterprise Remote Services runs on top of the Enterprise Class CentOS 5.5 Linux distribution. We'll try to make things easy for non-linux users/sysadmins, but prior knowledge of GNU/Linux or other Unix-like systems and the software previously mentioned is highly recommended.

Abiquo Enterprise Remote Services installs MySQL. Default database user is root, no password. Changing the database user and password is not supported at the moment.

1. Perform a CentOS/RHEL 5.5 x86_64 Core Install

  • Download CentOS 5.5 x86_64 DVD from a CentOS mirror:

http://isoredirect.centos.org/centos/5.5/isos/x86_64/

  • Minimal install (Deselect all the package groups), no graphical environment needed.
  • Erase all the partitions, choose the default partition layout.

Refer to the official RedHat/CentOS documentation if you need assistance with the installation process:

http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/Installation_Guide-en-US/index.html

IMPORTANT!!!
  • Only x86_64 architecture is supported. i386 will NOT work.
  • SELinux and Firewall must be disabled. See Disabling SELinux.
  • IPv6 can be disabled during the install process
  • We recommend you to configure the Abiquo Enterprise Remote Services with static IP and create a forward/reverse DNS record for the host.

Aditional Requirements (pre-requisites)

Install Java JDK 6 and Oracle VirtualBox.

TIP
If you downloaded prerequisite installation file(s) to your Windows Management Workstation, use WinSCP to copy the file to /tmp or any other directory where you have write permissions on your Abiquo Enterprise Remote Services server, then proceed with the installation per the instructions below.

Java SE Development Kit 6u20 RPM for Linux x64

Download it from jdk-6u21-linux-x64-rpm.bin and go to the folder where you downloaded it. Execute:

chmod a+x jdk-6u21-linux-x64-rpm.bin
./jdk-6u21-linux-x64-rpm.bin

Refer to the installation instructions if you need further assistance:

http://java.sun.com/javase/6/webnotes/install/jdk/install-linux-64-RPM.html

Oracle VirtualBox 3.1.6 RPM for RHEL5 x64

Get it from http://download.virtualbox.org/virtualbox/3.1.6/VirtualBox-3.1-3.1.6_59338_rhel5-1.x86_64.rpm and install the RPM. Issue the following command to install the package:

yum localinstall --nogpgcheck VirtualBox-3.1-3.1.6_59338_rhel5-1.x86_64.rpm

Add the Abiquo yum repository config

Install the Abiquo YUM repository package:

Create a new file named /etc/yum.repos.d/abiquo.repo and copy these lines:

#
# Abiquo YUM Repository
#
[abiquo]
name = Abiquo Repository
baseurl = http://packages.abiquo.com/
gpgcheck = 0

[abiquo-ee]
name = Abiquo Enterprise Repository
baseurl = http://username:password@abiquo_url_repository
gpgcheck = 0
EE users
For enterprise users, ask for user, password and abiquo_url_repository to your sales contact

Install the Abiquo Enterprise Remote Services packages

Run the following command to install the Abiquo Enterprise Remote Services:

yum install abiquo-remote-services nfs-utils mysql-server dhcp samba


Hyper-v users
Samba option only for users that it will use hyper-v nodes

After that we will install the v2v capabilities

yum install abiquo-v2v

Now, create a new file and add this content. For example, /tmp/v2v.sql:

CREATE TABLE `bpm_event_status` (
`process_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
`enterprise_id` int(11) DEFAULT NULL,
`user_id` int(11) DEFAULT NULL,
`event_type` int(11) NOT NULL,
`process_name` varchar(255) NOT NULL,
`creation_date` timestamp NULL DEFAULT NULL,
`last_update` timestamp NULL DEFAULT NULL,
PRIMARY KEY (`process_id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

CREATE TABLE `bpm_event_status_history` (
`event_status_history_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
`process_id` bigint(20) unsigned NOT NULL,
`enterprise_id` int(11) DEFAULT NULL,
`user_id` int(11) DEFAULT NULL,
`event_type` int(11) NOT NULL,
`process_name` varchar(255) NOT NULL,
`tstamp` timestamp NULL DEFAULT NULL,
PRIMARY KEY (`event_status_history_id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

Now, you need to load the database. Run these commands:

/etc/init.d/mysqld start
mysql -u root -e "create database kinton;"
mysql -u root kinton < /tmp/v2v.sql
rm /tmp/v2v.sql

Configure the services

Dhcpd Server

Move the current dhcpd.conf config file to a backup file:

mv /etc/dhcpd.conf /etc/dhcpd.conf.bak

Create a new (empty) dhcpd.conf config file in /etc/dhcpd.conf and paste the following lines:

#
# Abiquo Server DHCP configuration
# Please copy and paste the following lines into your DHCP server
#
ddns-update-style interim;

omapi-port 7911;

subnet 0.0.0.0 netmask 0.0.0.0 {
    default-lease-time 60000;
    max-lease-time 720000;
    option subnet-mask 255.255.255.0;
    option domain-name-servers 8.8.8.8;
  }

Samba (CIFS Server)

Move the current /etc/samba/smb.conf config file to a backup file:

mv /etc/samba/smb.conf /etc/samba/smb.conf.bak

Create a new (empty) smb.conf config file in /etc/samba/smb.conf and paste the following lines:

[global]
workgroup = WORKGROUP
server string = %h server
dns proxy = no
log file = /var/log/samba/log.%m
max log size = 1000
syslog = 0
panic action = /usr/share/samba/panic-action %d
security = share
guest account = root
encrypt passwords = true
passdb backend = tdbsam
obey pam restrictions = yes
unix password sync = yes
passwd program = /usr/bin/passwd %u
passwd chat = *Enter\snew\s*\spassword:* %n\n *Retype\snew\s*\spassword:* %n\n *password\supdated\ssuccessfully* .
pam password change = yes

[vm_repository]
path = /opt/vm_repository
guest ok = yes
read only = false
locking = yes

NFS Server

Edit /etc/exports and add the following line:

/opt/vm_repository *(rw,no_root_squash,subtree_check,insecure)

Configuration

Go to /opt/abiquo/config and modify the xml files with your configuration. Here there are an configuration example, assuming that the remote services server ip is 192.168.0.2:

am.xml

<?xml version="1.0" encoding="UTF-8"?>

<!-- Appliance Manager configuration -->
<am>
        <!-- Required Datacenter Repository configuration. -->
        <repository>
                <!-- Where the ''repositoryLocation'' file system is mounted. Local file system path. -->
                <path>/opt/vm_repository/</path> <!-- ${repository.path} -->

                <!-- Where the ''repositoryPath'' is exported. NFS shared location.  -->
                <location>192.168.0.2:/opt/vm_repository</location> <!-- ${repository.location} -->
        </repository>

        <!-- Optional elements to tune the deploy process.  -->
        <deploy>
                <!--Bytes to be downloaded before flush to repository.  -->
                <buffer>32768</buffer>

                <!-- Milliseconds to wait before timeout a connection -->
                <timeout>60000</timeout> <!-- 1min -->
        </deploy>

        <!-- Optional elements to tune the upload process. -->
        <upload>
                <!-- Milliseconds to wait before refresh upload progress -->
                <progressInterval>5000</progressInterval>
        </upload>
</am>

bpm-async.xml:

<?xml version="1.0" encoding="UTF-8"?>

<!-- BPM Image Converter Service Configuration -->
<image-converter>

        <service>
                <!-- The location of the local repository - i.e on the same machine  -->
                <localRepositoryPath>/opt/vm_repository</localRepositoryPath>
        </service>

</image-converter>

nodecollector.xml:

<?xml version="1.0" encoding="UTF-8"?>

<!-- Node Collector Configuration -->
<nodecollector>
        <hypervisors>
                <hyperv>
                        <user>Administrator</user>
                        <password>yourpassword0!</password>
                        <port>5985</port>
                </hyperv>
                <vbox>
                        <port>18083</port>
                </vbox>
                <esxi>
                        <user>root</user>
                        <password>yourpassword</password>
                        <datastore>datastore1</datastore>
                </esxi>
                <xenserver>
                       <user>root</user>
                       <password>yourpassword</password>
                </xenserver>
        </hypervisors>
        <wsman>
                <port>8889</port>
                <user>wsman</user>
                <password>yourpassword</password>
        </wsman>
</nodecollector>

virtualfactory.xml:

<?xml version="1.0" encoding="UTF-8"?>

<!-- Virtual factory Configuration -->
<virtualfactory>

        <hypervisors>
                <vmware>
                        <!-- <datacenter>default</datacenter> -->
                        <SanDatastore name="nfsrepository"></SanDatastore>
                        <!-- <VmfsDatastore name="datastore1"></VmfsDatastore> -->
                        <user>root</user>
                        <password>yourpassword</password>
                        <ignorecert>true</ignorecert>
                </vmware>
                <hyperv>
                        <user>Administrator</user>
                        <password>yourpassword0!</password>
                        <localRepositoryPath>C:/localRepository/
                        </localRepositoryPath>
                        <destinationRepositoryPath>//192.168.0.2/vm_repository/</destinationRepositoryPath>
                        <wsmanPort>5985</wsmanPort>
                </hyperv>
                <xenserver>
                        <user>root</user>
                        <password>yourpassword</password>
                        <abiquoRepository>192.168.0.2:/opt/vm_repository</abiquoRepository>
                </xenserver>
        </hypervisors>

        <rimp>
                <port>8889</port>
                <timeout>600000000</timeout>    <!-- Milliseconds -->
                <user>wsman</user>
                <password>yourpassword</password>
        </rimp>

        <storagelink>
                <address>https://localhost:21605</address>
                <user>admin</user>
                <password>storagelink</password>
        </storagelink>

</virtualfactory>

vsm.xml:

<?xml version="1.0" encoding="UTF-8"?>

<!-- Virtual System Monitor Configuration -->
<vsm>
        <hypervisors>
                <libvirtAgent>
                        <port>8889</port>
                        <user>wsman</user>
                        <password>yourpassword</password>
                </libvirtAgent>
                <vmware>
                        <!-- <datacenter>ha-datacenter</datacenter> -->
                        <user>root</user>
                        <password>yourpassword</password>
                        <ignorecert>true</ignorecert>
                </vmware>
                <hyperv>
                        <user>Administrator</user>
                        <password>yourpassword0!</password>
                        <pollInterval>5000</pollInterval>
                </hyperv>
                <xenserver>
                        <user>root</user>
                        <password>yourpassword</password>
                </xenserver>
        </hypervisors>
</vsm>

Go to /opt/abiquo/tomcat/webapps/bpm-async/WEB-INF/classes and modify the activemq.xml file.

Replace

                <transportConnectors>
                        <transportConnector uri="tcp://localhost:61616" />
                </transportConnectors>

by

                <transportConnectors>
                        <transportConnector uri="tcp://0.0.0.0:61616" />
                </transportConnectors>

Finish the installation

Now reboot the machine issuing the following command:

reboot

After the restart, the Abiquo Enterprise Remote Service should be ready to use in your Abiquo Enterprise Server.

Ensure mysql service is running.

The service script used to control the server is /etc/init.d/abiquo-tomcat

Related Documentation

[Abiquo Architecture]

[Abiquo:Requirements]

[Abiquo Hyper-v Node Installation]

[Abiquo:Abiquo KVM Node Installation]

[Abiquo:Abiquo Xen Node Installation]

[Abiquo:Install and Configure a Virtual Storage with OpenSolaris]

[Abiquo:Other Resources]

Labels

favourite favourite Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.