Abiquo Enterprise Server 1.6 - RPM Offline Install - Monolitic Architecture

Offline Install (Recommended)

Follow these steps to to install the Abiquo Enterprise Server. Use this installation if you can't access the Internet from your server.

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

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 Server host

The following packages are automatically installed when you install the abiquo-16-pocsetup RPM:

  • MySQL 5 (Centos5 package)
  • DHCP server 3.0 (Centos5 package)
  • NFS Server (Centos5 package)
  • CIFS Server 3.0 (Centos5 package)
  • Apache Tomcat 6.0 (included in the abiquo-core RPM)

A Few things to note before installing Abiquo Enterprise Server

Abiquo Server 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 Server 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 Server 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 server, then proceed with the installation per the instructions below.

Java SE Development Kit 6u20 RPM for Linux x64

Get it from http://java.sun.com/javase/downloads/widget/jdk6.jsp and install the RPM. Make sure you have Java available in /usr/java/default after installing the RPM package.

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

Install the Abiquo Server packages

  • Insert the CentOS DVD in the CD tray.
  • Create the /media/cdrom directory if it does not exist:
mkdir /media/cdrom
  • Mount the CentOS DVD:
mount /dev/cdrom /media/cdrom
  • Upload or copy the Abiquo Server tarball provided to the server and unpack it. Assuming you have it in /root directory:
tar xzvf abiquo-server-1.6.0.x86_64.tar.gz

This will create a directory. Change to that directory:

cd abiquo-server-1.6
  • Install the RPMs:
yum localinstall --disablerepo=\* --enablerepo=c5-media --nogpgcheck *.rpm

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 < /usr/share/doc/abiquo-server/database/kinton-schema.sql
mysql -u root kinton < /usr/share/doc/abiquo-server/database/kinton-premium-schema.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

Goes to /opt/abiquo/config and modify the xml files with your configuration. Here there are an configuration example, assuming that the 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>

server.xml:

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

<!-- Server Configuration -->
<server>

        <!-- Platform properties -->
        <abicloud>
                <version>1.6</version>
                <distribution>1.6</distribution>
        </abicloud>

        <!--
                The fully qualified name of the Configuration class being used DO NOT
                CHANGE!!!
        -->
        <configClass>com.abiquo.abiserver.config.AbiPremiumConfig</configClass>

        <!-- Timeout in milliseconds-->
        <timeout>600000000</timeout>

        <!--
                Database properties 
        -->
        <dbDataSource>java:comp/env/jdbc/abiquoDB</dbDataSource>

        <!--  Session timeout in minutes -->
        <sessionTimeout>5</sessionTimeout>


        <!-- Maximum number of session. A value of 0 means no limit -->
        <maxNumSessions>1</maxNumSessions>

        <!-- How many virtual CPU are supported for each physical core. -->
        <virtualCpuForCore>4</virtualCpuForCore>

        <!--
                Define the soft and hard limits for resource allocation on the
                scheduler.
        -->
        <resourceAllocationLimit>
                <cpu hard="0" soft="0" />
                <ram hard="0" soft="0" />
                <hd hard="0" soft="0" />
        </resourceAllocationLimit>

        <!-- event sink Address -->
        <eventSinkAddress>http://192.168.1.2:8080/server/EventSink</eventSinkAddress>


        <!--  sanity period (in minutes!)-->
        <sanityTime>1</sanityTime>

        <!--  health period (in minutes!)-->
        <healthTime>30</healthTime>

        <networking>
                <vlanPerSwitch>1024</vlanPerSwitch>
                <vlanPerVDC>8</vlanPerVDC>
                <NRSQ>10</NRSQ>
                <publicVLANtag>2</publicVLANtag>
        </networking>

        <mail>
                <!-- The mail server address.  -->
                <server>localhost</server>

                <!-- Mail user for send mails. -->
                <user>none@none.es</user>

                <!-- Password of the mail user for send mails. -->
                <password>none</password>
        </mail>

        <!-- Location of the API -->
        <apiLocation>http://localhost:8080/api/</apiLocation>

        <repositorySpace>http://abiquo-repository.abiquo.com/s3direct/ovfindex.xml</repositorySpace>       
</server>

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>

Finish the installation

Now reboot the machine issuing the following command:

reboot

After the restart, the Abiquo Server should be ready and accessible typing the following URL in your browser:

http://your-abiquo-server-ip:8080/client-premium

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

Sanity Check and Reporting Tools

If you run into problems, run the sanity check tool included. Log into the abiquo server (if you aren't already) and type the following command:

python /opt/abiquo-server/tools/sanity-check-scripts/abiquoServerCheckState.py

checking JNDI: OK
checking Database: OK
checking NFS: OK
checking Samba: OK
checking Bpm dependencies: OK
checking MTA: OK
cheching DHCP: OK
checking SELinux: OK
checking Event sync address: OK

Everything should be OK.

Troubleshooting

See the [Abiquo:Abiquo Server FAQ]

Abiquo support team will ask you to send them a system report to help you to troubleshoot the issue. See [Abiquo:SOS Report]

Related Documentation

[Abiquo Architecture]

[Abiquo:Requirements]

[Abiquo: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.

Comments (5)

 

  1. Nov 04, 2011

    Anonymous says:

    AKAIK you've got the awsner in one!

    AKAIK you've got the awsner in one!

  2. Nov 05, 2011

    Anonymous says:

    bt6bBl <a href="http://cjdojxxagdaq.com/">cjdojxxagdaq</a>

    bt6bBl <a href="http://cjdojxxagdaq.com/">cjdojxxagdaq</a>

  3. Nov 06, 2011

    Anonymous says:

    YLIb5l , [url=http://shaopmdommml.com/]shaopmdommml[/url], [...

    YLIb5l , [url=http://shaopmdommml.com/]shaopmdommml[/url], [link=http://eejylexsmhbz.com/]eejylexsmhbz[/link], http://dozqxrzkbbjz.com/

  4. Nov 07, 2011

    Anonymous says:

    Ckj34m <a href="http://rrfauhtjholt.com/">rrfauhtjholt</a>

    Ckj34m <a href="http://rrfauhtjholt.com/">rrfauhtjholt</a>

  5. Nov 09, 2011

    Anonymous says:

    1oYVpy , [url=http://ptrmkbtdbksh.com/]ptrmkbtdbksh[/url], [...

    1oYVpy , [url=http://ptrmkbtdbksh.com/]ptrmkbtdbksh[/url], [link=http://onpvlvwfprkn.com/]onpvlvwfprkn[/link], http://ijouateabmjm.com/