IPQoS Administration Guide

Activating an IPQoS Configuration

You activate and otherwise manipulate the IPQoS configuration by using the ipqosconf command.

How to Apply a New Configuration to the IPQoS Kernel Modules

You use the ipqosconf tool to read the IPQoS configuration file and configure the IPQoS modules in the UNIX kernel. The next procedure uses as an example the file /var/ipqos/Goldweb.qos, which is created in Creating IPQoS Configuration Files for Web Servers. For detailed information, refer to the ipqosconf(1m) man page.

  1. Become superuser on the IPQoS-enabled system.

  2. Apply the new configuration.


    # /usr/sbin/ipqosconf -a /var/ipqos/Goldweb.qos
    

    ipqosconf writes the information in the specified IPQoS configuration file into the IPQoS modules in the Solaris kernel. In the previous example, the contents of /var/ipqos/Goldweb.qos are applied to the current Solaris kernel.


    Note –

    When you apply an IPQoS configuration file with the -a option, the actions in the file are active for the current session only.


  3. Test and debug the new IPQoS configuration.

    Use UNIX utilities to track IPQoS behavior and gather statistics on your IPQoS implementation. Thus, you can determine if the configuration operates as you expected.

Where to Go From Here

Task 

For Instructions 

View statistics on how the IPQoS modules are working  

Gathering Statistical Information

Log ipqosconf messages

Enabling syslog Logging for IPQoS Messages

Ensure that the current IPQoS configuration is applied after each boot 

How to Ensure That the IPQoS Configuration Is Applied After Each Reboot

How to Ensure That the IPQoS Configuration Is Applied After Each Reboot

You must explicitly make an IPQoS configuration persistent across reboots. Otherwise, the current configuration applies only until the system reboots. When IPQoS works correctly on a system, do the following to make the configuration persistent across reboots.

  1. Log in as superuser to the IPQoS-enabled system.

  2. Test for the existence of an IPQoS configuration in the kernel modules:


    # ipqosconf -l
    

    If a configuration already exists, ipqosconf displays it on the screen. If you do not receive output, apply the configuration, as explained inHow to Apply a New Configuration to the IPQoS Kernel Modules.

  3. Ensure that the existing IPQoS configuration is applied every time the IPQoS system reboots.


    # /usr/sbin/ipqosconf -c 
    

    The -c option causes the current IPQoS configuration to be represented in the boot-time configuration file /etc/inet/ipqosinit.conf.