NetScaler Automaon - virtuEs.IT...generic content-type: applicaon/ json (NetScaler 10.1+) #CitrixSynergy - May 24 th , 2017 #SYN325 10 A way to interact with an API via series of HTTP

NetScaler Automa.on USING POWERSHELL TO TALK NITRO

2#CitrixSynergy-May24th,2017 #SYN325

Tweetaboutthissessionwithhashtags#syn325and#citrixsynergy

StockImageComp


§  20 years of Technical Consulting

§  Solutions Architect at PepperByte §  MSc Computer Science §  Design | Implement | Troubleshooting

§  5+ years of DevOps scripting fun §  Automating Windows Server Deployments §  Automating Citrix Deployments §  Automating NetScaler Deployments

YourPresenter: EstherBarthel SoluConsArchitect

@virtuEs_IT hKp://nl.linkedin.com/in/ebarthel hKp://www.virtues.it

About Esther

Agenda

q Introduc>onq RESTfulAPIs&NITROq PowerShellNetScalerModule

q Automa>ngNetScalerConfigura>onsq BasicSystemSeKngsq LoadBalancingSeKngsq NetScalerGatewaySeKngs

q BonusSlidesq DeployingNetScalerVPXwithfixedIP-addressq CPXLoadBalancing

Introduc.on REST API & NITRO


 REpresentaConalStateTransfer(REST):◦  Client-Server◦  Stateless◦  PlaSorm&language-independent◦  Standards-based(runsontopofHTTPprotocol)◦  Easilyusedinpresenceoffirewalls(port80or443)

 NITRO(RESTfulserviceonNetScaler):◦  CommunicatewithNetScalerprogramma>cally◦  HumanreadableHTTP-basedinterac>on◦  NITROSDKsavailableformul>plelanguages(Java,Python,.NET,REST)

RESTful APIs

Introduction > Automation > Bonus

NITROWebService

ClientApplicaCon

RESTrequest

RESTresponse


 AwaytointeractwithanAPIviaseriesofHTTPcalls

◦  VERB:HTTPMethod(GET,POST,PUT,DELETE,OPTIONS)◦  URI:resourceonwhichtheopera>onisperformed◦  HTTPVersion:usually"HTTP/1.1"◦  RequestHeader:containsmetadata(formaKng,etc.)◦  RequestBody:actualmessagecontent

RESTful APIs


<VERB> <URI> <HTTP Version>

<Request Header>

<Request Body>



◦  HTTPMethod(GET,POST,PUT,DELETE)

NITRO


◦  URL:hbp(s)://<ns-ipaddress>/nitro/v1/config/nsfeature?acCon=enable

◦  AddabasicURLstemtousewithNITRO:◦  hbp://<NSIP>/nitro/v1/stat/ –>en>tyandsystemsta>s>cs◦  hbp://<NSIP>/nitro/v1/config/ –>configura>onopera>ons

◦  AddtheresourcetypetotheURL (andinsomecasesalsotheresourcename)

◦  SpecifyanacConfortheURL (bind,unset,enable,disable)



◦  SpecifytheContent-TypeintheRequestHeader:

◦  Content-Type:applica>on/vnd.com.citrix.netscaler.nsfeature+json

◦  AddtheJSONpayloadtotheRequestBody:

NITRO


genericcontent-type:applicaCon/json (NetScaler10.1+)



NITRO



NITRO API Documenta.on



Citrix Blog


source:hbps://github.com/san>agocardenas/netscaler-configura>on


 WhatisincludedinthePowerShellModulefromtheCitrixBlog?

NetScaler Automa.on w/ PowerShell


GlobalNetScalerFeatures NetScalerIPAddresses

Hostname Timezone

DNSNameServer LoadBalancing

Monitors Cer>ficates

LDAPAuthen>ca>on Gateway

POST


 WhatisincludedinthePowerShellModulefromtheCitrixBlog?WhatisincludedinthePS-NITROPowerShellModule?



GlobalNetScalerFeatures NetScalerIPAddresses

