OpenSM Parameters Change and Required Action

Version 3

    When changing one of the OpenSM parameters on production network, we need to either perform heavy sweep (HUP), or reset the openSM daemon. Signaling the SM and triggering heavy sweep is a much “lighter” operation than restarting the SM.

    When restarting OpenSM, all ports need to rejoin multicast groups, and resend path record queries. In addition, all multicast trees are rerouted, which might break multicast traffic, and in addition, OpenSM needs to recalculate unicast routing table.

    The below table provides all OpenSM parameters with the required change operation.

     

    References

     

    Configuration

    To perform HUP after a parameter change, run the following command:

    # kill -s HUP <pidof opensm>

     

     

    OpenSM Parameters

     

    Parameter

    Change Action

    guid

    Restart

    m_key

    HUP

    sm_key

    HUP

    sa_key

    HUP

    subnet_prefix

    Restart

    m_key_lease_period

    HUP

    m_key_protection_level

    HUP

    m_key_lookup

    HUP

    sweep_interval

    HUP

    max_wire_smps

    HUP

    max_wire_smps2

    HUP

    max_smps_timeout

    HUP

    max_sa_reports_queued

    HUP

    max_sa_reports_on_wire

    HUP

    console

    Restart

    console_port

    Restart

    transaction_timeout

    Restart

    transaction_retries

    Restart

    max_msg_fifo_timeout

    HUP

    sm_priority

    HUP

    master_sm_priority

    Restart

    lmc

    Restart

    lmc_esp0

    Restart

    max_op_vls

    HUP

    max_neighbor_mtu

    Restart

    force_link_speed

    HUP

    force_link_speed_ext

    HUP

    fdr10

    HUP

    support_mepi_speeds

    HUP

    mepi_enabled_speeds

    HUP

    reassign_lids

    HUP

    ignore_other_sm

    HUP

    single_thread

    Restart

    disable_multicast

    HUP

    subnet_timeout

    HUP

    packet_life_time

    HUP

    vl_stall_count

    HUP

    leaf_vl_stall_count

    HUP

    head_of_queue_lifetime

    HUP

    leaf_head_of_queue_lifetime

    HUP

    local_phy_errors_threshold

    HUP

    overrun_errors_threshold

    HUP

    use_mfttop

    HUP

    sminfo_polling_timeout

    HUP

    polling_retry_number

    HUP

    force_heavy_sweep

    HUP

    port_prof_ignore_file

    Restart

    hop_weights_file

    Restart

    dimn_ports_file

    Restart

    port_search_ordering_file

    Restart

    port_profile_switch_nodes

    HUP

    sweep_on_trap

    HUP

    routing_engine

    HUP

    connect_roots

    HUP

    calculate_missing_routes

    HUP

    use_ucast_cache

    Restart

    log_file

    Restart

    log_max_size

    HUP

    log_flags

    HUP

    force_log_flush

    HUP

    accum_log_file

    HUP

    partition_config_file

    Restart

    no_partition_enforcement

    HUP

    part_enforce

    HUP

    allow_both_pkeys

    Restart

    sm_assigned_guid

    HUP

    qos

    HUP

    qos_policy_file

    Restart

    suppress_sl2vl_mad_status_errors

    HUP

    override_create_mcg_sl

    HUP

    dump_files_dir

    Restart

    lid_matrix_dump_file

    Restart

    lfts_file

    Restart

    root_guid_file

    Restart

    pgrp_policy_file

    Restart

    topo_policy_file

    Restart

    rch_policy_file

    Restart

    ftree_ca_order_dump_file

    Restart

    held_back_sw_file

    Restart

    cn_guid_file

    Restart

    io_guid_file

    Restart

    port_shifting

    HUP

    scatter_ports

    HUP

    updn_lid_tracking_mode

    HUP

    multicast_optimization

    Restart

    max_seq_redisc

    HUP

    rereg_on_guid_migr

    Restart

    aguid_inout_notice

    HUP

    sm_assign_guid_func

    HUP

    mc_primary_root_guid

    HUP

    mc_secondary_root_guid

    HUP

    mc_roots_file

    Restart

    max_reverse_hops

    HUP

    routing_threads_num

    HUP

    max_threads_per_core

    HUP

    ids_guid_file

    Restart

    guid_routing_order_file

    Restart

    guid_routing_order_no_scatter

    HUP

    use_scatter_for_switch_lid

    HUP

    pqft_structure

    Restart

    sa_db_file

    Restart

    sa_db_dump

    HUP

    sm_db_dump

    HUP

    torus_config

    HUP

    do_mesh_analysis

    HUP

    exit_on_fatal

    HUP

    honor_guid2lid_file

    HUP

    daemon

    Restart

    sm_inactive

    HUP

    babbling_port_policy

    HUP

    drop_subscr_on_report_fail

    HUP

    drop_event_subscriptions

    HUP

    ipoib_mcgroup_creation_validation

    HUP

    mcgroup_join_validation

    HUP

    reports

    HUP

    use_optimized_slvl

    HUP

    fsync_high_avail_files

    HUP

    default_mcg_mtu

    HUP

    default_mcg_rate

    HUP