How to Create the IPQoS Configuration File and Define Traffic Classes

The IPQoS configuration file must be copied to /etc/inet/ipqosinit.conf when you are ready to employ it. If you are starting with a new installation it may be easier to edit your draft configuration file in the place that it will be used. This procedure builds the initial segment of the IPQoS configuration file that is introduced in Example 3–1.

1. Become an administrator.

   For more information, see Using Your Assigned Administrative Rights in Securing Users and Processes in Oracle Solaris 11.2 .

2. Log in to the premium web server.
3. Edit /etc/inet/ipqosinit.conf.
4. As the first uncommented line, insert the version number fmt_version 1.0.

   Every IPQoS configuration file must start with this line.

5. Insert the initial action statement, which configures the generic IP classifier ipgpc.

   This initial action begins the tree of action statements that compose the IPQoS configuration file. For example, the configuration file begins with the initial action statement to call the ipgpc classifier.

   fmt_version 1.0
   
   action {
       module ipgpc
       name ipgpc.classify

   fmt_version 1.0

   Begins the IPQoS configuration file.

   action {

   Begins the action statement.

   module ipgpc

   Configures the ipgpc classifier as the first action in the configuration file.

   name ipgpc.classify

   Defines the name of the classifier action statement, which must always be ipgpc.classify.

   For detailed syntactical information about action statements, refer to action Statement and the ipqosconf(1M) man page.

6. Add a params clause with the statistics parameter global_stats.

   params {
             global_stats TRUE
      }

   The parameter global_stats TRUE in theipgpc.classify statement enables statistics gathering for that action. global_stats TRUE also enables per-class statistics gathering wherever a class clause definition specifies enable_stats TRUE.

   Enabling statistics impacts performance. You might want to gather statistics on a new IPQoS configuration file to verify that IPQoS works properly. Later, you can disable statistics collection by changing the argument to global_stats to FALSE.

   Global statistics are only one type of parameter you can define in a params clause. For syntactical and other details about params clauses, refer to params Clause and the ipqosconf(1M) man page.

7. Define a class that identifies traffic that is bound for the premium server.

   class { 
           name goldweb 
           next_action markAF11   
           enable_stats FALSE 
       }

   This statement is called a class clause. This class clause has the following contents.

   name goldweb

   Creates the class goldweb to identify traffic that is bound for the Goldweb server.

   next_action markAF11

   Instructs the ipgpc module to pass packets of the goldweb class to the markAF11 action statement. The markAF11 action statement calls the dscpmk marker.

   enable_stats FALSE

   Enables statistics taking for the goldweb class. However, because the value of enable_stats is FALSE, statistics for this class are disabled.

   For detailed information about the syntax of the class clause, see class Clause and the ipqosconf(1M) man page.

8. Define a class that identifies an application that must have highest-priority forwarding.

   class {
           name video
           next_action markEF
           enable_stats FALSE
       }

   name video

   Creates the class video to identify streaming video traffic that is outgoing from the Goldweb server.

   next_action markEF

   Instructs the ipgpc module to pass packets of the video class to the markEF statement after ipgpc completes processing. The markEF statement calls the dscpmk marker.

   enable_stats FALSE

   Enables statistics collection for the video class. However, because the value of enable_stats is FALSE, statistics collection for this class is disabled.

9. Save changes to the /etc/inet/ipqosinit.conf file.
   • If you are done making changes, start the ipqos service.

     See How to Start the ipqos Service for specific instructions about starting or restarting the service.

   • If you want to continue making changes in the IPQoS configuration file, choose another task.

     See General IPQoS Configuration Planning Task Map for a list of additional changes that might be needed.