CAMNET
Super-Quick Start Guide
Super-Quick Start Guide (SQSG)
1 June 2015

   Assuming the server and client are already installed and on the same machine,
      and
   Assuming you have logged onto CAMNET server from the client using admin40 creds,
      and
   Assuming the camera make/model is Hikvision/HIK_IPC1

I. Press the System button at the top

   A. System, Server name: Set the host name or IP address of the machine
      on which CAMNET server was installed
      1. Set the Default LAN-side remote server name (then press Accept)
      2. Set the LAN-side control port (then press Accept)
      3. Press Save
      NOTE: <ComputerName> and 4040 will do; alternatively, the
            IP address (192.168.0.2, etc. or actual computer name)
            Since this is the same machine, 127.0.0.1 will also do fine

   B. System, Users:  Add the admin user (creds to connect to CAMNET server, not cams)
      1. Press the Add button
      2. Enter the username you will use to connect to the server (then press Accept)
      3. Enter the password you will use for that username (then press Accept)
      4. Press Save

   Normally you would want to set up System, Cam UP map, to set camera username/password
   to a GUID, so to not put the plain-text creds to your camera(s) in cam.cfg files, but
   for this SQSG, these two System panels (above) will be enough to start -- the
   Cam UP map/GUID has nothing to do with the System, Users panel in B. above;
   the GUIDs are used as substitutes for username/passwords of cameras


Tips:

- Below, (then press Accept) is implied where needed

- The CNX*FREE package license supports ONE camera and ONE server instance:
  - (CNX*FREE licensed) CAMNET server ignores cameras after the first

- The paid package license supports unlimited cameras and server instances per location
  - Press F4 from Camnet Service Manager for licensing and pricing

- If you wait a long time (120 seconds or so) entering set up data on a panel
  for an as-yet-unjoined camera, CAMNET server disconnects the client (noticed
  by you on a Save); repeat the Save press (the client reconnects)


II. Press the Camera 1 button at the top left

   A. Press the Cam setup button at the top, then the ID panel tab
      1. Enter a Name for this camera (this is used as part of a pathname -- for this, use Hik1)
      2. Enter a label for this Camera 1 button: for this, use   TestHik
      3. Jump to Camera make: select from the available makes
         If you don't see a camera make for a camera you have, STOP and
         search the internet for your camera's CGI URIs to:
          a. Get a snapshot  (e.g., /jpg/image.jpg)
          b. Get a stream   (e.g., /h264)
         Use the Other/OTHER_ANY camera make/model
      4. Enter the camera make and model from the menu lists
         a. For this example, the Camera make/model is presumed to be Hikvision/HIK_IPC1
         b. See the XREF page if needed (near the bottom of the CAMNET index page)
      5. Check that the LAN-side remote server name and control port are as expected
         a. If not (would only happen if this were a re-activated camera) make the changes
         b. The WAN-side can be left blank for now, as can Display groups
      6. Press Save

   B. Press the Info panel tab (still at Cam setup)
      1. For now, set ALL yes/no fields to yes
      2. Set the Event by network type
         a. For this example, Hikvision/HIK_IPC1, select EBNT_ONVIF from the list
         b. If EBNT_FAMID is available, select that from the list
         c. If the camera make/model was Onvif/ONVIF_V2, select EBNT_ONVIF
         d. Otherwise, for now, keep it at not set
      3. Leave DI base states at 0, RTCP RR at after SR and RTSP keep-alive at UDP only
      4. Press Save
      
   C. Press Address
      1. Enter the Host name or IP address of the camera, for example, 192.168.0.40
      2. If the HTTP port is not standard, for example, port 85 instead of 80, change Port HTTP
      3. The other ports can be left as they are
      4. Press Save

   D. Press Onvif
      1. Since the camera being used in this example uses EBNT_ONVIF,
         the Cam setup Onvif panel must be set
         a. For Hikvision, the default (general) Onvif device manager Xaddr
            in the drop down menu list can be used
         b. For some cameras (e.g. early Dahua) the default general Xaddr is not correct;
            use the System, Onvif panel to discover the true Xaddr (TIP: once acquired,
            touch the Xaddr field to copy it to the editbox, then return to the
            Cam setup Onvif panel; the Xaddr from the System Onvif panel is the menu list
            -- you could also select/copy/paste; the Cam UP map GUID value is
            similarly placed into username/password drop down menu lists)
      2. Jump down to the creds fields
         a. Use digest
         b. Set the Onvif username and password - usually, but not always, these will be
            the same as the regular username and password for the camera (for Dahua see
            the full QSG for its problem with the Onvif username/password)
      3. Press Save (now, before doing the next step)
      4. Press Get profiles (it may take a few seconds) and select from the available
         profiles (e.g., Profile_1/1920x1080@30 H264 no audio)
         - Since the example camera (Hikvision/HIK_IPC1) is using Onvif only for event
           processing, the profile won't matter
      5. Press Save

   E. Press Access
      1. Select the Comm mode - for this example pick COMM_RTSP_OVER_TCP
      2. Set audio accordingly (see the full QSG for more on Dahua cameras which may
         falsely report that audio is supported)
      3. Set the Camera stream URI (e.g., /streaming/channels/1/)
      4. Set the Camera snapshot URI (e.g., /streaming/channels/1/picture/)
         a. If for 5 (below) you use basic,
            you may need to use:  /streaming/channels/1/picture/?auth=digest
         b. The reason is some Hiks insist on digest authentication for a snapshot
            but will accept basic for a stream
      5. Set the Camera authentication to digest [basic for most cameras will do fine;
          digest is not generally needed for cameras local to CAMNET server,
          but Hikvision cameras require digest authentication for CGI/macros]
         a. Some cameras may only support digest
         b. Some cameras support proprietary authentication
         c. Hikvision cameras stream using basic but require digest for snapshots and CGIs
      6. Set the camera username/password
         a. Here is where the System, Cam UP map panel (which was skipped in this SQSG)
            would come into play
         b. See the full QSG for more on why you want to use a GUID
            for all camera username/password values
      7. Press Save

   F. Skip all the Cam setup tabs until you get to Test-Join
      1. Press Test
      2. Press Join
         a. The camView image (which has been showing the NOT JOINED image for a while)
            changes to the two alternating target images (no_snap_1.jpg and no_snap_2.jpg
            in the install directory)
         b. When a snapshot is acquired the target image is replaced by the camera snapshot

III. That was fast
   
   At this point, the TestHik button is showing the snapshot in the small camView
   next to the button, and the blue LED is lit, indicating that CAMNET server is
   processing the camera stream.  If you have set your camera to detect motion
   (or line crossing, field intrusion/intrusion detection, etc.) the blue LED
   changes to yellow (or cyan, et al. depending on if motion, or DI/PIR, or both)
   upon detection.  To get a live view, press the Live video button at the top right.

   Exiting the client has no effect on the server

   To fully dispose of this test case:

      1. Cam setup, ID panel
         a. Set the Button text field to REMOVE
         b. Press Save

         - This disjoins the camera from CAMNET server
         - The entry remains in stasis in the camnetsvcmgr.cbn for later re-activation
         - See the full QSG for more on the .cbn (text) file, including its location

      2. Delete this camera's directory
         a. Locate this camera's directory at (for example) c:\camnet\camnetserver\cam_Hik1
         b. Remove the directory (or rename it so it does not start with "cam_")

   For more, read the full QSG, starting from the top and going down, one by one.