com-eng_user_manual by xz1011

VIEWS: 1 PAGES: 21

									  GIGABYTE UNITED INC.
                         Gigabyte United Inc.            TEL (02).8912-4888
                         No.6, Bau Chiang Rd.            EXT 1942
                         Hsin-Tien, Taipei 231, Taiwan   AUTHOR LI-TE LIN




COM Version 1

  Installation User Manual (English)




  Write By: LI-TE LIN
  Verify By: CHUN-YEN YANG
VER             DESCRIPTION                WRITE BY      DATE
1.0                 Create                  L.T. LIN   2006/09/28
2.0   Instruction for SNMP and LM_SENSOR    L.T. LIN   2006/12/25
3.0        Create English user manual       L.T. LIN   2007/01/09
                       .
                       .
                       .
INDEX                  .
                       .
                       .
CHAPTER 1 - ENVIRONMENT.                           1
                       .
HARDWARE
                       .                           1
SOFTWARE REQUIREMENT                               1
SPACE REQUIREMENT                                  2

CHAPTER 2 - INSTALLATION NOTE                      3

FEDORA CORE 5 (DVD)                                 3
COMMAND FOR MOUNTING/UNMOUNT DVD                    3
JAVA RUNTIME ENVIRONMENT (JRE)                      4
DOWNLOAD                                            4
INSTALL THE LINUX RPM (SELF-EXTRACTING) FILE        4
ENABLE AND CONFIGURE(FIREFOX 1.5 AND LATER)         6
HARDWARE SENSOR                                     6
INSTALL THE LM_SENSOR RPM(FEDORA CORE 5 DVD)        7
SCANNING HARDWARE MONITOR CHIP                      7
CONFIGURE LM_SENSOR.CONF                           10
SNMPD                                              12
INSTALL THE SNMPD RPM(FEDORA CORE 5 DVD)           12
CONFIGURE SNMPD.CONF                               13
COM-V1 RPM                                         14
CONFIGURE GBCCD.CONF                               16
INSTALL LOCATION                                   16

CHAPTER 3 - TEST & VERIFY                          18




                                               2
COM Version 1
Installation User Manual (Englsih)

CHAPTER 1 - Environment

         This chapter descripts Linux distributor and release version, hardware and
         software information for our testing environment. You can follow our instruction to
         build Linux server.

Hardware

         This table shows hardware information for our testing environment and running
         our COM daemon on the 32-bit platform.

      Motherboard ID                                         GA-8I915G-MF
      Processor Brand                                            Intel(R)
      Processor Speed                                           3.00 GHZ
      System Memory (RAM)                                        512 MB
      Hard Drive Type                                       IDE (7200 RPM)
      Hard Drive Size                                            80 GB
      Graphic Card                                          GV-NX62TC256D
      DVD-ROM                                                     Yes

                      Table 1. Hardware Information




Software Requirement

         In this manual, we use Fedora Core 5 as our server operating system. Fedora
         Core divides included software into package groups that make software selection
         easier. The Table 3 is a list for network server, such as FTP Web server and
         Samba suit of services, and administration tools.

      OS Distributor                                         Fedora Core 5
      Desktop Environment                              GNOME Desktop Environment
      Application                                                Editors
                                                            Graphical Internet
                                                           Text-based Internet




      Development                                                 None
      Server                                               Windows File Server
                                                               FTP Server
                                                                         Network Server
                                                                  Server Configuration Tools
         Base System                                                 Administration Tools
                                                                              Base
                                                                  Dialup Networking Support
                                                                              Java
                                                                          System Tools
                                                                      X Window System
         Language                                                        Chinese Support
         Extra Package                                            net-snmp-5.3-4.2.i386.rpm
                                                                  net-snmp-5.3-4.2.i386.rpm
                                                                  net-snmp-5.3-4.2.i386.rpm
                                                               jre-1_1_5_0_06-linux-i586-rpm.bin
                                                                 lm_sensors-2.9.2-1.i386.rpm



                        Table 2. Software Package Information




Space Requirement

             In this section, we are using the automatic partition method. If you are a more
             experienced Linux user, use the manual partitioning method for more control over
             your system configuration, or select and modify the automatically defined
             partitions. The Table 3 and 4 are our partition example for you reference.

    Partition                         Mount Point                                    Capacity
    /dev/hda1                            /boot                                        102 MB
    /dev/hda2                         VolGroup00                                      35 GB



                        Table 3. Hard Disk Partition Layout




     Folder Name                                                             Capacity
     /                                                                        35 GB
     /boot                                                                    99 MB
     /dev/shm                                                                 506 MB



                        Table 4. LVM Partition Layout




                                                                     2
