The aim of this document is show how to install the entire abiCloud platform in a computer, including community and premium parts.

Installation

Pre-requisites

• Eclipse: Download and install eclipse J2EE edition.
• Eclipse plugins: You can also install some eclipse plugins like subclipse, maven ...
  • Install JDK 1.6:
  • To check the version

• • To install

• From Synaptic install nfs-common (fixes [FATAL] ApplianceManager configuration error, caused by: Can not write on the ''RepositoryPath'' at [/opt/vm_repository].)

• Install Maven
  • Download from http://maven.apache.org/download.html
  • Extract in $HOME/Programas/maven

• Set environment variables
  • In .bashrc set variables:

• To avoid Error PermGen:OutOfMemoryError, put this variable in /etc/environment (http://ubuntuforums.org/showthread.php?t=2793)

• Download Tomcat6 and extract to /opt/tomcat.
  • Start up them by executing /opt/tomcat/bin/startup.sh
• Download mysql (client and server) 5.1

Downloading & Building the code

Let's create two repositories. First one is for abicluod community version. The second one is for premium version, which is linked to community version. It is recommended to create both directories under the same path.

1. Open Eclipse
2. Go to SVN perspective and create a new repository location.
3. Insert this URL *https://abicloud.svn.sourceforge.net/svnroot/abicloud*  and press finish.
4. Expand the tree of directories created and go to trunk.
5. Right Click and then checkout
6. Select the second radiobutton in Choose how to check out folder trunk and insert the folder name abicloud-community-trunk.
7. Go to step 2 and repeat the same but inserting the URL https://thinkingrid.svn.cvsdude.com/abiCloudPremium* and choosing the name *abicloud-premium-trunk to the repository folder.

Now execute $HOME/workspace/abicloud-community-trunk/nomaven-libs/upload-libs.sh to download libraries not included in maven.

Do the same in $HOME/workspace/abicloud-premium-trunk/nomaven-libs/

Replace all 'localhost' occurrences in /abicloud-community-trunk/server/src/main/filters/dev-nix.properties for your external IP.

Check that your database has a user with root/root user/password

In /abicloud-premium-trunk/server/src/main/filters/dev-nix.properties

• Change the paths of tomcat and mysql in pom.xml of /abicloud-premium-trunk for the actual paths of the applications.

        ...
        <community.path>../abicloud-community-trunk</community.path>
        ...

        <profile>
                <id>nix</id>
                <activation>
                        <os>
                                <family>unix</family>
                        </os>
                </activation>
                <properties>
                        <tomcat.home>/opt/tomcat</tomcat.home>
                        <mysql.bin>/usr/bin</mysql.bin>
                        <env.family>nix</env.family>
                </properties>
        </profile>

Set the appliance repository setting the property in /abicloud-community-trunk/am/src/main/filters/dev-nix.properties

Modify the file pom.xml into abicloud-community-trunk and comment the lines that contain <module>database</module> and <module>deployer</module>

Time to build!

It's time to check if all our steps are correct. Let's build. Go to /abicluod-community-trunk/ and type

Then go to /abicloud-premium-trunk/ and execute

Skip test because at this moment test fails.

Finish starting the tomcat:

You can test your installation opening a browser and typing

Troubleshooting

[TBD]

Installation steps

1. First, download the different components that comprise abiCloud from abiCloud Subversion repository ( only basic modules svn url's are shown in this document ):

• abicloud_client

• abicloud_server

• abicloud_WS

• Database information

• Appliance Manager
• OVFManager
• Virtual System Monitor
• Repository Importer
• Libvirt Virtual System Agent
• Virtual Box Agent
• Installer

2. Database

• Import the previously downloaded database script ( database module in svn ) into your installed MySQL server

• Create an user "kinton" with password "s0ng0ku" with all privileges in the database created with name "kinton".

3. Projects configuration

• For the client:

• Msfonts intallation in Linux

     Ubuntu:

sudo apt-get install msttcorefonts

     Fedora:

wget http://www.my-guides.net/en/images/stories/fedora10/msttcore-fonts-2.0-2.noarch.rpm
su -c 'rpm -ivh msttcore-fonts-2.0-2.noarch.rpm

   Locale installation:

     (You need to add a new folder on C:\Program Files\Adobe\Flex Builder 3 Plug-in\sdks\3.1.0\frameworks\locale  folder with the name ca_ES)

    On client-config.xml (on dev folder) you can define where the abicloud_server will be (default on localhost:8080).

• abicloud_server installation

    Define the database connection on <span style="font-style: italic;"><span style="font-weight: bold;">abi.config</span></span>.xml file

     Define the abicloud_WS destination

• abiCloud WS installation

Running the application

• Run Tomcat

• On [AbiCloud] project: Deploy the war using the "Deploy" ant task.

• On [AbiServer] project: Deploy the war using the "Deploy" ant task.

• On AbiCloud_AM project. Deploy the war using the "Deploy" ant task

• On VirtualSystemMonitor_ws project. Deploy the war using the "Deploy" ant task

• Compile the RIMP, vagent or vbagent and follow the installationinstructions

• If you go to http://localhost:8080/manager you can see the two web applications running
• On eclipse, go to client folder, right button and  "run as" --> Flex application
• The application is ready to be tested 

Note: You can run the java applications from eclipse too