/moVirt

A mobile client for oVirt

Primary LanguageJavaApache License 2.0Apache-2.0

moVirt

![Gitter](https://badges.gitter.im/Join Chat.svg)

A mobile client for oVirt.

Current version: 1.2 You can install it from Google Play Store Or using the direct link

###Changelog: ####v1.2:

  • Added basic support for storage
  • Fixes in augmented reality (scan code) part

####v1.1:

  • Added max utilized resources and overview of issues to the dashboard
  • Now can survive even completely broken response from the REST API
  • Better error handling
  • Better UX for the connection settings

####v0.2:

  • Added augmented reality.
  • Added icons for events.
  • Refresh button on every screen.
  • Added connection information icon and notification.
  • Added option to set periodic sync with custom time interval.
  • Added actions in Host activity (activate, deactivate).
  • Added SPICE over SSL support.
  • Enriched VM activity with cluster and host information.

###Known issues: ####v0.2, v1.0, v1.1:

  • Non-admin users support currently disabled.
  • SPICE may not work well with SSL on Android 5.+
  • Certificates may not work on Android 4.1 (use "Ignore certificate checking" in advanced connection settings).
  • Event triggers may spam you with notifications about old events.

###User's guide:
After successfully installing the application, you need to set the connection details up:

  • API URL: http://host:port/ovirt-engine/api
  • Username: name@domain - e.g. admin@internal
  • Password: your password
  • Admin Privilege: enable or disable the checkbox
  • Advanced Settings: certificate management

Also you can set optional settings:

  • Poll Events: enable or disable the checkbox
  • Connection Notifications: enable or disable the checkbox
  • Periodic Sync: enable or disable the checkbox
  • Sync Interval: configure the polling interval in minutes
  • Max events locally: the maximum number of events stored locally
  • Events Search Query: poll events for the search query. Admin users only. - e.g. severity > warning
  • Max VMs polled: maximum number of VMs polled.
  • VMs Search Query: poll VMs for the search query. Admin users only. - e.g. name = "production"

Video demonstrations:

  1. bVNC and Triggers
    Feature demonstration on YouTube

####Remote console Follow these steps to connect to remote console:

#####VNC

  • Install bVNC from Google Play
  • Click console button in VM Detail view

#####SPICE

  • Install aSPICE(v3.7.7+) from Google Play Store
  • Click console button in VM Detail view

####Augmented Reality
You can use your smartphone/tablet camera to help managing your servers. Follow these steps to access augmented reality:

  1. Generate Data Matrix codes for each host you running (this step will be simplified in future).
  • Open http://host:port/ovirt-engine/api/hosts in your browser and find host ID.
  • Make data matrix codes with any online generator containing these IDs as a text (one code for each ID).
  1. Print and stick codes to physical servers.
  2. Open Scan Codes option in moVirt and you are ready.

###Get in Touch

  • Interested about news? Follow us on Twitter
  • Have user questions? Subscribe to oVirt's users list and post a question with subject containing [moVirt]
  • Want to contribute? Have development oriented questions? Subscribe to oVirt's devel list and post a question with subject containing [moVirt]
  • Want to chat? We are usually hanging in irc.oftc.net in #ovirt - look for mbetak, tjelinek, NoiseDoll or yixinzhang. Or anyone else, people are friendly there ;)

###Developer's guide:
To start contributing to moVirt, you will need to install the following things
For Windows users:

  • Download and install Android Studio Bundle.
  • Add packages in Android SDK Manager (guide), you need:
    • Android SDK Platform-tools
    • Android SDK Build-tools v.20 and 21.*.
    • Android Support Library and Repository
    • Android API 20 SDK (you can install additional SDK as per your needs).

For Linux/MacOS users:

  • Download Android SDK
  • Download and install Android Studio or any other IDE for Java development.
  • Install Android SDK (guide)
  • Add packages in Android SDK Manager (guide), you need:
    • Android SDK Platform-tools
    • Android SDK Build-tools v.20 and 21.*.
    • Android Support Library and Repository
    • Android API 20 SDK (you can install additional SDK as per your needs).

Once the installations are done, you can proceed to import the project into the workspace.

  1. This step only for Windows users.
  • Before importing you need to change symlink. To do this run CMD with admin rights, change directory with cd [/d] path\to\movirt\root, and run symlink.bat. Repeat every time after updating repo.
  • Also you might want to exclude symlink from your local repo. To do this add AndroidManifest.xml to the end of .git\info\exclude file.
  1. File -> Open -> ~/" path to moVirt project "/build.gradle. Or select "Import project" from Welcome page.
  2. On the import dialog : Select local gradle distribution. Give the path to gradle version 2.2.1.

    After this, the prompt asks you to enter the path to the android sdk.
    You can refer the following image for the complete SDK path.
  3. Press OK. The build takes a while to complete. After it is done, the project is reloaded.
  4. Run the android application on an emulator or a developer's device.
    Run -> Run -> Select moVirt-moVirt
    For the first time Run -> Edit Configurations
    Click on the + icon -> Android application -> in right panel General tab select the moVirt-moVirt module.
    Click Apply. Click OK.

Resources: