Some of the content described in this article is available in meshIQ Manage versions 11.1.1 and later.
For a quick overview of what's new or changed, visit the meshIQ Highlights page for a version-by-version breakdown.  

Jump to Section:
Version 12.x and Later
Version 11.3 and Earlier

Version 12.x and Later

You can make a new Kafka topic from the Kafka Widget in two ways:

• Click on a topic, then go to the Selected menu and choose Create Topic.
• Click the Add Kafka Topic button in the Topic widget. 

1. If you clicked the Add Kafka Topic button, the Select object path dialog opens.  
   
2. Specify the following items:
   • Workgroup server
   • Node
   • Cluster
3. Click Select path to open the Kafka Topic Create Window.
   
4. Fill in the topic properties. Topic Name is a required field.
   The Configuration tab is empty during topic creation but becomes populated and editable after the topic is created (see the editing instructions below).
   You can also create your own properties on the Custom Attributes tab.  
5. Click Ok to create the topic. 
   For details on the properties available after creation, see Edit a Kafka Topic below.

Edit a Kafka Topic

To edit a Kafka topic:

1. Select the checkbox for the topic, then choose Properties... from the Selected menu.
   The Kafka Topic Properties dialog opens.
   The following additional fields are available:

• Is Internal

• Preferred Leader Replicas

• Replicas Not in Sync

• Consumer Groups

• Compression Type

• Minimum In-sync Replicas

• Cleanup Policy

• Bytes per Segment

• Retention (ms)

• Max Message Size (bytes)

• Unclean Leader Election

• Retention (bytes)

  For more information about these properties, see Kafka Topic field descriptions.
  

2. Make your changes on the General tab.
   If you choose to increase the number of partitions, you will not be able to roll back the change later, since decreases in the number of partitions are not permitted. 
   When browsing partitions from a topic, both the System and Empty checkboxes are selected by default in the Partitions widget to display all partitions, including empty ones.
3. On the Configuration tab, properties are now available for editing.
   Use the Configuration Entry (Filter by key) and Value (Filter by value) filters to locate the configuration you want to update.
   Replace the existing values with the new ones to make your changes.
   
4. Click Ok to save your changes.

_________________________________________________________________________________________________________________

Version 11.3 and Earlier

You can create a Kafka topic from a topic viewlet in one of two ways:

• Select Create Topic from the Action menu (called the Selected menu in 11.2), when a topic is selected in a Topic viewlet.
• Click the Add button for a Topic viewlet. 

1. If you clicked the Add button, the Select object path window opens.  
   
2. Specify the following items:
   • Workgroup server
   • Node
   • Cluster
3. Click Select path to open the Kafka Topic Create window.
   
4. Fill in the topic properties (Topic Name is a required field). The Configuration tab is empty during the create process, but is filled in and can be edited when the topic has been created (see the editing instructions below). You can also create your own properties on the Custom Attributes tab.  
5. Click OK to create the topic. See Edit a Kafka topic below for information about properties that become available once a new Kafka topic is being edited.
    

Edit a Kafka topic

To edit a Kafka topic:

1. Select the checkbox for the topic and select Properties... from the action menu (Selected menu in 11.2). The Kafka Topic Properties dialog opens. The following additional fields are now present: Is Internal, Preferred Leader Replicas, Replicas not in sync, Consumer Groups, Compression Type, Minimum In-sync Replicas, Cleanup Policy, Bytes per Segment, Retention (ms), Max Message Size (bytes), Unclean Leader Election, Retention (bytes). Refer to Kafka Topic field descriptions for more information.
   
2. Make your changes on the General tab. If you choose to increase the number of partitions, you will not be able to roll back the change later, since decreases in the number of partitions are not permitted. When browsing partitions from a topic, both the System and the Empty checkboxes are selected on the Partitions viewlet, so that all partitions are displayed, and empty ones are included.
3. On the Configuration tab, properties are now available for editing. Use the Configuration Entry (Filter by key) and Value (Filter by value) filters to find the configuration entry you want to update. Make your changes by replacing the existing values with new values.
   
4. Click OK to save your changes.