2008-06-17 20:27:32 +04:00
/* -------------------------------------------------------------------------- */
2018-01-02 20:27:37 +03:00
/* Copyright 2002-2018, OpenNebula Project, OpenNebula Systems */
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"
2017-01-30 01:46:59 +03:00
# include "ObjectXML.h"
2008-06-17 20:27:32 +04:00
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 :
2013-04-03 18:18:50 +04:00
enum VMAction
2017-01-27 22:55:38 +03:00
{ //Associated XML-RPC API call
NONE_ACTION = 0 , // "one.vm.migrate"
MIGRATE_ACTION = 1 , // "one.vm.migrate"
2013-04-19 00:17:55 +04:00
LIVE_MIGRATE_ACTION = 2 ,
2016-05-02 19:34:42 +03:00
//SHUTDOWN_ACTION = 3,
//SHUTDOWN_HARD_ACTION = 4,
2017-01-27 22:55:38 +03:00
UNDEPLOY_ACTION = 5 , // "one.vm.action"
UNDEPLOY_HARD_ACTION = 6 , // "one.vm.action"
HOLD_ACTION = 7 , // "one.vm.action"
RELEASE_ACTION = 8 , // "one.vm.action"
STOP_ACTION = 9 , // "one.vm.action"
SUSPEND_ACTION = 10 , // "one.vm.action"
RESUME_ACTION = 11 , // "one.vm.action"
2016-05-02 19:34:42 +03:00
//BOOT_ACTION = 12,
2017-01-27 22:55:38 +03:00
DELETE_ACTION = 13 , // "one.vm.recover"
DELETE_RECREATE_ACTION = 14 , // "one.vm.recover"
REBOOT_ACTION = 15 , // "one.vm.action"
REBOOT_HARD_ACTION = 16 , // "one.vm.action"
RESCHED_ACTION = 17 , // "one.vm.action"
UNRESCHED_ACTION = 18 , // "one.vm.action"
POWEROFF_ACTION = 19 , // "one.vm.action"
POWEROFF_HARD_ACTION = 20 , // "one.vm.action"
DISK_ATTACH_ACTION = 21 , // "one.vm.attach"
DISK_DETACH_ACTION = 22 , // "one.vm.detach"
NIC_ATTACH_ACTION = 23 , // "one.vm.attachnic"
NIC_DETACH_ACTION = 24 , // "one.vm.detachnic"
DISK_SNAPSHOT_CREATE_ACTION = 25 , // "one.vm.disksnapshotcreate"
DISK_SNAPSHOT_DELETE_ACTION = 26 , // "one.vm.disksnapshotdelete"
TERMINATE_ACTION = 27 , // "one.vm.action"
TERMINATE_HARD_ACTION = 28 , // "one.vm.action"
DISK_RESIZE_ACTION = 29 , // "one.vm.diskresize"
DEPLOY_ACTION = 30 , // "one.vm.deploy"
CHOWN_ACTION = 31 , // "one.vm.chown"
CHMOD_ACTION = 32 , // "one.vm.chmod"
UPDATECONF_ACTION = 33 , // "one.vm.updateconf"
RENAME_ACTION = 34 , // "one.vm.rename"
RESIZE_ACTION = 35 , // "one.vm.resize"
UPDATE_ACTION = 36 , // "one.vm.update"
SNAPSHOT_CREATE_ACTION = 37 , // "one.vm.snapshotcreate"
SNAPSHOT_DELETE_ACTION = 38 , // "one.vm.snapshotdelete"
SNAPSHOT_REVERT_ACTION = 39 , // "one.vm.snapshotrevert"
DISK_SAVEAS_ACTION = 40 , // "one.vm.disksaveas"
DISK_SNAPSHOT_REVERT_ACTION = 41 , // "one.vm.disksnapshotrevert"
2017-01-30 01:46:59 +03:00
RECOVER_ACTION = 42 , // "one.vm.recover"
2017-02-10 16:19:55 +03:00
RETRY_ACTION = 43 , // "one.vm.recover"
2018-10-11 18:01:36 +03:00
MONITOR_ACTION = 44 , // internal, monitoring process
2018-12-04 14:00:13 +03:00
DISK_SNAPSHOT_RENAME_ACTION = 45 , // "one.vm.disksnapshotrename"
2018-12-04 16:41:55 +03:00
ALIAS_ATTACH_ACTION = 46 , // "one.vm.attachnic"
ALIAS_DETACH_ACTION = 47 , // "one.vm.detachnic"
POFF_MIGRATE_ACTION = 48 , // "one.vm.migrate"
2018-12-04 14:00:13 +03:00
POFF_HARD_MIGRATE_ACTION = 49 // "one.vm.migrate"
2013-04-03 18:18:50 +04:00
} ;
2017-01-27 22:55:38 +03:00
static string action_to_str ( VMAction action ) ;
2013-04-03 18:18:50 +04:00
2017-01-27 22:55:38 +03:00
static int action_from_str ( const string & st , VMAction & action ) ;
2013-04-03 18:18:50 +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 ,
2013-10-25 19:09:00 +04:00
int cid ,
2011-03-08 19:55:14 +03:00
const string & vmm ,
2012-06-28 17:32:52 +04:00
const string & tmm ,
2012-06-29 18:48:43 +04:00
int ds_id ,
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
2018-10-09 12:05:08 +03:00
/**
* Function to print the History object into a string in
* XML format with reduce information
* @ param xml the resulting XML string
* @ return a reference to the generated string
*/
string & to_xml_short ( string & xml ) const ;
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 ;
2012-10-05 15:23:44 +04:00
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 ;
2017-02-09 18:58:47 +03:00
int uid ;
int gid ;
int req_id ;
2008-06-17 20:27:32 +04:00
int hid ;
2013-10-25 19:09:00 +04:00
string hostname ;
int cid ;
2008-06-17 20:27:32 +04:00
string vmm_mad_name ;
2012-06-28 17:32:52 +04:00
string tm_mad_name ;
2008-06-17 20:27:32 +04:00
2012-06-29 18:48:43 +04:00
int ds_id ;
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 ;
2013-04-03 18:18:50 +04:00
VMAction action ;
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 ;
2013-07-05 03:31:30 +04:00
string token_file ;
2009-03-06 15:10:15 +03:00
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 ;
2016-04-10 23:39:21 +03:00
string system_dir ;
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_*/