Skip to content

Latest commit

 

History

History
259 lines (174 loc) · 6.11 KB

README.md

File metadata and controls

259 lines (174 loc) · 6.11 KB
Raw

Support scripts

init.sh

The init.sh script helps to update latest version of our cloud agent(gulpd) and its configuration(gulp.conf) file in the virtual machine images that VirtEngine provides automatically.

To use the init1.5.sh

mkdir /virtengine

cd /virtengine

wget https://raw.githubusercontent.com/VirtEngine/gitpackager/master/support/init.sh

chmod 755 init.sh

In the template update nsqd and cassandra ipaddress

The init.sh script must be modified to work with your VirtEngine Installation.

  ### Welcome to the Gulpd configuration file.
  ###
  ### [meta]
  ###
  ### Controls the parameters for the Raft consensus group that stores metadata
  ### about gulp.
  ###
  [meta]
    user = "root"
    vertice_api = "http://0.0.0.0:9000/v2" #Change to your public VirtEngine API location
    nsqd = ["0.0.0.0:4150"] #Change to your public VirtEngine NSQD location

Support for RDNS

The RDNS is the resolution of an IP address to its designated domain name.

In the opennebula template add the following

  DNS_HOSTNAME = "YES"

If the expected hostname is not set in the vm to check in the terminal

    host <ip>

The resolvable names of these name servers should be in the NS resource records of the zone.

Resolving an IP address uses the pointer DNS record type (PTR record)

In the template update gulpupd to use the correct repo

The init.sh is preconfigured to assume you are running testing and 1.5 version of repository.

You can search and change the below lines.

This is needed to get timely updates on fixes to our cloud agent(gulpd) posted periodically in S3.

The supported branches are testing, stable.


true "${version:=1.5}"
true "${branch:=testing}"

Use this common template

Please use the usual process to create a template in OpenNebula and its beyond the scope of this doc.

Make sure that the Files = "/virtengine/init.sh is configured correctly.

CONTEXT = [
 FILES = "/virtengine/init.sh",
 NETWORK = "YES",
 NODE_NAME = "$NAME",
 SET_HOSTNAME = "$NAME",
 SSH_PUBLIC_KEY = " " ]
 CPU = "0.5"
 CPU_COST = "5"
 NAME = "virtengine"
 DESCRIPTION = "common template for all images"
 DISK = [
 IMAGE = "",
 IMAGE_UNAME = "oneadmin" ]
 GRAPHICS = [
 LISTEN = "0.0.0.0",
 TYPE = "VNC" ]
 MEMORY = "1024"
 MEMORY_COST = "10"
 NIC = [
 NETWORK = "ipv4-pri",
 NETWORK_UNAME = "oneadmin" ]
 OS = [
 ARCH = "x86_64" ]
 SCHED_REQUIREMENTS = "CLUSTER_ID=\"100\""
 VCPU = "1"

This template when invoked by virtengine, we configure the following parameters automatically to correct behaviour as chosen by the user and in configuration files like vertice.conf

CPU = "0.5"
NAME = "virtengine"
DISK = [
 IMAGE = ""]
MEMORY = "1024"
NIC = [
 NETWORK = "ipv4-pri",
 NETWORK_UNAME = "oneadmin" ]

The init1.5.sh will be executed when ever the virtual machine boots.

internally we use, gulpupd

This script is bundled into init.sh as OpenNebula wants the script to be in-line and loads the full script as base64 into its memory. Hence the below copy is already there for you in init.sh

The gulpupd script helps customers to keep the shipped images Up-to-date with the latest version of our cloud agent (gulpd)

# updates the 1.5 version, testing repo
gulpupd --version 1.5.2 --branch testing

# updates the 1.5 version, stable repo
gulpupd --version 1.5.2 --branch stable

hook_virtengine.rb

hook_virtengine.rb triggers VirtEngine when the virtual machine hits the following states.

delete, suspend, poweroff, boot_suspend

To use the hook_virtengine.rb

  1. In your OpenNebula installation, edit the /etc/one/oned.conf with the following
VM_HOOK = 
 name      = "poweroff_hook",
 on        = "CUSTOM",
 state     = "ACTIVE",
 lcm_state = "SHUTDOWN_POWEROFF",
 command   = "hook_virtengine.rb",
 arguments = "$ID $TEMPLATE poweroff stopped" ]

VM_HOOK = [
 name      = "delete_hook",
 on        = "DONE",
 command   = "hook_virtengine.rb",
 arguments = "$ID $TEMPLATE destroyed destroyed" ]

VM_HOOK = [
 name      = "suspend_hook",
 on        = "CUSTOM",
 state     = "SUSPENDED",
 lcm_state = "LCM_INIT",
 command   = "hook_virtengine.rb",
 arguments = "$ID $TEMPLATE suspended suspended" ]

VM_HOOK = [
 name      = "boot_suspend_hook",
 on        = "CUSTOM",
 state     = "BOOT_SUSPENDED",
 lcm_state = "RUNNING",
 command   = "hook_virtengine.rb",
 arguments = "$ID $TEMPLATE running running" ]
 
 
VM_HOOK = [
 name      = "running_hook",
 on        = "CUSTOM",
 state     = "ACTIVE",
 lcm_state = "RUNNING",
 command   = "hook_virtengine.rb",
 arguments = "$ID $TEMPLATE running running" ]
  1. Copy the hook_virtengine.rb file into the location /var/lib/one/remotes/hooks

wget https://raw.githubusercontent.com/VirtEngine/gitpackager/master/support/hook_virtengine.rb

cp hook_virtengine.rb /var/lib/one/remotes/hooks

chmod 755 hook_virtengine.rb

chown oneadmin:oneadmin /var/lib/one/remotes/hooks/hook_virtengine.rb
  1. Create master_key file into the location /var/lib/detio
cat >master_key << EOF
host=http://localhost:9000/v2
masterkey=3b8eb672aa7c8db82e5d34a0744740b20ed59e1f6814cfb63364040b0994ee3f
EOF

VirtEngine WHMCS Addon

  1. Copy the post_billing_transaction_hook in to directory /var/www/html/whmcs/include/hooks
$ cd /var/www/html/whmcs/include/hooks

$ wget https://raw.githubusercontent.com/megamsys/gitpackager/master/support/post_billing_transaction_hook

$ sudo service apache2 restart
  1. Change the script to point to your gateway

letsencrypt

LetsEncrypt is a certificate authority that provides free X.509 certificates via an automated process.

We provide a LetsEncrypt wrapper shell script which can be downloaded into any directory.

Please make sure you have a valid public domain and public ip address.

wget https://raw.githubusercontent.com/megamsys/gitpackager/master/support/letsencrypt

chmod 0755 letsencrypt

# install the letsencrypt certificate
letsencrypt --install  <domainame> <domainip>

# remove the letsencrypt certificate
letsencrypt --remove <domainname>

# renewal the letsencrypt certificate
letsencrypt --autorenew <domainname>