wview Quick Start Guide for Macintosh

February 5, 2006


This guide will provide the basic procedure for a "standard" wview install. Detailed description of the steps, advanced configuration of features and troubleshooting tips are found in the wview User Manual. Also, please see the wview homepage for a detailed description of wview, the latest news on releases, the wview User's Forum and other interesting links.

Mac OSX Requirements

System Requirements

Weather Station - one of the following:

Install Procedure

      Note: execute these commands in a terminal session while logged into an account 
            with administration privileges - the sudo command requires you to enter your 
            password before it will execute the command following it.
      1)  Extract the radlib distribution: 

          tar zxvf radlib-x.y.z.tar.gz
      2)  Configure the distribution: 

          cd radlib-x.y.z
          ./configure --prefix=/opt/local
      3)  Build/install radlib: 

          sudo make install
      4)  Extract the wview distribution: 

          tar zxvf wview-x.y.z.tar.gz
      5)  Configure the distribution: 

          cd wview-x.y.z
          ./configure --prefix=/opt/local --enable-station-[type]
      6)  Build/install wview: 

          sudo make install
      7)  If a first time wview install, copy the default run environment:

          sudo make install-env

      8)  If a new Vantage Pro station, use the on-screen console configuration 
      9)  Configure wview: 

          sudo /opt/local/bin/wviewconfig
          Note: If you are using the USB-to-Serial convertor and driver supplied 
                with the Weatherlink for Mac package, your Physical Interface is 
                "serial". This is what you should specify for the first question, not 
                the actual device name (/dev/tty.SLAB_USBtoUART) - this should be 
                given in the second question after specifying "serial" for the first.
      10) If a first time wview install, copy the example startup directory for 
          wview to /Library/StartupItems:

          sudo cp -R ./examples/MacOSX/wview /Library/StartupItems
          sudo chmod -R 755 /Library/StartupItems/wview
          sudo chmod -x /Library/StartupItems/wview/StartupParameters.plist
          sudo chown -R root:wheel /Library/StartupItems/wview

          Now wview should be started when you boot your Mac.

      11) Run wview: 

          sudo /sbin/SystemStarter start "wview"
          Note: You can stop or restart wview as follows:
          sudo /sbin/SystemStarter stop "wview"
          sudo /sbin/SystemStarter restart "wview"
      12) See wview startup and run logs:

          sudo tail -n 100 -f /var/log/system.log
          Note: Unless you configured wview to include ftp, ssh, alarms or CWOP 
                support, these daemons will start up, complain about not finding 
                their config files, then exit. This is normal behavior. wviewconfig 
                disables these options by naming the config files to something 
                other than what the daemons are expecting so they will exit when 
                they try to initialize. Don't let this bother you.

      13) Confirm proper operation:

          sudo ps aux | grep wv
          (you should see at least "wviewd" - maybe others if you enabled them)

          sudo ps aux | grep htmlgend
          (you should see "htmlgend")

          You should see the log message "doing initial html generation now..." 
          at the end of the wview initialization log messages.

          ls -al /var/wview/img/index.html
          (you should see the file listed)

          Open /var/wview/img/index.html with your favorite browser - this is your 
          new wview homepage.