Simulation.h
1 
11 #ifndef WRENCH_SIMULATION_H
12 #define WRENCH_SIMULATION_H
13 
14 #include <string>
15 #include <vector>
16 #include <nlohmann/json.hpp>
17 #include "Version.h"
18 #include <wrench/simulation/SimulationOutput.h>
19 
20 
21 namespace wrench {
22 
23  class StorageService;
24  class Service;
25  class NetworkProximityService;
26  class FileRegistryService;
27  class EnergyMeterService;
28  class BandwidthMeterService;
29  class ComputeService;
30  class BatchComputeService;
31  class BareMetalComputeService;
32  class CloudComputeService;
33  class VirtualizedClusterComputeService;
34  class WMS;
35  class WorkflowFile;
36  class SimulationOutput;
37  class S4U_Simulation;
38  class FileLocation;
39  class MemoryManager;
40 
46  class Simulation {
47 
48  public:
49  Simulation();
50 
51  ~Simulation();
52 
53  void init(int *, char **);
54 
55  void instantiatePlatform(std::string);
56 
57  static std::vector<std::string> getHostnameList();
58  static std::map<std::string, std::vector<std::string>> getHostnameListByCluster();
59  static double getHostMemoryCapacity(std::string hostname);
60  static unsigned long getHostNumCores(std::string hostname);
61  static double getHostFlopRate(std::string hostname);
62 
63 
64  void launch();
65 
72  template <class T>
73  std::shared_ptr<T> add(T *t) {
74  auto s = std::shared_ptr<T>(t);
75  this->addService(s);
76  return s;
77  }
78 
80 
81  //start energy related calls
82  double getEnergyConsumed(const std::string &hostname);
83  std::map<std::string, double> getEnergyConsumed(const std::vector<std::string> &hostnames);
84 // double getEnergyTimestamp(const std::string &hostname, bool can_record = false);
85 
86  // pstate related calls
87  static int getNumberofPstates(const std::string &hostname);
88  static double getMinPowerConsumption(const std::string &hostname);
89  static double getMaxPowerConsumption(const std::string &hostname);
90  static std::vector<int> getListOfPstates(const std::string &hostname);
91 
92  void stageFile(WorkflowFile *file, std::shared_ptr<StorageService> ss);
93  void stageFile(WorkflowFile *file, std::shared_ptr<StorageService> ss, std::string directory_absolute_path);
94 
95  /***********************/
97  /***********************/
98  double getEnergyConsumed(const std::string &hostname, bool record_as_time_stamp);
99 
100  static std::vector<std::string> getRoute(std::string &src_host, std::string &dst_host);
101 
102  double getLinkUsage(const std::string &link_name, bool record_as_time_stamp);
103  std::map<std::string, double> getEnergyConsumed(const std::vector<std::string> &hostnames, bool record_as_time_stamps);
104 
105  static bool doesHostExist(std::string hostname);
106  static bool isHostOn(std::string hostname);
107  static void turnOnHost(std::string hostname);
108  static void turnOffHost(std::string hostname);
109  static bool doesLinkExist(std::string linkname);
110  static bool isLinkOn(std::string linkname);
111  static void turnOnLink(std::string linkname);
112  static void turnOffLink(std::string linkname);
113 
114  // pstate related calls
115  void setPstate(const std::string &hostname, int pstate);
116  static int getCurrentPstate(const std::string &hostname);
117 
118  std::shared_ptr<ComputeService> startNewService(ComputeService *service);
119  std::shared_ptr<StorageService> startNewService(StorageService *service);
120  std::shared_ptr<NetworkProximityService> startNewService(NetworkProximityService *service);
121  std::shared_ptr<FileRegistryService> startNewService(FileRegistryService *service);
122  std::shared_ptr<MemoryManager> startNewService(MemoryManager *service);
123 
124  static double getCurrentSimulatedDate();
125 
126  static void sleep(double duration);
127  static void compute(double flops);
128  /***********************/
130  /***********************/
131 
132  /***********************/
134  /***********************/
135  void readFromDisk(double num_bytes, std::string hostname, std::string mount_point);
136  void readFromDiskAndWriteToDiskConcurrently(double num_bytes_to_read, double num_bytes_to_write,
137  std::string hostname,
138  std::string read_mount_point,
139  std::string write_mount_point);
140  void writeToDisk(double num_bytes, std::string hostname, std::string mount_point);
141 
142  void readWithMemoryCache(WorkflowFile *file, double n_bytes, std::shared_ptr<FileLocation> location);
143  void writebackWithMemoryCache(WorkflowFile *file, double n_bytes, std::shared_ptr<FileLocation> location, bool is_dirty);
144  void writeThroughWithMemoryCache(WorkflowFile *file, double n_bytes, std::shared_ptr<FileLocation> location);
145  MemoryManager* getMemoryManagerByHost(std::string hostname);
146 
147  static double getMemoryCapacity();
148  static unsigned long getNumCores();
149  static double getFlopRate();
150  static std::string getHostName();
151 
152  static std::vector<std::string> getLinknameList();
153  static double getLinkUsage(std::string linkname);
154  static double getLinkBandwidth(std::string linkname);
155  static bool isPageCachingEnabled();
156  static bool isHostShutdownSimulationEnabled();
157  static bool isEnergySimulationEnabled();
158 
159 
160  /***********************/
162  /***********************/
163 
164  private:
165  SimulationOutput output;
166 
167  std::unique_ptr<S4U_Simulation> s4u_simulation;
168 
169  std::set<std::shared_ptr<WMS>> wmses;
170 
171  std::set<std::shared_ptr<FileRegistryService>> file_registry_services;
172 
173  std::set<std::shared_ptr<EnergyMeterService>> energy_meter_services;
174 
175  std::set<std::shared_ptr<BandwidthMeterService>> bandwidth_meter_services;
176 
177  std::set<std::shared_ptr<NetworkProximityService>> network_proximity_services;
178 
179  std::set<std::shared_ptr<ComputeService>> compute_services;
180 
181  std::set<std::shared_ptr<StorageService>> storage_services;
182 
183  std::set<std::shared_ptr<MemoryManager>> memory_managers;
184 
185  static int unique_disk_sequence_number;
186 
187  void stageFile(WorkflowFile *file, std::shared_ptr<FileLocation> location);
188 
189  void platformSanityCheck();
190  void checkSimulationSetup();
191  bool isRunning();
192 
193  void startAllProcesses();
194  void addService(std::shared_ptr<ComputeService> service);
195  void addService(std::shared_ptr<StorageService> service);
196  void addService(std::shared_ptr<NetworkProximityService> service);
197  void addService(std::shared_ptr<WMS> service);
198  void addService(std::shared_ptr<FileRegistryService> service);
199  void addService(std::shared_ptr<EnergyMeterService> service);
200  void addService(std::shared_ptr<BandwidthMeterService> service);
201  void addService(std::shared_ptr<MemoryManager> memory_manager);
202 
203  std::string getWRENCHVersionString() { return WRENCH_VERSION_STRING; }
204 
205  bool is_running = false;
206 
207  unsigned int on_state_change_callback_id;
208 
209  static bool energy_enabled;
210  static bool host_shutdown_enabled;
211  static bool pagecache_enabled;
212  };
213 
214 };
215 
216 #endif //WRENCH_SIMULATION_H
void readWithMemoryCache(WorkflowFile *file, double n_bytes, std::shared_ptr< FileLocation > location)
Read file locally, only available if writeback is activated.
Definition: Simulation.cpp:826
static std::map< std::string, std::vector< std::string > > getHostnameListByCluster()
‍**
Definition: Simulation.cpp:377
static double getMemoryCapacity()
Get the memory_manager_service capacity of the host on which the calling process is running.
Definition: Simulation.cpp:1060
std::shared_ptr< T > add(T *t)
Method to add a service to the simulation.
Definition: Simulation.h:73
static std::vector< std::string > getLinknameList()
Get the list of names of all the links in the platform.
Definition: Simulation.cpp:286
static double getMinPowerConsumption(const std::string &hostname)
Get the minimum power consumption for the host (i.e., idling) at its current pstate.
Definition: Simulation.cpp:1218
std::shared_ptr< ComputeService > startNewService(ComputeService *service)
Starts a new compute service during WMS execution (i.e., one that was not passed to Simulation::add()...
Definition: Simulation.cpp:1240
static std::string getHostName()
Get the name of the host on which the calling process is running.
Definition: Simulation.cpp:1084
static double getLinkBandwidth(std::string linkname)
Get the max bandwidth of a particular link.
Definition: Simulation.cpp:296
void instantiatePlatform(std::string)
Instantiate a simulated platform.
Definition: Simulation.cpp:241
static bool isPageCachingEnabled()
Method to check if page caching is activated.
Definition: Simulation.cpp:337
void readFromDisk(double num_bytes, std::string hostname, std::string mount_point)
Wrapper enabling timestamps for disk reads.
Definition: Simulation.cpp:744
static int getCurrentPstate(const std::string &hostname)
Get the current power state of a host.
Definition: Simulation.cpp:1200
static bool isHostOn(std::string hostname)
Returns whether a host is on or not.
Definition: Simulation.cpp:1011
A file registry service (a.k.a. replica catalog) that holds a database of which files are available a...
Definition: FileRegistryService.h:35
MemoryManager * getMemoryManagerByHost(std::string hostname)
Find MemoryManager running on a host based on hostname.
Definition: Simulation.cpp:942
static void sleep(double duration)
Make the calling process sleep for a number of (simulated) seconds.
Definition: Simulation.cpp:1092
A class that implemnets a MemoryManager service to simulate Linux in-memory page caching for I/O oper...
Definition: MemoryManager.h:29
static bool isLinkOn(std::string linkname)
Returns whether a link is on or not.
Definition: Simulation.cpp:1036
void writebackWithMemoryCache(WorkflowFile *file, double n_bytes, std::shared_ptr< FileLocation > location, bool is_dirty)
Write a file locally with writeback strategy, only available if writeback is activated.
Definition: Simulation.cpp:869
static bool isEnergySimulationEnabled()
Method to check if energy simulation is activated.
Definition: Simulation.cpp:353
The storage service base class.
Definition: StorageService.h:36
The compute service base class.
Definition: ComputeService.h:33
void setPstate(const std::string &hostname, int pstate)
Set the power state of the host.
Definition: Simulation.cpp:1181
Definition: Alarm.cpp:20
static std::vector< int > getListOfPstates(const std::string &hostname)
Get the list of power states available for a host.
Definition: Simulation.cpp:1209
static unsigned long getNumCores()
Get the number of cores of the host on which the calling process is running.
Definition: Simulation.cpp:1068
static void compute(double flops)
Make the calling process compute.
Definition: Simulation.cpp:1100
void launch()
Launch the simulation.
Definition: Simulation.cpp:386
static std::vector< std::string > getRoute(std::string &src_host, std::string &dst_host)
Get the list of link names on the route between two hosts.
Definition: Simulation.cpp:277
static void turnOnLink(std::string linkname)
Turns on a link.
Definition: Simulation.cpp:1052
void init(int *, char **)
Initialize the simulation, which parses out WRENCH-specific and SimGrid-specific command-line argumen...
Definition: Simulation.cpp:98
static void turnOffHost(std::string hostname)
Turns off a host.
Definition: Simulation.cpp:1019
static double getHostMemoryCapacity(std::string hostname)
Get the memory_manager_service capacity of a host given a hostname.
Definition: Simulation.cpp:984
static std::vector< std::string > getHostnameList()
Get the list of names of all the physical hosts in the platform.
Definition: Simulation.cpp:267
static unsigned long getHostNumCores(std::string hostname)
Get the number of cores of a host given a hostname.
Definition: Simulation.cpp:993
double getEnergyConsumed(const std::string &hostname)
Obtains the current energy consumption of a host.
Definition: Simulation.cpp:1118
static bool doesHostExist(std::string hostname)
Wrapper for S4U_Simulation hostExists()
Definition: Simulation.cpp:957
Simulation()
Constructor.
Definition: Simulation.cpp:64
A class that provides basic simulation methods. Once the simulation object has been explicitly or imp...
Definition: Simulation.h:46
void stageFile(WorkflowFile *file, std::shared_ptr< StorageService > ss)
Stage a copy of a file at a storage service in the root of the (unique) mount point.
Definition: Simulation.cpp:677
~Simulation()
Destructor.
Definition: Simulation.cpp:81
void readFromDiskAndWriteToDiskConcurrently(double num_bytes_to_read, double num_bytes_to_write, std::string hostname, std::string read_mount_point, std::string write_mount_point)
Wrapper enabling timestamps for concurrent disk read/writes.
Definition: Simulation.cpp:769
void writeToDisk(double num_bytes, std::string hostname, std::string mount_point)
Wrapper enabling timestamps for disk writes.
Definition: Simulation.cpp:804
static void turnOnHost(std::string hostname)
Turns on a host.
Definition: Simulation.cpp:1027
static double getMaxPowerConsumption(const std::string &hostname)
Get the maximum power consumption for the host (i.e., 100% utilization) at its current pstate.
Definition: Simulation.cpp:1227
static void turnOffLink(std::string linkname)
Turns off a link.
Definition: Simulation.cpp:1044
void writeThroughWithMemoryCache(WorkflowFile *file, double n_bytes, std::shared_ptr< FileLocation > location)
Write-through a file locally, only available if writeback is activated.
Definition: Simulation.cpp:917
static double getHostFlopRate(std::string hostname)
Get the flop rate of one core of a host given a hostname.
Definition: Simulation.cpp:1002
static bool doesLinkExist(std::string linkname)
Wrapper for S4U_Simulation linkExists()
Definition: Simulation.cpp:967
static int getNumberofPstates(const std::string &hostname)
Get the total number of power states of a host.
Definition: Simulation.cpp:1191
SimulationOutput & getOutput()
Get the simulation output object.
Definition: Simulation.cpp:1108
A network proximity service that continuously estimates inter-host latencies and can be queried for s...
Definition: NetworkProximityService.h:26
A class that contains post-mortem simulation-generated data.
Definition: SimulationOutput.h:27
double getLinkUsage(const std::string &link_name, bool record_as_time_stamp)
Obtains the current link bandwidth usage on a link and will add SimulationTimestampLinkUsage to simul...
Definition: Simulation.cpp:318
static bool isHostShutdownSimulationEnabled()
Method to check if host shutdown simulation is activated.
Definition: Simulation.cpp:345
A data file used/produced by a WorkflowTask in a Workflow.
Definition: WorkflowFile.h:26
static double getCurrentSimulatedDate()
Get the current simulated date.
Definition: Simulation.cpp:975
static double getFlopRate()
Get the flop rate of one core of the host on which the calling process is running.
Definition: Simulation.cpp:1076