CHAPTER 2 - Installation Note

Fedora Core 5 (DVD)

        In this section, I assume that you are familiar with Linux. For more information
        about          Fedora        Linux          Installation,       please      visit
        http://fedora.redhat.com/docs/fedora-install-guide-en/fc4/index.html.


        Please select Server installation type during the installation Please refer to Table 2
        for more information. You may also select individual software packages during
        installation, or install them later.


        Please refer to Table 3 and 4 for hard drive partition.


        For the Security Configuration, we need to alter these setting so other computer can access the
        system. By default the firewall is enabled, with a simple set of rules that allow connections to
        be made from your system to others, but block incoming connections from other systems. At
        this moment we need to select “No firewall” and disable SELinux (Security Enhanced
        Linux).




COMMAND FOR MOUNTING/UNMOUNT DVD

        The instruction for mount and unmount commands is as follows:

        1.     Create DVD folder in /media directory


             # mkdir /media/dvd


        2.     Mount DVD


             # mount /dev/hdb /media/dvd


        3.     Unmount DVD


             # umount /media/dvd




                                                       3
Java Runtime Environment (JRE)

        Fedora Core 5 DVD doesn’t contain Java JRE rpm file, therefore, please follow
        our instruction to download and install this package.



        Download

        For more information about Java JRE installation manual, please refer to Sun Java Official
        web site(web site: http://java.sun.com/j2se/1.5.0/jre/install-linux.html ).

        1.     To       install  Sun     Java,    please    open    Firefox,    go    to
               http://java.sun.com/j2se/1.5.0/download.jsp, click on “Download” Java
               Runtime Environment (JRE) 5.0 Update 10, click the radio button to accept
               the license agreement.




        2.     Under "Linux Platform - J2SE(TM) Runtime Environment 5.0 Update 10"
               click on "Linux self-extracting file", to download jre-1_5_0_10-linux-i586.bin
               (save to disk). This should save the file to your home folder.



        Install the Linux RPM (self-extracting) file

        1.     Open a terminal. Type:


             # su -


        2.     Type your root password.

        3.     Change directory to the location where you would like the files to be installed.
               Type:


             # cd <Install Directory>


        For example, to install the software in the /usr/java/ directory, Type:


             # mkdir /usr/java -p



                                                    4
     # cd /usr/java




     Note about root access: To install the JRE in a system-wide location such as/usr/local, you must
     login as the root user to gain the necessary permissions. If you do not have root access, install the
     JRE in your home directory or a subdirectory for which you have write permissions.


4.     Change the permission of the file you downloaded to be executable. Type:


     # cp /media/dvd/ jre-1_5_0_06-linux-i586-rpm.bin /usr/java

     # chmod a+x jre-1_5_0_06-linux-i586-rpm.bin


5.     Start the installation process. Type:



     ./ jre-1_5_0_06-linux-i586-rpm.bin




     The script displays a binary license agreement, which you are asked to agree to before installation
     can proceed. Once you have agreed to the license, the install script creates and runs the file
     jre-1_5_0_06-linux-i586.rpm in the current directory.


6.     The installation file creates jre-1_5_0-linux-i586.rpm file in the current
       directory.




                                                      5
       7.     Run the RPM command at the terminal to install the packages. Type:



            rpm -iv jre-1_5_0-linux-i586.rpm


       8.     The JRE is installed in jre1.5.(version number) sub-directory under the
              current directory. In this case, the JRE is installed in the /usr/java/jre1.5.0
              directory. Verify that the jre1.5.0 sub-directory is listed under the current
              directory. Type:


            # ls




       9.     The installation is now complete. Go to the Enable and Configure section.



       Enable And Configure(Firefox 1.5 and Later)

       1.     Go to the plugins sub-directory under the Firefox installation directory



            # cd /usr/lib/firefox-1.5.0.1/plugins


       2.     In the current directory, create                   a    symbolic    link   to   the   JRE
              ns7/libjavaplugin_oji.so file Type:


            # ln -s /usr/java/jre1.5.0_06/plugin/i386/ns7/libjavaplugin_oji.so


       3.     Start Firefox browser or restart it if it is already running. Note that if you have
              other Firefox components (ie: Messenger, Composer, etc) running, you will
              need to restart them as well.

       4.     Go to Edit > Preferences. Under Content category > Select Enable Java.




Hardware Sensor

       The lm_sensor project provides the best and most complete hardware health monitoring drivers
       for Linux. User can use this package to monitor voltages, temperatures, fan speeds, etc. For
       more       information,      you       can     visit     lm-sensors       web      site(Ref:
       http://www.lm-sensors.org/wiki/ProjectInformation ).




                                                          6
Install the lm_sensor RPM(Fedora Core 5 DVD)

1.     Open a terminal. Type:


     # su


2.     Enter the root password.

3.     Change to the DVD directory. Type:


     # cd      /media/dvd/Fedora/RPMS


4.     Start installation process. Type:


     # rpm -ivh lm_sensors-2.9.2-1.i386.rpm




Scanning Hardware Monitor Chip

lm_sensors is a set of Linux kernel modules for monitoring the vital signs of a
computer: the voltages from the power supply, the temperature of the system and
the CPU and fan speeds. lm_sensors includes a command-line utility for checking
the current readings.

1. Detect hardware monitoring chips. Type:


     [root@linux ~]# sensors-detect

     It is generally safe and recommended to accept the default answers to all

     questions, unless you know what you're doing.



      We can start with probing for (PCI) I2C or SMBus adapters.

      You do not need any special privileges for this.

      Do you want to probe now? (YES/no): YES

     Probing for PCI bus adapters...

     Use driver `i2c-i801” for device 00:1F.3: Intel 82801FB 1CH6

     Probe succesfully concluded.


2. Press ENTER button, it will automatic detect chipset.



                                                         7
    I will now generate the commands needed to load the I2C modules.

    Sometimes, a chip is available both through the ISA bus and an I2C bus.

    ISA bus access is faster, but you need to load an additional driver module

    for it. If you have the choice, do you want to use the ISA bus or the

    I2C/SMBus (ISA/smbus)? ISA



   To make the sensors modules behave correctly, add these lines to

   /etc/modprobe.conf:



   #----cut here----

   # I2C module options

   alias char-major-89 i2c-dev

   #----cut here----



   To load everything that is needed, add this to some /etc/rc* file:



   #----cut here----

   # I2C adapter drivers

   modprobe i2c-i801

   modprobe i2c-isa

   # I2C chip drivers

   modprobe eeprom

   modprobe it87

   # sleep 2 # optional

   /usr/bin/sensors -s # recommended

   #----cut here----


3. In the second step, it tells you which modules have to be loaded to support
   whichever motherboard you are using.


   Do you want to generate /etc/sysconfig/lm_sensors? (YES/no): YES

                                                     8
   Copy prog/init/lm_sensors.init to /etc/rc.d/init.d/lm_sensors

   for initialization at boot time.


4. Confirm the result. Type:


   [root@linux ~]# lspci

   00:1f.0 ISA bridge: Intel Corporation 82801FB/FR (ICH6/ICH6R) LPC Interface Bridge (rev 03)

   …

   ….

   …


5. Check is any Intel ICH6 chip in the list.

6. Modify modprobe.conf file.


   [root@linux ~]# vi /etc/modprobe.conf

   # I2C module options

   alias char-major-89 i2c-dev


7. Modify rc.local file.


   [root@linux ~]# vi /etc/rc.d/rc.local

   # I2C adapter drivers

   modprobe i2c-i801

   modprobe i2c-isa

   # I2C chip drivers

   modprobe eeprom

   modprobe it87

   # sleep 2 # optional

   /usr/bin/sensors -s # recommended




                                                     9
Configure LM_SENSOR.CONF

1. Modify sensor.conf file.


   [root@linux ~]# vi /etc/sensor.conf


2. Search “it87” keyword. (Pressed ESC button > Pressed button > Type it87). The in5,
   in6, in7, and in8 are not used, so please set them to ignore.


   chip "it87-*" "it8712-*"


   # The values below have been tested on Asus CUSI, CUM motherboards.


   # Voltage monitors as advised in the It8705 data sheet


        label in0 "VCore 1"
        label in1 "VCore 2"
        label in2 "+3.3V"
        label in3 "+5V"
        label in4 "+12V"
        ignore in5
        label in5 "-12V"
        ignore in6
        label in6 "-5V"
        ignore in7
        label in7 "Stdby"
        ignore in8

        label in8 "VBat"


3. About 15 more lines down, formula for modifying volts.


   # If 3.3V reads 2X too high (Soyo Dragon and Asus A7V8X-X, for example),
   # comment out following line.
   #       compute in2 2*@ , @/2
          compute in2 @ , @


4. Change sensor type. Set sensor three to thermal diode. Sensor one and two are not
   used, so please set them to ignore.


   # Temperature
   #
   # Important - if your temperature readings are completely whacky
   # you probably need to change the sensor type.
   # Adujst and uncomment the appropriate lines below.
   # The old method (modprobe it87 temp_type=0xXX) is no longer supported.
   #



                                                  10
   # 2 = thermistor; 3 = thermal diode; 0 = unused
   # set sensor1 3
   # set sensor2 3
   # set sensor3 3

       ignore sensor1
       ignore sensor2
       set sensor3 3


5. The temperature of the sensor two is not used, so please set it to ignore.


   # If a given sensor isn't used, you will probably want to ignore it
   # (see ignore statement right below).


        label temp1    "M/B Temp"
        set temp1_over 40
        set temp1_low 15
        ignore temp2

        label temp2             "CPU Temp"
        set temp2_over           45
        set temp2_low            15
   #    ignore temp3
        label temp3             "Temp3"
        set temp3_over           45
        set temp3_low            15


6. Configure the lm_sensors service to start on reboot.


   [root@linux ~]# chkconfig lm_sensors --list

   lm_sensors           0:off    1:off    2:on      3:on      4:on        5:on   6:off


7. Reboot System.


   [root@linux ~]# sync; sync; reboot


8. Show the current readings of all sensor chips.


   [root@linux ~]# sensors

   It8712-isa-0290

   Adapter: ISA adapter

   VCore 1:     +1.33 V (min = +1.42 V, max = +1.57 V)                   ALARM

   VCore 2:     +1.79 V (min = +2.40 V, max = +2.61 V)                   ALARM



                                                      11
             +3.3V:       +3.17 V (min = +3.14 V, max = +3.47 V)

             +5V:         +4.89 V (min = +4.76 V, max = +5.24 V)

             +12V:       +11.52 V (min = +11.39 V, max = +12.61 V)

             fan1:       2445 RPM (min =      0 RPM, div = 8)

             fan2:         -1 RPM (min = 3013 RPM, div = 8)

             fan3:          0 RPM (min = 3013 RPM, div = 8)

             M/B Temp:      -55°C (low =      +15°C, high =     +40°C)   sensor = thermistor

             temp3:         +32°C (low =       +15°C, high =    +45°C)   sensor = diode




SNMPD

        Simple Network Management Protocol (SNMP) is a widely used protocol for
        monitoring the health and welfare of network equipment (eg. routers), computer
        equipment and even devices like UPSs. Net-SNMP is a suite of applications used
        to implement SNMP v1, SNMP v2c and SNMP v3 using both IPv4 and IPv6.

        Install the SNMPD RPM(Fedora Core 5 DVD)

        1.     Open a terminal. Type:


             [root@linux ~]# su


        2.     Enter your root password.

        3.     Change to the DVD directory. Type:


             [root@linux ~]# cd /media/dvd/Fedora/RPMS


        4.     Start installation process. Type:


             [root@linux ~]# rpm -ivh net-snmp-5.3-4.2.i386.rpm

             [root@linux ~]# rpm -ivh net-snmp-perl-5.3-4.2.i386.rpm

             [root@linux ~]# rpm -ivh net-snmp-utils-5.3-4.2.i386.rpm




                                                        12
Configure SNMPD.CONF

1.       Modify /etc/snmp/snmpd.conf


     [root@linux ~]# cp /etc/snmp/snmpd.conf /etc/snmp/snmpd.conf-org

     [root@linux ~]# vi /etc/snmp/snmpd.conf


2.       Map the community name into security name.


     # First, map the community name (COMMUNITY) into a security name
     # (local and mynetwork, depending on where the request is coming
     # from):

     #          sec.name source                     community

     com2sec local         localhost          public

     com2sec mynetwork default                 public


3.       Map the security names into group names.


     ####
     # Second, map the security names into group names:

     #                      sec.model sec.name

     group MyRWGroup v1                     local

     group MyRWGroup v2c                   local

     group MyRWGroup usm                    local

     group MyROGroup v1                    mynetwork

     group MyROGroup v2c                   mynetwork

     group MyROGroup usm                    mynetwork


4.       Create a view for us to let the groups have right.


     ####
     # Third, create a view for us to let the groups have rights to:

     #               incl/excl subtree                                  mask

     view all     included .1.3.6.1.4.1.15370                          80


5.       Grant 2 groups access to the 1 view with different notification permission.



                                                        13
           ####
           # Finally, grant the 2 groups access to the 1 view with different
           # write permissions:

           #                       context sec.model sec.level match read            write notif

           access MyROGroup ""             any          noauth           exact all      all    all

           access MyRWGroup ""             any           noauth          exact all      all    none


      6.       Put a line master agentx in the snmpd.conf file.


           #############################################################################
           ##
           # Further Information
           #
           # See the snmpd.conf manual page, and the output of "snmpd -H".
           # MUCH more can be done with the snmpd.conf than is shown as an
           # example here.

           master agentx


      7.       Configure the snmpd service to start on reboot


           [root@linux ~]# chkconfig snmpd on

           [root@linux ~]# chkconfig snmpd --list

           snmpd           0:off   1:off   2:on       3:on        4:on       5:on      6:off




COM-V1 RPM

      The COM web application is only using in client side. It can report current
      hardware and software information. In this section, we will tell you how to install
      and setup configuration file.

      1.       Open a terminal. Type:


           [root@linux ~]# su


      2.       Enter your root password.

      3.       Change to the DVD directory. Type:


           [root@linux ~]# cd /media/dvd



                                                             14
4.     Start installation process for COM server. Type:


     [root@linux ~]# rpm -ivh --nomd5 com-1.0-1.i386.rpm


5.     Unzip web application.


     [root@linux ~]# cd /usr/local

     [root@linux ~]# tar –zxvf /media/dvd/comstd-v1_0_0.tar.gz


6.     Verify that the COMSTD directory is listed under the current directory. Type:


     [root@linux ~]# ls

     bin COMSTD etc games include lib libexec man sbin share src


7.     Create com-v1 shortcut on desktop. Right-click on the middle of your
       desktop and select “Create Launcher”. You'll see the Desktop Entry
       Properties screen.

             Name(N):COM

             Command       (     A    )                :        /usr/lib/firefox-1.5.0.1/firefox
              /usr/local/COMSTD/Frame.htm

                   (I) Choosing a generic Linux image from the Choose An Icon dialog box
              Picture  :




                                                15
     8.      Click OK to save your settings, and your COM icon will appear on your
             desktop.

     9.      Add new service for management by chkconfig.


           [root@linux ~]# chkconfig --add gbcomd

           [root@linux ~]# chkconfig gbcomd on

           [root@linux ~]# chkconfig gbcomd --list

           gbcomd        0:off    1:off   2:on   3:on        4:on      5:on   6:off


     10.     Start SNMPD Server.


           [root@linux ~]# service snmpd start


     11.     Run GBCOMD server.


           [root@linux ~]# service gbcomd start

           Start GBMIBD Service                              [ OK ]

           Start GAGENT Service                               [ OK ]

           Start GBRGD Service                               [ OK ]

           Start GBCCD Service                               [ OK ]


     12.     Verify SNMPD server.


           [root@linux ~]# snmpwalk -c public -v 1 localhost .1.3.6.1.4.1.15370




     Configure GBCCD.CONF

     Verion 1.0.0 doesn’t support。This configuration file is for gbcomd、gagent、gbmibd、
     gbrgd、gbccd and gbbios.




     Install Location

     Table 5 is specified the Install Location for com-1.0-1.i386.rpm file.

PATH                                                           File Name
/etc/gigabyte                                                  gbccd.conf



                                                        16
/ect/init.d                                          gbcomd、gagent、gbmibd、gbrgd、gbccd
/root                                                               .java.policy
/usr/sbin                                                    gagent、gbmibd、gbrgd、gbccd
/usr/java/jre1.5.0_06/lib/ext                   jcommon-1.0.0.jar、jfreechart-1.0.1.jar、joesnmp.jar、
/sbin                                                                 gbbios

                  Table 5. Installation Path for RPM File




                                                               17
CHAPTER 3 - Test & Verify

      TBD.




                            18

								
To top