Hostname Timezone

DNSNameServer LoadBalancing

Monitors Cer>ficates

LDAPAuthen>ca>on Gateway

FileUploads(.cert,.key,.txt,.lic) SystemBackup

NTPServers SystemUsers&Groups

Responder&Rewrite DNSNameRecords

ContentSwitching GlobalServerLoadBalancing

PUTGET

DELETEPOST

Automa.ng NetScaler Configura.ons

A BASIC EXAMPLE


GlobalNetScalerFeatures

NetScaler Automa.on w/ NITRO




NetScaler Automa.on w/ PowerShell Module



PowerShell in Ac.on



LOAD BALANCING


NetScalerLoadBalancing




NetScalerLoadBalancing–Rewrite&Responderpolicies




NetScalerLoadBalancing–Servers,Services&ServiceGroups




NetScalerLoadBalancing–Monitors&vServers




PowerShell in Ac.on



U S I N G INVOKE-RESTMETHOD C M D L E T


JSON Array & Hastable formaRng



JSON Array & Hastable formaRng



Convert-To Json cmdlet



Convert-To Json cmdlet - Depth parameter




NetScaler Automa.on w/ NITRO



NetScaler Automa.on w/ PowerShell & REST



NETSCALER GATEWAY


NetScalerGateway




NetScalerGateway




PowerShell in Ac.on


The Scripts WHERE TO GO NEXT?


UploadingthePowerShellModuleandScriptsaoerthepresentaCon

GitHub


SharingtheextendedPowerShellModuleanddemoScriptswiththeCommunity:

hKps://github.com/cogniConIT/PS-NITRO

Presentedby: EstherBarthel SoluConsArchitect

@virtuEs_IT hKp://nl.linkedin.com/in/ebarthel hKp://www.virtues.it

Bonus Slides AUTOMATE DEPLOYMENTS


CTX128236:HowToAuto-ProvisionNetScalerVPXonXenServer

Bonus: NetScaler VPX with fixed IP (Hypervisors)


source:hbp://www.virtues.it/2015/11/ps-import-ns-vpx-fixed-ip-on-xs/


CTX128250:HowToAuto-ProvisionNetScalerVPXonESXorESXiHost

Bonus: NetScaler VPX with fixed IP (Hypervisors)


source:hbp://www.virtues.it/2016/01/ps-import-ns-vpx-fixed-ip-esxi/


CitrixProductDocumentaCon:SDX11.1–NITROAPIDocumentaCon

Bonus: NetScaler VPX with fixed IP (NS SDX)


source:hbps://docs.citrix.com/en-us/sdx/11-1/nitro-api-doc/nitro-rest-api.html


CitrixProductDocumentaCon:

Bonus: NetScaler VPX with fixed IP (Hyper-V)


source:hbps://docs.citrix.com/en-us/netscaler/12/deploying-vpx/install-vpx-on-hyper-v.html

Bonus Slides CPX LOAD BALANCING


NetScalerCPXLoadBalancing




NetScalerCPXLoadBalancing–LBvServer




NetScalerCPXLoadBalancing–LBvServer




PowerShell in Ac.on


49 ©2017Citrix

Beforeyouleave…

Pleaseratethissessioninthemobileapp

50 ©2016Citrix|Confiden>al

“Itwasanopportunitytobringtogetherlike-mindedpeople,network,sharestories,andhelpeachother.”–CUGCMember

Fortheusers,bytheusers

•  16,000+membersglobally•  60+localusergroupsandspecialinterestgroups(SIGs)•  Knowledgesharing,expertdiscussion•  Networkingatlocalmee>ngs,conferencesandtechnologyevents•  Technicalwebinars,forumsandblogs•  Opportuni>estoshare,learn,mentorandlead

FindusattheCommunityHubinSynergyPark!

NetScaler Automaon - virtuEs.IT...generic content-type: applicaon/ json (NetScaler 10.1+) #CitrixSynergy - May 24 th , 2017 #SYN325 10 A way to interact with an API via series of HTTP

Documents