2008-06-17 20:27:32 +04:00
/* -------------------------------------------------------------------------- */
2012-01-12 15:29:18 +04:00
/* Copyright 2002-2012, OpenNebula Project Leads (OpenNebula.org) */
2008-06-17 20:27:32 +04:00
/* */
/* Licensed under the Apache License, Version 2.0 (the "License"); you may */
/* not use this file except in compliance with the License. You may obtain */
/* a copy of the License at */
/* */
/* http://www.apache.org/licenses/LICENSE-2.0 */
/* */
/* Unless required by applicable law or agreed to in writing, software */
/* distributed under the License is distributed on an "AS IS" BASIS, */
/* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. */
/* See the License for the specific language governing permissions and */
/* limitations under the License. */
/* -------------------------------------------------------------------------- */
# ifndef HISTORY_H_
# define HISTORY_H_
# include "ObjectSQL.h"
using namespace std ;
/**
* The History class , it represents an execution record of a Virtual Machine .
*/
2011-03-01 19:47:20 +03:00
class History : public ObjectSQL , public ObjectXML
2008-06-17 20:27:32 +04:00
{
public :
enum MigrationReason
{
2010-04-11 00:16:47 +04:00
NONE , /** < Normal termination in host */
ERROR , /** < The VM was migrated because of an error */
2008-06-23 02:38:55 +04:00
STOP_RESUME , /** < The VM was migrated because of a stop/resume request*/
2010-04-11 00:16:47 +04:00
USER , /** < The VM was migrated because of an explicit request */
CANCEL /** < The VM was migrated because of an explicit cancel */
2008-06-17 20:27:32 +04:00
} ;
2008-06-22 05:51:49 +04:00
History ( int oid , int _seq = - 1 ) ;
History (
2011-03-08 19:55:14 +03:00
int oid ,
int seq ,
int hid ,
const string & hostname ,
const string & vmm ,
2012-05-08 17:42:24 +04:00
const string & vnm ,
2012-06-28 17:32:52 +04:00
const string & tmm ,
2012-05-08 17:42:24 +04:00
const string & vm_info ) ;
2008-06-22 05:51:49 +04:00
~ History ( ) { } ;
2009-07-09 18:34:34 +04:00
/**
* Function to write the History Record in an output stream
*/
friend ostream & operator < < ( ostream & os , const History & history ) ;
/**
* Function to print the History object into a string in
* XML format
* @ param xml the resulting XML string
* @ return a reference to the generated string
*/
string & to_xml ( string & xml ) const ;
2010-04-11 00:16:47 +04:00
2008-06-17 20:27:32 +04:00
private :
friend class VirtualMachine ;
2010-04-11 00:16:47 +04:00
friend class VirtualMachinePool ;
2009-03-06 15:10:15 +03:00
2008-06-17 20:27:32 +04:00
// ----------------------------------------
// DataBase implementation variables
// ----------------------------------------
2012-05-05 05:18:25 +04:00
static const char * table ;
2008-06-17 20:27:32 +04:00
static const char * db_names ;
2009-03-06 15:10:15 +03:00
2008-06-17 20:27:32 +04:00
static const char * db_bootstrap ;
void non_persistent_data ( ) ;
2009-03-06 15:10:15 +03:00
2008-06-17 20:27:32 +04:00
// ----------------------------------------
// History fields
// ----------------------------------------
int oid ;
int seq ;
string hostname ;
int hid ;
string vmm_mad_name ;
2011-11-10 20:28:32 +04:00
string vnm_mad_name ;
2012-06-28 17:32:52 +04:00
string tm_mad_name ;
2008-06-17 20:27:32 +04:00
time_t stime ;
time_t etime ;
time_t prolog_stime ;
time_t prolog_etime ;
time_t running_stime ;
time_t running_etime ;
time_t epilog_stime ;
time_t epilog_etime ;
MigrationReason reason ;
2012-05-04 19:29:36 +04:00
string vm_info ;
2012-02-26 02:31:44 +04:00
// -------------------------------------------------------------------------
// Non-persistent history fields
// -------------------------------------------------------------------------
// Local paths
2008-11-13 19:21:17 +03:00
string transfer_file ;
string deployment_file ;
2009-03-06 15:10:15 +03:00
string context_file ;
2012-02-26 02:31:44 +04:00
// Remote paths
2008-06-17 20:27:32 +04:00
string checkpoint_file ;
2008-11-13 19:21:17 +03:00
string rdeployment_file ;
2009-03-06 15:10:15 +03:00
2008-06-17 20:27:32 +04:00
/**
* Writes the history record in the DB
* @ param db pointer to the database .
* @ return 0 on success .
*/
2011-03-08 19:55:14 +03:00
int insert ( SqlDB * db , string & error_str )
{
error_str . clear ( ) ;
return insert_replace ( db , false ) ;
}
2008-06-17 20:27:32 +04:00
/**
* Reads the history record from the DB
* @ param db pointer to the database .
* @ return 0 on success .
*/
2010-04-11 00:16:47 +04:00
int select ( SqlDB * db ) ;
2010-08-05 21:28:28 +04:00
2008-06-17 20:27:32 +04:00
/**
2010-05-03 21:13:37 +04:00
* Updates the history record
2008-06-17 20:27:32 +04:00
* @ param db pointer to the database .
* @ return 0 on success .
*/
2011-03-08 19:55:14 +03:00
int update ( SqlDB * db )
{
return insert_replace ( db , true ) ;
}
2009-03-06 15:10:15 +03:00
2008-06-17 20:27:32 +04:00
/**
2010-05-03 21:13:37 +04:00
* Removes the all history records from the DB
2008-06-17 20:27:32 +04:00
* @ param db pointer to the database .
* @ return 0 on success .
2009-03-06 15:10:15 +03:00
*/
2010-05-03 21:13:37 +04:00
int drop ( SqlDB * db ) ;
2010-08-05 21:28:28 +04:00
2010-05-03 21:13:37 +04:00
/**
2010-08-05 21:28:28 +04:00
* Execute an INSERT or REPLACE Sql query .
2010-05-03 21:13:37 +04:00
* @ param db The SQL DB
2010-08-05 21:28:28 +04:00
* @ param replace Execute an INSERT or a REPLACE
2010-05-03 21:13:37 +04:00
* @ return 0 on success
*/
int insert_replace ( SqlDB * db , bool replace ) ;
2008-06-17 20:27:32 +04:00
/**
2010-04-11 00:16:47 +04:00
* Callback function to unmarshall a history object ( History : : select )
2008-06-17 20:27:32 +04:00
* @ param num the number of columns read from the DB
* @ para names the column names
* @ para vaues the column values
* @ return 0 on success
*/
2010-04-11 00:16:47 +04:00
int select_cb ( void * nil , int num , char * * values , char * * names ) ;
2009-07-09 18:34:34 +04:00
2012-05-04 19:29:36 +04:00
/**
* Function to print the History object into a string in
* XML format , to be stored in the DB . It includes the VM template info
* @ param xml the resulting XML string
* @ return a reference to the generated string
*/
string & to_db_xml ( string & xml ) const ;
/**
* Function to print the History object into a string in
* XML format . The VM info can be optionally included
* @ param xml the resulting XML string
* @ param database If it is true , the TEMPLATE element will be included
* @ return a reference to the generated string
*/
string & to_xml ( string & xml , bool database ) const ;
2009-07-09 18:34:34 +04:00
/**
2011-03-01 19:47:20 +03:00
* Rebuilds the object from an xml node
* @ param node The xml node pointer
*
* @ return 0 on success , - 1 otherwise
*/
2011-03-08 19:55:14 +03:00
int from_xml_node ( const xmlNodePtr node )
{
ObjectXML : : update_from_node ( node ) ;
return rebuild_attributes ( ) ;
}
2011-03-01 19:47:20 +03:00
/**
* Rebuilds the object from an xml formatted string
* @ param xml_str The xml - formatted string
*
* @ return 0 on success , - 1 otherwise
*/
2011-03-08 19:55:14 +03:00
int from_xml ( const string & xml_str )
{
ObjectXML : : update_from_str ( xml_str ) ;
return rebuild_attributes ( ) ;
}
2011-03-01 19:47:20 +03:00
/**
* Rebuilds the internal attributes using xpath
2009-07-09 18:34:34 +04:00
*/
2011-03-01 19:47:20 +03:00
int rebuild_attributes ( ) ;
2008-06-17 20:27:32 +04:00
} ;
2010-09-02 22:44:14 +04:00
# endif /*HISTORY_H_*/