Aktualizr
C++ SOTA Client
All Classes Namespaces Files Functions Variables Enumerations Enumerator Pages
aktualizr.cc
1 #include "aktualizr.h"
2 
3 #include <chrono>
4 
5 #include <sodium.h>
6 
7 #include "primary/events.h"
8 #include "utilities/timer.h"
9 
10 using std::make_shared;
11 using std::shared_ptr;
12 
14  : Aktualizr(config, INvStorage::newStorage(config.storage), std::make_shared<HttpClient>()) {}
15 
16 Aktualizr::Aktualizr(Config config, std::shared_ptr<INvStorage> storage_in, std::shared_ptr<HttpInterface> http_in)
17  : config_{std::move(config)}, sig_{new event::Channel()} {
18  if (sodium_init() == -1) { // Note that sodium_init doesn't require a matching 'sodium_deinit'
19  throw std::runtime_error("Unable to initialize libsodium");
20  }
21 
22  storage_ = std::move(storage_in);
23  storage_->importData(config_.import);
24 
25  uptane_client_ = std::make_shared<SotaUptaneClient>(config_, storage_, http_in, sig_);
26 }
27 
29  uptane_client_->initialize();
30  api_queue_.run();
31 }
32 
33 bool Aktualizr::IsRegistered() const { return storage_->loadEcuRegistered(); }
34 
36  result::UpdateCheck update_result = CheckUpdates().get();
37  if (update_result.updates.empty()) {
38  if (update_result.status == result::UpdateStatus::kError) {
39  // If the metadata verification failed, inform the backend immediately.
40  SendManifest().get();
41  }
42  return true;
43  }
44 
45  result::Download download_result = Download(update_result.updates).get();
46  if (download_result.status != result::DownloadStatus::kSuccess || download_result.updates.empty()) {
47  if (download_result.status != result::DownloadStatus::kNothingToDownload) {
48  // If the download failed, inform the backend immediately.
49  SendManifest().get();
50  }
51  return true;
52  }
53 
54  Install(download_result.updates).get();
55 
56  if (uptane_client_->isInstallCompletionRequired()) {
57  // If there are some pending updates then effectively either reboot (ostree) or aktualizr restart (fake pack mngr)
58  // is required to apply the update(s)
59  LOG_INFO << "About to exit aktualizr so the pending updates can be applied after reboot";
60  return false;
61  }
62 
63  if (!uptane_client_->hasPendingUpdates()) {
64  // If updates were applied and no any reboot/finalization is required then send/put manifest
65  // as soon as possible, don't wait for config_.uptane.polling_sec
66  SendManifest().get();
67  }
68 
69  return true;
70 }
71 
72 std::future<void> Aktualizr::RunForever() {
73  std::future<void> future = std::async(std::launch::async, [&]() {
74  SendDeviceData().get();
75 
76  std::unique_lock<std::mutex> l(exit_cond_.m);
77  while (true) {
78  if (!UptaneCycle()) {
79  break;
80  }
81 
82  if (exit_cond_.cv.wait_for(l, std::chrono::seconds(config_.uptane.polling_sec),
83  [this] { return exit_cond_.flag; })) {
84  break;
85  }
86  }
87  uptane_client_->completeInstall();
88  });
89  return future;
90 }
91 
93  {
94  std::lock_guard<std::mutex> g(exit_cond_.m);
95  exit_cond_.flag = true;
96  }
97  exit_cond_.cv.notify_all();
98 }
99 
100 void Aktualizr::AddSecondary(const std::shared_ptr<Uptane::SecondaryInterface> &secondary) {
101  uptane_client_->addNewSecondary(secondary);
102 }
103 
104 std::future<result::CampaignCheck> Aktualizr::CampaignCheck() {
105  std::function<result::CampaignCheck()> task([this] { return uptane_client_->campaignCheck(); });
106  return api_queue_.enqueue(task);
107 }
108 
109 std::future<void> Aktualizr::CampaignControl(const std::string &campaign_id, campaign::Cmd cmd) {
110  std::function<void()> task([this, campaign_id, cmd] {
111  switch (cmd) {
112  case campaign::Cmd::Accept:
113  uptane_client_->campaignAccept(campaign_id);
114  break;
115  case campaign::Cmd::Decline:
116  uptane_client_->campaignDecline(campaign_id);
117  break;
118  case campaign::Cmd::Postpone:
119  uptane_client_->campaignPostpone(campaign_id);
120  break;
121  default:
122  break;
123  }
124  });
125  return api_queue_.enqueue(task);
126 }
127 
128 std::future<void> Aktualizr::SendDeviceData() {
129  std::function<void()> task([this] { uptane_client_->sendDeviceData(); });
130  return api_queue_.enqueue(task);
131 }
132 
133 std::future<result::UpdateCheck> Aktualizr::CheckUpdates() {
134  std::function<result::UpdateCheck()> task([this] { return uptane_client_->fetchMeta(); });
135  return api_queue_.enqueue(task);
136 }
137 
138 std::future<result::Download> Aktualizr::Download(const std::vector<Uptane::Target> &updates) {
139  std::function<result::Download(const api::FlowControlToken *)> task(
140  [this, updates](const api::FlowControlToken *token) { return uptane_client_->downloadImages(updates, token); });
141  return api_queue_.enqueue(task);
142 }
143 
144 std::future<result::Install> Aktualizr::Install(const std::vector<Uptane::Target> &updates) {
145  std::function<result::Install()> task([this, updates] { return uptane_client_->uptaneInstall(updates); });
146  return api_queue_.enqueue(task);
147 }
148 
149 std::future<bool> Aktualizr::SendManifest(const Json::Value &custom) {
150  std::function<bool()> task([this, custom]() { return uptane_client_->putManifest(custom); });
151  return api_queue_.enqueue(task);
152 }
153 
155  if (api_queue_.pause(true)) {
156  uptane_client_->reportPause();
157  return result::PauseStatus::kSuccess;
158  } else {
159  return result::PauseStatus::kAlreadyPaused;
160  }
161 }
162 
164  if (api_queue_.pause(false)) {
165  uptane_client_->reportResume();
166  return result::PauseStatus::kSuccess;
167  } else {
168  return result::PauseStatus::kAlreadyRunning;
169  }
170 }
171 
172 void Aktualizr::Abort() { api_queue_.abort(); }
173 
174 boost::signals2::connection Aktualizr::SetSignalHandler(
175  const std::function<void(shared_ptr<event::BaseEvent>)> &handler) {
176  return sig_->connect(handler);
177 }
178 
179 Aktualizr::InstallationLog Aktualizr::GetInstallationLog() {
180  std::vector<Aktualizr::InstallationLogEntry> ilog;
181 
182  EcuSerials serials;
183  if (!storage_->loadEcuSerials(&serials)) {
184  throw std::runtime_error("Could not load ecu serials");
185  }
186 
187  ilog.reserve(serials.size());
188  for (const auto &s : serials) {
189  Uptane::EcuSerial serial = s.first;
190  std::vector<Uptane::Target> installs;
191 
192  std::vector<Uptane::Target> log;
193  storage_->loadInstallationLog(serial.ToString(), &log, true);
194 
195  ilog.emplace_back(Aktualizr::InstallationLogEntry{serial, std::move(log)});
196  }
197 
198  return ilog;
199 }
200 
201 std::vector<Uptane::Target> Aktualizr::GetStoredTargets() { return storage_->getTargetFiles(); }
202 
203 void Aktualizr::DeleteStoredTarget(const Uptane::Target &target) { storage_->removeTargetFile(target.filename()); }
204 
205 std::unique_ptr<StorageTargetRHandle> Aktualizr::OpenStoredTarget(const Uptane::Target &target) {
206  auto handle = storage_->openTargetFile(target);
207  if (handle->isPartial()) {
208  throw std::runtime_error("Target was partially downloaded");
209  }
210  return handle;
211 }
Aktualizr::Resume
result::Pause Resume()
Resume the library operations.
Definition: aktualizr.cc:163
Aktualizr::RunForever
std::future< void > RunForever()
Asynchronously run aktualizr indefinitely until Shutdown is called.
Definition: aktualizr.cc:72
Aktualizr::Install
std::future< result::Install > Install(const std::vector< Uptane::Target > &updates)
Install targets.
Definition: aktualizr.cc:144
Aktualizr::Aktualizr
Aktualizr(const Config &config)
Aktualizr requires a configuration object.
Definition: aktualizr.cc:13
Aktualizr::DeleteStoredTarget
void DeleteStoredTarget(const Uptane::Target &target)
Delete a stored target from storage.
Definition: aktualizr.cc:203
Aktualizr::IsRegistered
bool IsRegistered() const
Returns true if the device has been registered to the backend succesffully.
Definition: aktualizr.cc:33
Aktualizr::SendManifest
std::future< bool > SendManifest(const Json::Value &custom=Json::nullValue)
Send installation report to the backend.
Definition: aktualizr.cc:149
Aktualizr::CampaignControl
std::future< void > CampaignControl(const std::string &campaign_id, campaign::Cmd cmd)
Act on campaign: accept, decline or postpone.
Definition: aktualizr.cc:109
Aktualizr::Shutdown
void Shutdown()
Shuts down currently running RunForever() method.
Definition: aktualizr.cc:92
result::UpdateCheck
Container for information about available updates.
Definition: results.h:38
Aktualizr::Initialize
void Initialize()
Initialize aktualizr.
Definition: aktualizr.cc:28
Aktualizr::CheckUpdates
std::future< result::UpdateCheck > CheckUpdates()
Fetch Uptane metadata and check for updates.
Definition: aktualizr.cc:133
Aktualizr::CampaignCheck
std::future< result::CampaignCheck > CampaignCheck()
Check for campaigns.
Definition: aktualizr.cc:104
Config
Configuration object for an aktualizr instance running on a primary ECU.
Definition: config.h:73
events.h
Uptane::EcuSerial
Definition: tuf.h:174
Aktualizr
This class provides the main APIs necessary for launching and controlling libaktualizr.
Definition: aktualizr.h:20
HttpClient
Definition: httpclient.h:28
result::Download
Container for information about downloading an update.
Definition: results.h:117
Aktualizr::Abort
void Abort()
Aborts the currently running command, if it can be aborted, or waits for it to finish; then removes a...
Definition: aktualizr.cc:172
Aktualizr::GetStoredTargets
std::vector< Uptane::Target > GetStoredTargets()
Get list of targets currently in storage.
Definition: aktualizr.cc:201
Aktualizr::InstallationLogEntry
Get log of installations.
Definition: aktualizr.h:100
result::Pause
Definition: results.h:69
api::FlowControlToken
Provides a thread-safe way to pause and terminate task execution.
Definition: apiqueue.h:19
Aktualizr::SetSignalHandler
boost::signals2::connection SetSignalHandler(const SigHandler &handler)
Provide a function to receive event notifications.
Definition: aktualizr.cc:174
Aktualizr::OpenStoredTarget
std::unique_ptr< StorageTargetRHandle > OpenStoredTarget(const Uptane::Target &target)
Get target downloaded in Download call.
Definition: aktualizr.cc:205
result::Install
Container for information about installing an update.
Definition: results.h:130
Aktualizr::UptaneCycle
bool UptaneCycle()
Synchronously run an uptane cycle: check for updates, download any new targets, install them,...
Definition: aktualizr.cc:35
Uptane::Target
Definition: tuf.h:238
result::CampaignCheck
Container for information about available campaigns.
Definition: results.h:17
Aktualizr::SendDeviceData
std::future< void > SendDeviceData()
Send local device data to the server.
Definition: aktualizr.cc:128
INvStorage
Definition: invstorage.h:109
Aktualizr::Download
std::future< result::Download > Download(const std::vector< Uptane::Target > &updates)
Download targets.
Definition: aktualizr.cc:138
Aktualizr::AddSecondary
void AddSecondary(const std::shared_ptr< Uptane::SecondaryInterface > &secondary)
Add new secondary to aktualizr.
Definition: aktualizr.cc:100
Aktualizr::Pause
result::Pause Pause()
Pause the library operations.
Definition: aktualizr.cc:154