Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 

README.md

iControlLBO

PowerShell module for interacting and controlling LoadBalancer.Org appliances

Usage

Import module

if (!(Get-Module iControlLBO)) {
  Import-Module iControlLBO
}

View available commands from module

Get-Command -Module iControlLBO

This shows for example:

CommandType     Name                                               ModuleName
-----------     ----                                               ----------
Function        Install-LBDependencies                             iControlLBO
Function        New-LBConnection                                   iControlLBO
Function        Invoke-LBRipDrain                                  iControlLBO
Function        Invoke-LBRipHalt                                   iControlLBO
Function        Invoke-LBRipOnline                                 iControlLBO
Function        Invoke-LBCustomCommand                             iControlLBO
Function        Remove-LBConnection                                iControlLBO

Install pre-requisites

Install-LBDependencies

If for some reason there's a naming conflict with the Install-LBDependencies function and another module, run iControlLBO\Install-LBDependencies instead.

Create connection to LB

Create the connection and save it to a variable:

$ssh_con = New-LBConnection

New-LBConnection will prompt you for any missing fields, e.g. username, password, hostname.

Establish connection with username/password

$ssh_con = New-LBConnection -appliance $hostname -username $username -password $password

Establish connection with public/private keypair without passphrase on private key

$ssh_con = New-LBConnection -appliance $hostname -username $username -key "C:\full\path\to\my\key"

It will prompt you for a password, simply hit enter.

Establish connection with public/private keypair with passphrase on private key

$ssh_con = New-LBConnection -appliance $hostname -username $username -key "C:\full\path\to\my\key"

Enter password at prompt, or as a command line argument with -password $password

Start/halt/drain a RIP

Start RIP

There is a -sudo flag if you need it.

Invoke-LBRipOnline -connection $ssh_con -vip web -rip web1
Host       : hostname
Output     : {, , CLI: online web1 web1 completed}
ExitStatus : 0

Drain RIP

There is a -sudo flag if you need it.

Invoke-LBRipDrain -connection $ssh_con -vip web -rip web1
Host       : hostname
Output     : {, , CLI: drain web1 web1 completed}
ExitStatus : 0

Halt RIP

There is a -sudo flag if you need it.

Invoke-LBRipHalt -connection $ssh_con -vip web -rip web1
Host       : hostname
Output     : {, , CLI: halt web1 web1 completed}
ExitStatus : 0

Remove the SSH connection

This assumes you've created a session already as shown in the previous examples. No output is expected, check the return code if you want to verify that the function succeeded.

Remove-LBSession -connection $ssh_con

Other

Custom Commands

There is a -sudo flag if you need it.

Invoke-LBCustomCommand -connection $ssh_con -command "df -h | grep /dev/sda1"
Host       : hostname
Output     : {/dev/sda1       2.6G  1.1G  1.3G  46% /}
ExitStatus : 0

About

PowerShell module for interacting and controlling LoadBalancer.Org appliances

Resources

License

Releases

No releases published

Packages

No packages published