blob: 905a690b608ce48516539a0d8ef573213d182724 [file] [log] [blame]
/*
* Copyright 2017-present Open Networking Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.onosproject.p4runtime.ctl;
import com.google.common.collect.HashMultimap;
import com.google.common.collect.ImmutableMap;
import com.google.common.collect.Lists;
import com.google.common.collect.Maps;
import com.google.common.collect.Multimap;
import com.google.common.collect.Sets;
import com.google.protobuf.ByteString;
import com.google.protobuf.InvalidProtocolBufferException;
import io.grpc.Context;
import io.grpc.ManagedChannel;
import io.grpc.Status;
import io.grpc.StatusRuntimeException;
import io.grpc.stub.StreamObserver;
import org.onlab.osgi.DefaultServiceDirectory;
import org.onlab.util.Tools;
import org.onosproject.net.DeviceId;
import org.onosproject.net.MastershipRole;
import org.onosproject.net.pi.model.PiActionProfileId;
import org.onosproject.net.pi.model.PiCounterId;
import org.onosproject.net.pi.model.PiCounterType;
import org.onosproject.net.pi.model.PiPipeconf;
import org.onosproject.net.pi.model.PiTableId;
import org.onosproject.net.pi.runtime.PiActionGroup;
import org.onosproject.net.pi.runtime.PiActionGroupMember;
import org.onosproject.net.pi.runtime.PiCounterCellData;
import org.onosproject.net.pi.runtime.PiCounterCellId;
import org.onosproject.net.pi.runtime.PiPacketOperation;
import org.onosproject.net.pi.runtime.PiTableEntry;
import org.onosproject.net.pi.service.PiPipeconfService;
import org.onosproject.p4runtime.api.P4RuntimeClient;
import org.onosproject.p4runtime.api.P4RuntimeEvent;
import org.slf4j.Logger;
import p4.P4RuntimeGrpc;
import p4.P4RuntimeOuterClass.ActionProfileGroup;
import p4.P4RuntimeOuterClass.ActionProfileMember;
import p4.P4RuntimeOuterClass.Entity;
import p4.P4RuntimeOuterClass.ForwardingPipelineConfig;
import p4.P4RuntimeOuterClass.MasterArbitrationUpdate;
import p4.P4RuntimeOuterClass.PacketIn;
import p4.P4RuntimeOuterClass.ReadRequest;
import p4.P4RuntimeOuterClass.ReadResponse;
import p4.P4RuntimeOuterClass.SetForwardingPipelineConfigRequest;
import p4.P4RuntimeOuterClass.StreamMessageRequest;
import p4.P4RuntimeOuterClass.StreamMessageResponse;
import p4.P4RuntimeOuterClass.TableEntry;
import p4.P4RuntimeOuterClass.Uint128;
import p4.P4RuntimeOuterClass.Update;
import p4.P4RuntimeOuterClass.WriteRequest;
import p4.config.P4InfoOuterClass.P4Info;
import p4.tmp.P4Config;
import java.nio.ByteBuffer;
import java.util.Collection;
import java.util.Collections;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Set;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.Executor;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.locks.Lock;
import java.util.concurrent.locks.ReentrantLock;
import java.util.function.Supplier;
import java.util.stream.Collectors;
import java.util.stream.StreamSupport;
import static com.google.common.base.Preconditions.checkNotNull;
import static org.onlab.util.Tools.groupedThreads;
import static org.slf4j.LoggerFactory.getLogger;
import static p4.P4RuntimeOuterClass.Entity.EntityCase.ACTION_PROFILE_GROUP;
import static p4.P4RuntimeOuterClass.Entity.EntityCase.ACTION_PROFILE_MEMBER;
import static p4.P4RuntimeOuterClass.Entity.EntityCase.TABLE_ENTRY;
import static p4.P4RuntimeOuterClass.PacketOut;
import static p4.P4RuntimeOuterClass.SetForwardingPipelineConfigRequest.Action.VERIFY_AND_COMMIT;
/**
* Implementation of a P4Runtime client.
*/
public final class P4RuntimeClientImpl implements P4RuntimeClient {
private static final Map<WriteOperationType, Update.Type> UPDATE_TYPES = ImmutableMap.of(
WriteOperationType.UNSPECIFIED, Update.Type.UNSPECIFIED,
WriteOperationType.INSERT, Update.Type.INSERT,
WriteOperationType.MODIFY, Update.Type.MODIFY,
WriteOperationType.DELETE, Update.Type.DELETE
);
private final Logger log = getLogger(getClass());
private final DeviceId deviceId;
private final long p4DeviceId;
private final P4RuntimeControllerImpl controller;
private final P4RuntimeGrpc.P4RuntimeBlockingStub blockingStub;
private final Context.CancellableContext cancellableContext;
private final ExecutorService executorService;
private final Executor contextExecutor;
private final Lock writeLock = new ReentrantLock();
private final StreamObserver<StreamMessageRequest> streamRequestObserver;
private Map<Uint128, CompletableFuture<Boolean>> arbitrationUpdateMap = Maps.newConcurrentMap();
protected Uint128 p4RuntimeElectionId;
/**
* Default constructor.
*
* @param deviceId the ONOS device id
* @param p4DeviceId the P4 device id
* @param channel gRPC channel
* @param controller runtime client controller
*/
P4RuntimeClientImpl(DeviceId deviceId, long p4DeviceId, ManagedChannel channel,
P4RuntimeControllerImpl controller) {
this.deviceId = deviceId;
this.p4DeviceId = p4DeviceId;
this.controller = controller;
this.cancellableContext = Context.current().withCancellation();
this.executorService = Executors.newFixedThreadPool(15, groupedThreads(
"onos/p4runtime-client-" + deviceId.toString(),
deviceId.toString() + "-%d"));
this.contextExecutor = this.cancellableContext.fixedContextExecutor(executorService);
//TODO Investigate deadline or timeout in supplyInContext Method
this.blockingStub = P4RuntimeGrpc.newBlockingStub(channel);
P4RuntimeGrpc.P4RuntimeStub asyncStub = P4RuntimeGrpc.newStub(channel);
this.streamRequestObserver = asyncStub.streamChannel(new StreamChannelResponseObserver());
}
/**
* Executes the given task (supplier) in the gRPC context executor of this client, such that if the context is
* cancelled (e.g. client shutdown) the RPC is automatically cancelled.
* <p>
* Important: Tasks submitted in parallel by different threads are forced executed sequentially.
* <p>
*/
private <U> CompletableFuture<U> supplyInContext(Supplier<U> supplier, String opDescription) {
return CompletableFuture.supplyAsync(() -> {
// TODO: explore a more relaxed locking strategy.
writeLock.lock();
try {
return supplier.get();
} catch (StatusRuntimeException ex) {
logP4RuntimeErrorStatus(ex, opDescription);
throw ex;
} catch (Throwable ex) {
log.error("Exception in client of {}, executing {}", deviceId, opDescription, ex);
throw ex;
} finally {
writeLock.unlock();
}
}, contextExecutor);
}
private void logP4RuntimeErrorStatus(StatusRuntimeException ex, String description) {
String statusString = ex.getStatus().getDescription();
try {
com.google.rpc.Status status = com.google.rpc.Status.parseFrom(statusString.getBytes());
log.warn("{} failed on {} due to {}", description, deviceId, status.toString());
} catch (InvalidProtocolBufferException e) {
log.warn("{} failed on {} due to {}", description, deviceId, statusString);
} catch (NullPointerException e) {
log.warn("{} failed on {}", description, deviceId);
}
}
@Override
public CompletableFuture<Boolean> initStreamChannel() {
return supplyInContext(this::doInitStreamChannel, "initStreamChannel");
}
@Override
public CompletableFuture<Boolean> setPipelineConfig(PiPipeconf pipeconf, ByteBuffer deviceData) {
return supplyInContext(() -> doSetPipelineConfig(pipeconf, deviceData), "setPipelineConfig");
}
@Override
public CompletableFuture<Boolean> writeTableEntries(Collection<PiTableEntry> piTableEntries,
WriteOperationType opType, PiPipeconf pipeconf) {
return supplyInContext(() -> doWriteTableEntries(piTableEntries, opType, pipeconf),
"writeTableEntries-" + opType.name());
}
@Override
public CompletableFuture<Collection<PiTableEntry>> dumpTable(PiTableId piTableId, PiPipeconf pipeconf) {
return supplyInContext(() -> doDumpTable(piTableId, pipeconf), "dumpTable-" + piTableId);
}
@Override
public CompletableFuture<Boolean> packetOut(PiPacketOperation packet, PiPipeconf pipeconf) {
return supplyInContext(() -> doPacketOut(packet, pipeconf), "packetOut");
}
@Override
public CompletableFuture<Collection<PiCounterCellData>> readCounterCells(Set<PiCounterCellId> cellIds,
PiPipeconf pipeconf) {
return supplyInContext(() -> doReadCounterCells(cellIds, pipeconf),
"readCounterCells-" + cellIds.hashCode());
}
@Override
public CompletableFuture<Collection<PiCounterCellData>> readAllCounterCells(Set<PiCounterId> counterIds,
PiPipeconf pipeconf) {
/*
From p4runtime.proto, the scope of a ReadRequest is defined as follows:
CounterEntry:
- All counter cells for all meters if counter_id = 0 (default).
- All counter cells for given counter_id if index = 0 (default).
DirectCounterEntry:
- All counter cells for all meters if counter_id = 0 (default).
- All counter cells for given counter_id if table_entry.match is empty.
*/
Set<PiCounterCellId> cellIds = Sets.newHashSet();
for (PiCounterId counterId : counterIds) {
if (!pipeconf.pipelineModel().counter(counterId).isPresent()) {
log.warn("Unable to find counter '{}' in pipeline model", counterId);
continue;
}
PiCounterType counterType = pipeconf.pipelineModel().counter(counterId).get().counterType();
switch (counterType) {
case INDIRECT:
cellIds.add(PiCounterCellId.ofIndirect(counterId, 0));
break;
case DIRECT:
cellIds.add(PiCounterCellId.ofDirect(counterId, PiTableEntry.EMTPY));
break;
default:
log.warn("Unrecognized PI counter type '{}'", counterType);
}
}
return supplyInContext(() -> doReadCounterCells(cellIds, pipeconf),
"readAllCounterCells-" + cellIds.hashCode());
}
@Override
public CompletableFuture<Boolean> writeActionGroupMembers(PiActionGroup group,
WriteOperationType opType,
PiPipeconf pipeconf) {
return supplyInContext(() -> doWriteActionGroupMembers(group, opType, pipeconf),
"writeActionGroupMembers-" + opType.name());
}
@Override
public CompletableFuture<Boolean> writeActionGroup(PiActionGroup group,
WriteOperationType opType,
PiPipeconf pipeconf) {
return supplyInContext(() -> doWriteActionGroup(group, opType, pipeconf),
"writeActionGroup-" + opType.name());
}
@Override
public CompletableFuture<Collection<PiActionGroup>> dumpGroups(PiActionProfileId actionProfileId,
PiPipeconf pipeconf) {
return supplyInContext(() -> doDumpGroups(actionProfileId, pipeconf),
"dumpGroups-" + actionProfileId.id());
}
@Override
public CompletableFuture<Boolean> sendMasterArbitrationUpdate() {
return supplyInContext(this::doArbitrationUpdate, "arbitrationUpdate");
}
/* Blocking method implementations below */
private boolean doArbitrationUpdate() {
CompletableFuture<Boolean> result = new CompletableFuture<>();
// TODO: currently we use 64-bit Long type for election id, should
// we use 128-bit ?
long nextElectId = controller.getNewMasterElectionId();
Uint128 newElectionId = Uint128.newBuilder()
.setLow(nextElectId)
.build();
MasterArbitrationUpdate arbitrationUpdate = MasterArbitrationUpdate.newBuilder()
.setDeviceId(p4DeviceId)
.setElectionId(newElectionId)
.build();
StreamMessageRequest requestMsg = StreamMessageRequest.newBuilder()
.setArbitration(arbitrationUpdate)
.build();
log.debug("Sending arbitration update to {} with election id {}...",
deviceId, newElectionId);
arbitrationUpdateMap.put(newElectionId, result);
try {
streamRequestObserver.onNext(requestMsg);
return result.get();
} catch (StatusRuntimeException e) {
logP4RuntimeErrorStatus(e, "Arbitration update");
arbitrationUpdateMap.remove(newElectionId);
return false;
} catch (InterruptedException | ExecutionException e) {
log.warn("Arbitration update failed for {} due to {}", deviceId, e);
arbitrationUpdateMap.remove(newElectionId);
return false;
}
}
private boolean doInitStreamChannel() {
// To listen for packets and other events, we need to start the RPC.
// Here we do it by sending a master arbitration update.
return doArbitrationUpdate();
}
private boolean doSetPipelineConfig(PiPipeconf pipeconf, ByteBuffer deviceData) {
log.info("Setting pipeline config for {} to {}...", deviceId, pipeconf.id());
checkNotNull(deviceData, "deviceData cannot be null");
P4Info p4Info = PipeconfHelper.getP4Info(pipeconf);
if (p4Info == null) {
// Problem logged by PipeconfHelper.
return false;
}
P4Config.P4DeviceConfig p4DeviceConfigMsg = P4Config.P4DeviceConfig
.newBuilder()
.setExtras(P4Config.P4DeviceConfig.Extras.getDefaultInstance())
.setReassign(true)
.setDeviceData(ByteString.copyFrom(deviceData))
.build();
ForwardingPipelineConfig pipelineConfig = ForwardingPipelineConfig
.newBuilder()
.setP4Info(p4Info)
.setP4DeviceConfig(p4DeviceConfigMsg.toByteString())
.build();
SetForwardingPipelineConfigRequest request = SetForwardingPipelineConfigRequest
.newBuilder()
.setDeviceId(p4DeviceId)
.setElectionId(p4RuntimeElectionId)
.setAction(VERIFY_AND_COMMIT)
.setConfig(pipelineConfig)
.build();
try {
this.blockingStub.setForwardingPipelineConfig(request);
return true;
} catch (StatusRuntimeException ex) {
logP4RuntimeErrorStatus(ex, "Set pipeline config");
return false;
}
}
private boolean doWriteTableEntries(Collection<PiTableEntry> piTableEntries, WriteOperationType opType,
PiPipeconf pipeconf) {
WriteRequest.Builder writeRequestBuilder = WriteRequest.newBuilder();
Collection<Update> updateMsgs = TableEntryEncoder.encode(piTableEntries, pipeconf)
.stream()
.map(tableEntryMsg ->
Update.newBuilder()
.setEntity(Entity.newBuilder()
.setTableEntry(tableEntryMsg)
.build())
.setType(UPDATE_TYPES.get(opType))
.build())
.collect(Collectors.toList());
if (updateMsgs.size() == 0) {
return true;
}
writeRequestBuilder
.setDeviceId(p4DeviceId)
.setElectionId(p4RuntimeElectionId)
.addAllUpdates(updateMsgs)
.build();
try {
blockingStub.write(writeRequestBuilder.build());
return true;
} catch (StatusRuntimeException e) {
logP4RuntimeErrorStatus(e, "Write table entries");
return false;
}
}
private Collection<PiTableEntry> doDumpTable(PiTableId piTableId, PiPipeconf pipeconf) {
log.debug("Dumping table {} from {} (pipeconf {})...", piTableId, deviceId, pipeconf.id());
P4InfoBrowser browser = PipeconfHelper.getP4InfoBrowser(pipeconf);
int tableId;
try {
tableId = browser.tables().getByName(piTableId.id()).getPreamble().getId();
} catch (P4InfoBrowser.NotFoundException e) {
log.warn("Unable to dump table: {}", e.getMessage());
return Collections.emptyList();
}
ReadRequest requestMsg = ReadRequest.newBuilder()
.setDeviceId(p4DeviceId)
.addEntities(Entity.newBuilder()
.setTableEntry(TableEntry.newBuilder()
.setTableId(tableId)
.build())
.build())
.build();
Iterator<ReadResponse> responses;
try {
responses = blockingStub.read(requestMsg);
} catch (StatusRuntimeException e) {
logP4RuntimeErrorStatus(e, "Dump table");
return Collections.emptyList();
}
Iterable<ReadResponse> responseIterable = () -> responses;
List<TableEntry> tableEntryMsgs = StreamSupport
.stream(responseIterable.spliterator(), false)
.map(ReadResponse::getEntitiesList)
.flatMap(List::stream)
.filter(entity -> entity.getEntityCase() == TABLE_ENTRY)
.map(Entity::getTableEntry)
.collect(Collectors.toList());
log.debug("Retrieved {} entries from table {} on {}...", tableEntryMsgs.size(), piTableId, deviceId);
return TableEntryEncoder.decode(tableEntryMsgs, pipeconf);
}
private boolean doPacketOut(PiPacketOperation packet, PiPipeconf pipeconf) {
try {
//encode the PiPacketOperation into a PacketOut
PacketOut packetOut = PacketIOCodec.encodePacketOut(packet, pipeconf);
//Build the request
StreamMessageRequest packetOutRequest = StreamMessageRequest
.newBuilder().setPacket(packetOut).build();
//Send the request
streamRequestObserver.onNext(packetOutRequest);
} catch (P4InfoBrowser.NotFoundException e) {
log.error("Cant find expected metadata in p4Info file. {}", e.getMessage());
log.debug("Exception", e);
return false;
}
return true;
}
private void doPacketIn(PacketIn packetInMsg) {
// Retrieve the pipeconf for this client's device.
PiPipeconfService pipeconfService = DefaultServiceDirectory.getService(PiPipeconfService.class);
if (pipeconfService == null) {
throw new IllegalStateException("PiPipeconfService is null. Can't handle packet in.");
}
final PiPipeconf pipeconf;
if (pipeconfService.ofDevice(deviceId).isPresent() &&
pipeconfService.getPipeconf(pipeconfService.ofDevice(deviceId).get()).isPresent()) {
pipeconf = pipeconfService.getPipeconf(pipeconfService.ofDevice(deviceId).get()).get();
} else {
log.warn("Unable to get pipeconf of {}. Can't handle packet in", deviceId);
return;
}
// Decode packet message and post event.
PiPacketOperation packetOperation = PacketIOCodec.decodePacketIn(packetInMsg, pipeconf, deviceId);
DefaultPacketIn packetInEventSubject = new DefaultPacketIn(deviceId, packetOperation);
P4RuntimeEvent event = new P4RuntimeEvent(P4RuntimeEvent.Type.PACKET_IN, packetInEventSubject);
log.debug("Received packet in: {}", event);
controller.postEvent(event);
}
private void doArbitrationUpdateFromDevice(MasterArbitrationUpdate arbitrationMsg) {
log.debug("Received arbitration update from {}: {}", deviceId, arbitrationMsg);
Uint128 electionId = arbitrationMsg.getElectionId();
CompletableFuture<Boolean> mastershipFeature = arbitrationUpdateMap.remove(electionId);
if (mastershipFeature == null) {
log.warn("Can't find completable future of election id {}", electionId);
return;
}
this.p4RuntimeElectionId = electionId;
int statusCode = arbitrationMsg.getStatus().getCode();
MastershipRole arbitrationRole;
// arbitration update success
if (statusCode == Status.OK.getCode().value()) {
mastershipFeature.complete(true);
arbitrationRole = MastershipRole.MASTER;
} else {
mastershipFeature.complete(false);
arbitrationRole = MastershipRole.STANDBY;
}
DefaultArbitration arbitrationEventSubject = new DefaultArbitration(arbitrationRole, electionId);
P4RuntimeEvent event = new P4RuntimeEvent(P4RuntimeEvent.Type.ARBITRATION,
arbitrationEventSubject);
controller.postEvent(event);
}
private Collection<PiCounterCellData> doReadCounterCells(Collection<PiCounterCellId> cellIds, PiPipeconf pipeconf) {
// We use this map to remember the original PI counter IDs of the returned response.
final Map<Integer, PiCounterId> counterIdMap = Maps.newHashMap();
final ReadRequest request = ReadRequest.newBuilder()
.setDeviceId(p4DeviceId)
.addAllEntities(CounterEntryCodec.encodePiCounterCellIds(cellIds, counterIdMap, pipeconf))
.build();
if (request.getEntitiesList().size() == 0) {
return Collections.emptyList();
}
final Iterable<ReadResponse> responses;
try {
responses = () -> blockingStub.read(request);
} catch (StatusRuntimeException e) {
logP4RuntimeErrorStatus(e, "Read counter");
return Collections.emptyList();
}
List<Entity> entities = StreamSupport.stream(responses.spliterator(), false)
.map(ReadResponse::getEntitiesList)
.flatMap(List::stream)
.collect(Collectors.toList());
return CounterEntryCodec.decodeCounterEntities(entities, counterIdMap, pipeconf);
}
private boolean doWriteActionGroupMembers(PiActionGroup group, WriteOperationType opType, PiPipeconf pipeconf) {
final Collection<ActionProfileMember> actionProfileMembers = Lists.newArrayList();
try {
for (PiActionGroupMember member : group.members()) {
actionProfileMembers.add(ActionProfileMemberEncoder.encode(group, member, pipeconf));
}
} catch (EncodeException | P4InfoBrowser.NotFoundException e) {
log.warn("Unable to write ({}) group members: {}", opType, e.getMessage());
return false;
}
final Collection<Update> updateMsgs = actionProfileMembers.stream()
.map(actionProfileMember ->
Update.newBuilder()
.setEntity(Entity.newBuilder()
.setActionProfileMember(actionProfileMember)
.build())
.setType(UPDATE_TYPES.get(opType))
.build())
.collect(Collectors.toList());
if (updateMsgs.size() == 0) {
// Nothing to update.
return true;
}
WriteRequest writeRequestMsg = WriteRequest.newBuilder()
.setDeviceId(p4DeviceId)
.setElectionId(p4RuntimeElectionId)
.addAllUpdates(updateMsgs)
.build();
try {
blockingStub.write(writeRequestMsg);
return true;
} catch (StatusRuntimeException e) {
logP4RuntimeErrorStatus(e, String.format("%s group members", opType));
return false;
}
}
private Collection<PiActionGroup> doDumpGroups(PiActionProfileId piActionProfileId, PiPipeconf pipeconf) {
log.debug("Dumping groups from action profile {} from {} (pipeconf {})...",
piActionProfileId.id(), deviceId, pipeconf.id());
final P4InfoBrowser browser = PipeconfHelper.getP4InfoBrowser(pipeconf);
if (browser == null) {
log.warn("Unable to get a P4Info browser for pipeconf {}, aborting dump action profile", pipeconf);
return Collections.emptySet();
}
final int actionProfileId;
try {
actionProfileId = browser
.actionProfiles()
.getByName(piActionProfileId.id())
.getPreamble()
.getId();
} catch (P4InfoBrowser.NotFoundException e) {
log.warn("Unable to dump groups: {}", e.getMessage());
return Collections.emptySet();
}
// Prepare read request to read all groups from the given action profile.
final ReadRequest groupRequestMsg = ReadRequest.newBuilder()
.setDeviceId(p4DeviceId)
.addEntities(Entity.newBuilder()
.setActionProfileGroup(
ActionProfileGroup.newBuilder()
.setActionProfileId(actionProfileId)
.build())
.build())
.build();
// Read groups.
final Iterator<ReadResponse> groupResponses;
try {
groupResponses = blockingStub.read(groupRequestMsg);
} catch (StatusRuntimeException e) {
logP4RuntimeErrorStatus(e, String.format("Dump group from action profile %s",
piActionProfileId.id()));
return Collections.emptySet();
}
final List<ActionProfileGroup> groupMsgs = Tools.stream(() -> groupResponses)
.map(ReadResponse::getEntitiesList)
.flatMap(List::stream)
.filter(entity -> entity.getEntityCase() == ACTION_PROFILE_GROUP)
.map(Entity::getActionProfileGroup)
.collect(Collectors.toList());
log.debug("Retrieved {} groups from action profile {} on {}...",
groupMsgs.size(), piActionProfileId.id(), deviceId);
// Returned groups contain only a minimal description of their members.
// We need to issue a new request to get the full description of each member.
// Keep a map of all member IDs for each group ID, will need it later.
final Multimap<Integer, Integer> groupIdToMemberIdsMap = HashMultimap.create();
groupMsgs.forEach(g -> groupIdToMemberIdsMap.putAll(
g.getGroupId(),
g.getMembersList().stream()
.map(ActionProfileGroup.Member::getMemberId)
.collect(Collectors.toList())));
// Prepare one big read request to read all members in one shot.
final Set<Entity> entityMsgs = groupMsgs.stream()
.flatMap(g -> g.getMembersList().stream())
.map(ActionProfileGroup.Member::getMemberId)
// Prevent issuing many read requests for the same member.
.distinct()
.map(id -> ActionProfileMember.newBuilder()
.setActionProfileId(actionProfileId)
.setMemberId(id)
.build())
.map(m -> Entity.newBuilder()
.setActionProfileMember(m)
.build())
.collect(Collectors.toSet());
final ReadRequest memberRequestMsg = ReadRequest.newBuilder().setDeviceId(p4DeviceId)
.addAllEntities(entityMsgs)
.build();
// Read members.
final Iterator<ReadResponse> memberResponses;
try {
memberResponses = blockingStub.read(memberRequestMsg);
} catch (StatusRuntimeException e) {
logP4RuntimeErrorStatus(e, String.format("Read members from action profile %s",
piActionProfileId.id()));
return Collections.emptyList();
}
final Multimap<Integer, ActionProfileMember> groupIdToMembersMap = HashMultimap.create();
Tools.stream(() -> memberResponses)
.map(ReadResponse::getEntitiesList)
.flatMap(List::stream)
.filter(e -> e.getEntityCase() == ACTION_PROFILE_MEMBER)
.map(Entity::getActionProfileMember)
.forEach(member -> groupIdToMemberIdsMap.asMap()
// Get all group IDs that contain this member.
.entrySet()
.stream()
.filter(entry -> entry.getValue().contains(member.getMemberId()))
.map(Map.Entry::getKey)
.forEach(gid -> groupIdToMembersMap.put(gid, member)));
log.debug("Retrieved {} group members from action profile {} on {}...",
groupIdToMembersMap.size(), piActionProfileId.id(), deviceId);
return groupMsgs.stream()
.map(groupMsg -> {
try {
return ActionProfileGroupEncoder.decode(groupMsg,
groupIdToMembersMap.get(groupMsg.getGroupId()),
pipeconf);
} catch (P4InfoBrowser.NotFoundException | EncodeException e) {
log.warn("Unable to decode group: {}\n {}", e.getMessage(), groupMsg);
return null;
}
})
.filter(Objects::nonNull)
.collect(Collectors.toList());
}
private boolean doWriteActionGroup(PiActionGroup group, WriteOperationType opType, PiPipeconf pipeconf) {
final ActionProfileGroup actionProfileGroup;
try {
actionProfileGroup = ActionProfileGroupEncoder.encode(group, pipeconf);
} catch (EncodeException | P4InfoBrowser.NotFoundException e) {
log.warn("Unable to encode group: {}", e.getMessage());
return false;
}
final WriteRequest writeRequestMsg = WriteRequest.newBuilder()
.setDeviceId(p4DeviceId)
.setElectionId(p4RuntimeElectionId)
.addUpdates(Update.newBuilder()
.setEntity(Entity.newBuilder()
.setActionProfileGroup(actionProfileGroup)
.build())
.setType(UPDATE_TYPES.get(opType))
.build())
.build();
try {
blockingStub.write(writeRequestMsg);
return true;
} catch (StatusRuntimeException e) {
logP4RuntimeErrorStatus(e, String.format("%s group", opType));
return false;
}
}
/**
* Returns the internal P4 device ID associated with this client.
*
* @return P4 device ID
*/
public long p4DeviceId() {
return p4DeviceId;
}
/**
* For testing purpose only. TODO: remove before release.
*
* @return blocking stub
*/
public P4RuntimeGrpc.P4RuntimeBlockingStub blockingStub() {
return this.blockingStub;
}
@Override
public void shutdown() {
log.info("Shutting down client for {}...", deviceId);
writeLock.lock();
try {
if (streamRequestObserver != null) {
streamRequestObserver.onCompleted();
cancellableContext.cancel(new InterruptedException("Requested client shutdown"));
}
this.executorService.shutdown();
try {
executorService.awaitTermination(5, TimeUnit.SECONDS);
} catch (InterruptedException e) {
log.warn("Executor service didn't shutdown in time.");
Thread.currentThread().interrupt();
}
} finally {
writeLock.unlock();
}
}
/**
* Handles messages received from the device on the stream channel.
*/
private class StreamChannelResponseObserver implements StreamObserver<StreamMessageResponse> {
@Override
public void onNext(StreamMessageResponse message) {
executorService.submit(() -> doNext(message));
}
private void doNext(StreamMessageResponse message) {
try {
log.debug("Received message on stream channel from {}: {}", deviceId, message.getUpdateCase());
switch (message.getUpdateCase()) {
case PACKET:
// Packet-in
doPacketIn(message.getPacket());
return;
case ARBITRATION:
doArbitrationUpdateFromDevice(message.getArbitration());
return;
default:
log.warn("Unrecognized stream message from {}: {}", deviceId, message.getUpdateCase());
}
} catch (Throwable ex) {
log.error("Exception while processing stream channel message from {}", deviceId, ex);
}
}
@Override
public void onError(Throwable throwable) {
log.warn("Error on stream channel for {}: {}", deviceId, Status.fromThrowable(throwable));
// FIXME: we might want to recreate the channel.
// In general, we want to be robust against any transient error and, if the channel is open, make sure the
// stream channel is always on.
}
@Override
public void onCompleted() {
log.warn("Stream channel for {} has completed", deviceId);
// FIXME: same concern as before.
}
}
}