1

ProvisioningtheOracleEventHubCloudService

BeforeYouBegin

Purpose

Inthistutorial,youlearntoprovisiontheOracleEventHubCloudService.Therearethreesectionsinthistutorial:-1. CreatinganOracleEventHubCloudServiceCluster2. CreatinganOracleEventHubCloudServiceTopic3. ProvidingAccesstotheCluster

TimetoComplete

30minutes

Background

OracleEventHubCloudServiceprovidesahighlyavailableandscalablemessagingplatform.ThisserviceprovidesadistributedstreamingdataplatformforApacheKafka..AKafkainstanceisacomputeclusterofoneormoreserverscallednodes,thatstorestreamsofrecords(messages)incategoriescalledtopics.Thereare3keycapabilitiesinherentinaKafkaServer:

1) Itletsyoupublishandsubscribetothestreamsofrecords,insomewayssimilartoanemailsystem.

2) Itstoresthesestreamsofmessagescalledrecordsinafault-tolerantway.3) Itallowsforprocessingofthesemessagestreamsastheyoccur.

Userscanspinuponeormoreclusterseachwithasetofassociatedtopics.TheOracleEventHubCloudService-Topicisacontainertoholdthestreamrecords.Aproducerapplicationcreatesorwritesthemessages,andaconsumerapplicationreadsfromthesemessages.

WhatDoYouNeed?

Beforestartingthistutorial,youshouldhave:l OracleEventHubCloudServiceaccountlogincredentials

2

Context

ThistutorialispartoftheNewDataLakeseriesOracleBigDataJourney.Thesequencetofollowis:Part1–CreatingyourBDCS-CEClusterPart2–Notebooks,ObjectStorage,andSparkPart3–ProvisioningtheOracleEventHubCloudServicePart4–WorkingwithOEHCS

Creating an Oracle Event Hub Cloud Service

Cluster

OntheSignIntoOracleCloudpage,enterthenameofyouridentitydomain.ClickGo.

Enteryourusernameandpassword.ClickSignIn.

3

TheMyServicesdashboardopens.ClickEventHub–Dedicated.

OntheServiceDetailspage,clickOpenServiceConsole.

OntheServicespage,clickCreateService.

The Oracle Event Hub Cloud Service— Platform Create Service wizard starts and the Service page isdisplayed.

4

OntheServicepage,provideaname,Kafka-Basic,anddescription,1NodeKafkaServer,forthecluster,andthenclickNexttoadvancetotheServiceDetailspage.

OntheServiceDetailspage,provideadditionalconfigurationparameters. DeploymentType–Basic,basicdeployment runsKafkabrokerandZookeeperon samenode(s). This istypicalfordevelopment/testclusters.SSHPublicKey–ClickEdittospecifythepublickey.Youcanuploadafilecontainingthepublickeyvalueifyouhavegeneratedakeypair. NumberofNodes–1ComputeShape–OC2m–2.0OCPU,30.0GBRAMUsableTopicStorage–50EnableRestAccess–unchecked,youdon’tneedtoenablerestaccessinthistutorial.ClickNext.

5

OntheConfirmationpage,reviewtheinformationlisted.Ifyou'resatisfiedwithwhatyousee,clickCreatetocreatethecluster.Ifyouneedtochangesomething,clickPreviousatthetopofthewizardtostepbackthroughthepages,orclickCanceltocanceloutofthewizardwithoutcreatinganewcluster.

OntheServiceConsolepage,youcanseethatthestatusofKafka-Basic instanceisCreatingservice….Ittakessomeminutestocreateit. Refreshyourexploreraboutevery5minutestocheckthelateststatus.

OncetheKafka-Basicinstanceiscreated,clickthenameoftheinstance,Kafka-Basic,togototheServiceOverviewpage.

6

On the ServiceOverviewpage, you can see the information of Statues,HostName, Public IP, Instancenameetc.Notice theConnect Descriptorelement. This is the host name that you will use while connecting totheKafka -Basicservice.Youwill learnhowtoconfigureaccessrules to theservices in thirdsectionofthistutorial.ClickOracleEventHubCloudService–PlatformatthetopleftcornertogototheServiceConsolepage.

CreatinganOracleEventHubCloudServiceTopic

OntheServicespageofOracleEventHubCloudService-Platform,clickthe iconatthetopleftcorner.

7

ClickOracleEventHubCloudServiceinthepop-upmenu.

IntheServicespage,clickCreateService.

TheCreateServicescreenappears.Providethefollowingdetails.ServiceName:TopicAServiceDescription:FirstTopicforKafkaHostedOn:Kafka–Basic,

8

NumberofPartitions:1RetentionPeriod(Hours):72Note:Kafka–Basic isthenameoftheOracleEventHubCloudService-Platformclusteryoucreatedintheprevioussectionofthistutorial. ClickNext.

OntheConfirmationpage,reviewtheinformationlisted.Ifyou'resatisfiedwithwhatyousee,clickCreatetocreatethetopic.

ThecontrolreturnstotheServicespage.IntheServicespage,youcouldnowseethenewTopicAservicehasbeencreated.Clickthemenuicon atthetopleftcorner.

9

ClickOracleEventHubCloudService–Platforminthepop-upmenu.

ProvidingAccesstotheCluster

ThecontrolgoestotheServicespageofOracleEventHubCloudService–Platform.Clickthemenuicon

ontherightofKafka–Basicarea.

ClickAccessRulesinthepop-upmenu.

10

TheAccessRulespageisdisplayed.ClickCreateRule.

TheCreateAccessRulescreenisdisplayed.Providethefollowingdetails.RuleName:ZookeeperInternetAccessDescription:AccessfrominternetanddesktopSource:PUBLIC_INTERNETDestination:kafka_ZK_SERVERDestinationPorts:2181Protocol:TCPNote:By default the native access to Kafka is blockeddue to security reasons. For the purpose of thistutorial,wewillopenituptopublicIP.However,whensettingupfordevelopment,test,orproduction,dorestrict the native access to specific IP Addresses. You can provide access to specific machines byprovidingtheiraddressinthesourcefield,orbyusingcustomrules.ClickCreate.

11

Createthesecondruleinthesameway.IntheCreateAccessRulescreenwindow,providethefollowingdetails.RuleName:KafkaInternetAccessDescription:AccesstoKafkaservicefrominternetordesktopSource:PUBLIC_INTERNETDestination:kafka_KAFKA_SERVERDestinationPorts:6667Protocol:TCPClickCreate.ThenewlycreatedrulesarelistedintheAccessRulespage.

WanttoLearnMore?

• Oracle Event Hub Cloud Service

• Using Oracle Event Hub Cloud Service