{"id":18825409,"url":"https://github.com/grycap/vmrc","last_synced_at":"2025-04-14T01:31:27.719Z","repository":{"id":21938011,"uuid":"25262457","full_name":"grycap/vmrc","owner":"grycap","description":"Virtual Machine image Repository \u0026 Catalog","archived":false,"fork":false,"pushed_at":"2021-11-05T08:00:12.000Z","size":1166,"stargazers_count":13,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-27T15:52:18.657Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grycap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-15T16:04:33.000Z","updated_at":"2024-10-20T09:14:44.000Z","dependencies_parsed_at":"2022-08-20T02:50:37.914Z","dependency_job_id":null,"html_url":"https://github.com/grycap/vmrc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grycap%2Fvmrc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grycap%2Fvmrc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grycap%2Fvmrc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grycap%2Fvmrc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grycap","download_url":"https://codeload.github.com/grycap/vmrc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248807571,"owners_count":21164710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T00:59:23.214Z","updated_at":"2025-04-14T01:31:26.154Z","avatar_url":"https://github.com/grycap.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"VMRC - Virtual Machine image Repository \u0026amp; Catalog\n====\n\n\u003c!-- language: lang-none --\u003e\n    ____   ____  ____    ____  _______      ______  \n    |_  _| |_  _||_   \\  /   _||_   __ \\   .' ___  |\n     \\ \\   / /    |   \\/   |    | |__) | / .'   \\_|\n      \\ \\ / /     | |\\  /| |    |  __ /  | |\n       \\ ' /     _| |_\\/_| |_  _| |  \\ \\_\\ `.___.'\\\n        \\_/     |_____||_____||____| |___|`.____ .'\n\n\n A Virtual Machine Image Repository \u0026 Catalog\n Developed by the [Grid and High Performance Computing Group (GRyCAP)](http://www.grycap.upv.es) at the\n [Universitat Politècnica de València (UPV)](http://www.upv.es).\n\n Web page: http://www.grycap.upv.es/vmrc\n\n0 Introduction\n===============\n VMRC is client-server system (based on Web Services) to index and store Virtual Machine Images (VMI)\n along with its metadata (OS, applications, etc.). It supports matchmaking to obtain the appropriate VMIs\n that satisfy a given set of hard (must) requirements and soft (should) requirements.\n\n It is useful as a catalog of VMIs that can  stored on the VMI repository systems of the different Cloud Management Platforms (such as OpenNebula or OpenStack) or on public Clouds (such as Amazon Web Services).\n This way, customized VMIs are indexed in VMRC and applications can query, as an example, for a VMI based on Ubuntu 12.04 LTS with Java and Octave already installed.\n\n Current version: 2.1.2\n\n This repository only includes the VMRC server. Additional packages available in GitHub are:\n   - [vmrc-client](http://www.github.com/grycap/vmrc-client) (CLI and Java-based API to access VMRC)\n   - [vmrc-web](http://www.github.com/grycap/vmrc-web) (Web-based GUI to access VMRC)\n\nThe easiest and fastest way to deploy VMRC is using Docker:\n - [VMRC Docker Image - with GUI (Recommended)](https://hub.docker.com/r/grycap/vmrc-web)\n - [VMRC Docker Image - no GUI](https://hub.docker.com/r/grycap/vmrc)\n\n1 Features\n===========\n+ Multi-user support.\n+ Fine-grained authorization (per User and per VMI).\n+ Hypervisor-agnostic\n+ OVF support\n\n\n2 Compilation \u0026 Installation\n===============\n\nNote that using the [Docker image provided](https://hub.docker.com/r/grycap/vmrc-web) is recommended for easy deployment of VMRC. Proceed at your own risk.\n\nVMRC has been developed in Java using Spring, Hibernate and an SQL-based backend (such as MySQL or HSQLDB).\nIt is a web service that has to be deployed in an application server (such as Apache Tomcat).\n\n 2.1  Requirements\n ----------------\n+ Java JDK 1.7+\n+ Maven (to compile from sources and generate the WAR file)  \n+ Apache Tomcat (to deploy the WAR). Works on version 7+ up to 7.0.28 included.\n  Notice that it might not work with newer versions.\n+ (Optional) An SQL-based database (tested on MySQL 5+)\n\nIf you are working on Linux (assuming Ubuntu), you can easily install the dependencies (Git, Java + Maven) with:\n\n``\nsudo apt-get update \u0026\u0026 sudo apt-get install openjdk-7-jdk git maven\n``\n\nInstall the appropriate version of Apache Tomcat.\n\n\nVMRC server can operate with an in-memory database provided by HSQLDB (just for testing).\n\n 2.2 Compilation and Installation (from sources)\n ---------------------------------------------\n1. Clone this repository:\n```\ngit clone https://github.com/grycap/vmrc.git\n```\n\n2. Compile from sources with the command:\n```\nmvn package\n```\nIf compilation is successful (BUILD SUCCESS), the generated WAR file will be located in target/vmrc.war\n3. Deploy vmrc.war into Apache Tomcat (simply drop the war file into Tomcat's webapps folder).\n4. Start Apache Tomcat\n   * $TOMCAT_HOME/bin/startup.sh\n5. VMRC server's endpoint should be available at http://your_ip:8080/vmrc/vmrc (no GUI, just a WS endpoint)\n7. Check the VMRC server's manual available at the website http://www.grycap.upv.es/vmrc for further configuration or the [manual] folder in the repo.\n\n\n\n3 Configuration\n==================\n\nThe VMRC Server is pre-configured with an in-memory HSQLDB-based database. This should be employed for testing purposes.\nIf you want to use another SQL-based backend, proceed accordingly by configuring\n``\n[TOMCAT_HOME]/webapps/vmrc/WEB-INF/classes/hibernate.cfg.xml\n``\nA MySQL-based configuration is provided for your convenience.\n\n4 Testing\n===============\nIf you want to test VMRC you have to install the [vmrc-client](https://www.github.com/grycap/vmrc-client).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrycap%2Fvmrc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrycap%2Fvmrc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrycap%2Fvmrc/lists"}