90f074f release note for v1.4.3

7a5cb25 add README for using pi image.
4e8d554 by default run make with -j 2
79bc1a0 use pkg-config and cmake find_library to locate libraries
a8f2467 rm cmake and gcc installation files in the same step to reduce size
cbfb47d add option to clean up installation files after build. add option to parallelize make, use system curl to download libraries.
b5aa632 add raspberry pi docker file
c0d414a new install script option change
6b122f1 optimizing the docker image; updating ubuntu docker image to include gstreamer plugin
2228b7b Updating docker readme for pre-built images

Author: chehefen

README.md

@@ -239,31 +239,31 @@ $ export GST_PLUGIN_PATH=<YourSdkFolderPath>/kinesis-video-native-build/download
 ```
 ###### 3.1 Run the following `gst-launch-1.0` command to start streaming from RTSP camera source.
 ```
-$ gst-launch-1.0 rtspsrc location=“rtsp://YourCameraRtspUrl” short-header=TRUE ! rtph264depay ! video/x-h264, format=avc,alignment=au ! kvssink stream-name=“YourStreamName” storage-size=512
+$ gst-launch-1.0 rtspsrc location=rtsp://YourCameraRtspUrl short-header=TRUE ! rtph264depay ! video/x-h264, format=avc,alignment=au ! kvssink stream-name=YourStreamName storage-size=512
 ```
 ###### 3.2 Run the following `gst-launch-1.0` command to start streaming from USB camera source in **Ubuntu**.
 
 ```
-$ gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 ! x264enc  bframes=0 key-int-max=45 bitrate=500 ! video/x-h264,stream-format=avc,alignment=au ! kvssink stream-name="YourStreamName" storage-size=512
+$ gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 ! x264enc  bframes=0 key-int-max=45 bitrate=500 ! video/x-h264,stream-format=avc,alignment=au ! kvssink stream-name=YourStreamName storage-size=512
 ```
 ###### 3.3 Run the following `gst-launch-1.0` command to start streaming from USB camera source which has h264 encoded stream already in **Ubuntu**.
 
 ```
-$ gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! h264parse ! video/x-h264,stream-format=avc,alignment=au ! kvssink stream-name="plugin" storage-size=512
+$ gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! h264parse ! video/x-h264,stream-format=avc,alignment=au ! kvssink stream-name=YourStreamName storage-size=512
 ```
 
 ###### 3.4 Run the following `gst-launch-1.0` command to start streaming from camera source in **Mac-OS**.
 
 ```
-$ gst-launch-1.0 autovideosrc ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 ! vtenc_h264_hw allow-frame-reordering=FALSE realtime=TRUE max-keyframe-interval=45 bitrate=500 ! h264parse ! video/x-h264,stream-format=avc,alignment=au,width=640,height=480,framerate=30/1 ! kvssink stream-name="YourStreamName" storage-size=512
+$ gst-launch-1.0 autovideosrc ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 ! vtenc_h264_hw allow-frame-reordering=FALSE realtime=TRUE max-keyframe-interval=45 bitrate=500 ! h264parse ! video/x-h264,stream-format=avc,alignment=au,width=640,height=480,framerate=30/1 ! kvssink stream-name=YourStreamName storage-size=512
 ```
 
 ###### 3.5 Run the following `gst-launch-1.0` command to start streaming from camera source in **Raspberry-PI**.
 
 ```
-$ gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 ! omxh264enc control-rate=1 target-bitrate=5120000 periodicity-idr=45 inline-header=FALSE ! h264parse ! video/x-h264,stream-format=avc,alignment=au,width=640,height=480,framerate=30/1 ! kvssink stream-name="YourStreamName" frame-timestamp=KVS_SINK_TIMESTAMP_DTS_ONLY access-key="YourAccessKey" secret-key="YourSecretKey"
+$ gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 ! omxh264enc control-rate=1 target-bitrate=5120000 periodicity-idr=45 inline-header=FALSE ! h264parse ! video/x-h264,stream-format=avc,alignment=au,width=640,height=480,framerate=30/1 ! kvssink stream-name=YourStreamName frame-timestamp=dts-only access-key=YourAccessKey secret-key=YourSecretKey
 ```
-Note:  Raspberry PI camera module requires `frame-timestamp=KVS_SINK_TIMESTAMP_DTS_ONLY` . If USB camera is used for streaming then this property is optional.
+Note:  Raspberry PI camera module requires `frame-timestamp=dts-only` . If USB camera is used for streaming then this property is optional.
 
 ##### 4. Run the demo application from Docker
 
@@ -424,31 +424,45 @@ make install
 
 ----
 ## Release notes
+#### Release 1.4.3 (20th June 2018)
+* Added prebuilt docker images for AmazonLinux and Raspbian Stretch
+* Updated install-script to accept commandline argument -j and pass the value to `make` to speed up building
+* Updated install-script to accept commandline argument -d to remove opensource library installation files after finishing
+* Updated CMakeLists.txt in kinesis-video-native-build to link up libraries properly
+
 #### Release 1.4.2 (14th June 2018)
 * Release first version of gstreamer plugin kvssink
 * Fix gstreamer demo issue when running on raspberry pi
+
 #### Release 1.4.1 (8th May 2018)
 * Update log4cplus download link in install-script
+
 #### Release 1.4.0 (25th April 2018)
 * Fix for crash caused by latest Mac tool chain issue
 * Fix for callbacks returning incorrect custom data in gstreamer sample app
 * Support for custom logger
 * Fix for multiple callbacks when triggering connection staleness
+
 #### Release 1.3.1 (5th April 2018)
 * Fixed video source negotiation error caused by camera with fractional fps
 * Docker suport for RTSP streaming
+
 #### Release 1.3.0 (15th March 2018)
 * Fixed producer intermittent termination issue for some edge cases involving re-streaming on error.
+
 #### Release 1.2.3 (1st March 2018)
 * Updated install-script to fix the local certificate trust issue for curl.
 * Added steps in README troubleshooting section for curl trust issues.
+
 #### Release 1.2.2 (March 2018)
 * Remove open-source dependencies from KinesisVideoProducerJNI native library. java-install-script can be used to build KinesisVideoProducerJNI native library fast.
 * README note improved.
+
 #### Release 1.2.1 (February 2018)
 * Bug fix for producer timestamp *video playback* in the console should be fixed if proper timestamp is provided to SDK. Current setting in sample app uses Gstreamer frame timecode and relative timestamp (used by SDK).
 * `install-script` is updated to automatically detect OS version and avoid dependency issue on Mac High Sierra and Ubuntu 17.10.
 * Known issue: Producer timestamp mode *video playback in console* will not work if GStreamer demoapp is configured to use frame timecode and absolute timestamp (used by SDK).
+
 #### Release 1.2.0 (February 2018)
 * Bug fixes and performance enhancement
 * Streaming error recovery improvements
@@ -461,23 +475,27 @@ make install
 ```
 AWS_ACCESS_KEY_ID=<MYACCESSKEYID> AWS_SECRET_ACCESS_KEY=<MYSECRETKEY> ./kinesis_video_gstreamer_sample_rtsp_app <rtspurl> <stream-name>
 ```
+
 #### Release 1.1.2 (January 2018)
 * Allowed devices to output h.264 streams directly
 * The user can also supply a streaming resolution through command line arguments.
   * If resolution is provided then the sample will try to check if the camera supports that resolution. If it does then streaming starts; else, it will fail with an error msg "Resolution not supported"
   * If no resolution is specified, the demo will try to use resolutions 1920x1080, 1280x720 and 640x480 in that order (highest resolution first)and will start streaming once the camera supported resolution is detected.
 * Known issues:
   * When streaming on raspberry pi. Some green artifacts might be observed on the preview screen. Reducing the resolution can fix the issue.
+
 #### Release 1.1.1 (December 2017)
 * Fix USB webcam support
 * Known issues:
     * If USB webcam doesn't support 720p, then gstreamer negotiation will fail. Trying lower resolution as mentioned in Troubleshooting may fix this issue.
+
 #### Release 1.1.0 (December 2017)
 * Addition of a received application ACK notification callback
 * Lifecycle management improvements
 * Exposed failure on progressive back-off/retry logic
 * Hardening/fixing various edge-cases
 * Fixing Raspberry PI frame dropping issue
+
 #### Release 1.0.0 (November 2017)
 * First release of the Amazon Kinesis Video Producer SDK for Cpp.
 * Known issues:
@@ -487,4 +505,4 @@ AWS_ACCESS_KEY_ID=<MYACCESSKEYID> AWS_SECRET_ACCESS_KEY=<MYSECRETKEY> ./kinesis_
 
 ## Documentation
 
-  [Kinesis Video Producer SDK CPP](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk-cpp.html)
+  [Kinesis Video Producer SDK CPP](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk-cpp.html)

docker_native_scripts/Dockerfile

@@ -30,9 +30,18 @@ RUN git clone https://github.com/awslabs/amazon-kinesis-video-streams-producer-s
 
 WORKDIR /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/
 RUN  chmod a+x ./install-script
-RUN ./install-script a
+RUN chmod a+x ./gstreamer-plugin-install-script
+RUN ./install-script -a
+RUN cp libproducer.so /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib/
+ENV KINESIS_VIDEO_STREAMS_PRODUCER_SDK_SOURCE_DIR=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/
+ENV SDK_SOURCE_DIR=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/
+RUN ./gstreamer-plugin-install-script
 RUN ./java-install-script
+RUN cp /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-gstreamer-plugin/libgstkvssink.so /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib/
 COPY start_rtsp_in_docker.sh /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/
+ENV LD_LIBRARY_PATH=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib:$LD_LIBRARY_PATH
+ENV GST_PLUGIN_PATH=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib
+ENV PATH=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/bin:/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build:$PATH
 RUN chmod a+x ./start_rtsp_in_docker.sh
 
 # comment the following step if you would like to customize the docker image build

docker_native_scripts/amazonlinux-docker/Dockerfile

@@ -0,0 +1,79 @@
+# Build docker with
+# docker build -t kinesis-video-producer-sdk-cpp-amazon-linux .
+#
+FROM amazonlinux
+RUN yum update -y && \
+   yum upgrade -y && \
+   yum install -y autoconf && \
+   yum install -y automake && \
+   yum install -y bison && \
+   yum install -y bzip2 && \
+   yum install -y cmake && \
+   yum install -y curl && \
+   yum install -y diffutils && \
+   yum install -y flex  && \
+   yum install -y gcc-c++  && \
+   yum install -y git && \
+   yum install -y gmp-devel && \
+   yum install -y libffi && \
+   yum install -y libffi-devel && \
+   yum install -y  libmpc-devel && \
+   yum install -y libtool && \
+   yum install -y m4 && \
+   yum install -y mpfr-devel && \
+   yum install -y pkgconfig && \
+   yum install -y vim && \
+   yum install -y wget
+
+
+RUN wget https://cmake.org/files/v3.2/cmake-3.2.3-Linux-x86_64.tar.gz && \
+    tar -zxvf cmake-3.2.3-Linux-x86_64.tar.gz && \
+    rm cmake-3.2.3-Linux-x86_64.tar.gz
+ENV PATH=/cmake-3.2.3-Linux-x86_64/bin/:$PATH
+RUN wget https://ftp.gnu.org/gnu/gcc/gcc-7.2.0/gcc-7.2.0.tar.gz && \
+    tar -xvf gcc-7.2.0.tar.gz && \
+    cd gcc-7.2.0 && \
+    ./configure --disable-multilib --enable-languages=c,c++ && \
+    make && \
+    make install && \
+    cd .. && \
+    rm -rf gcc-7.2.0*
+RUN /usr/local/bin/gcc "--version"
+WORKDIR /opt/
+
+RUN git clone https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git
+
+WORKDIR /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/
+
+ENV CC=/usr/local/bin/gcc
+ENV CXX=/usr/local/bin/g++
+RUN chmod a+x ./install-script
+RUN chmod a+x ./gstreamer-plugin-install-script
+# =================  HTTPS Certificate =====================================================================
+RUN wget https://www.amazontrust.com/repository/SFSRootCAG2.pem
+RUN cp  SFSRootCAG2.pem /opt/amazon-kinesis-video-streams-producer-sdk-cpp
+# ================  Build producer sdk and gstreamer plugin ================================================
+#
+RUN chmod +x install-script
+RUN ./install-script -a -j 4 -d
+RUN cp libproducer.so /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib/
+ENV KINESIS_VIDEO_STREAMS_PRODUCER_SDK_SOURCE_DIR=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/
+ENV SDK_SOURCE_DIR=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/
+RUN pwd
+RUN ./gstreamer-plugin-install-script
+
+#
+# Copy dynamic libraries into lib folder
+RUN cp /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-gstreamer-plugin/libgstkvssink.so /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib/
+
+# Copy all demo sample application binaries kinesis-video-native-build
+RUN cp /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-gstreamer-plugin/kvs_producer_plugin* /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/
+# Copy gst-launch-1.0 and gst-inspect-1.0 kinesis-video-native-build
+RUN cp /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/bin/gst* /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/
+
+# Set environment variables for plugin and libraries
+ENV LD_LIBRARY_PATH=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib:$LD_LIBRARY_PATH
+ENV GST_PLUGIN_PATH=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib
+ENV PATH=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/bin:/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build:$PATH
+
+WORKDIR /opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/

docker_native_scripts/amazonlinux-docker/Instructions-for-prebuilt-Dockerimages.md

@@ -0,0 +1,72 @@
+# Using Docker images for Producer SDK (CPP and GStreamer plugin):
+
+Please follow the four steps below to get the Docker image for Producer SDK (includes CPP and GStreamer plugin) and start streaming to Kinesis Video.   
+
+#### Pre-requisite: 
+
+This requires docker is installed in your system. 
+
+Follow instructions to download and start Docker
+
+* [Docker download instructions](https://www.docker.com/community-edition#/download)
+* [Getting started with Docker](https://docs.docker.com/get-started/)
+
+
+Once you have docker installed, you can download the Kinesis Video Producer SDK (CPP and GStreamer plugin) from Amazon ECR (Elastic Container Service) using `docker pull` command.
+
+
+#### Step 1: 
+
+Authenticate your Docker client to the Amazon ECR registry that you intend to pull your image from. Authentication tokens must be obtained for each registry used, and the tokens are valid for 12 hours. For more information, see Registry Authentication.
+
+Example:
+    
+You can authenticate to Amazon ECR using the following two commands:
+
+1.  `aws ecr get-login --no-include-email --region us-west-2 --registry-ids 546150905175`
+
+you will see an **output** similar to the one below.
+
+2.  `docker login -u AWS -p <Password>   https://<YourAccountId>.dkr.ecr.us-west-2.amazonaws.com`
+
+Run the command as such in your command prompt. This will authorize the `docker pull` which you will be running next.
+
+
+#### Step 2: Pull Image
+
+##### 2.1 Steps for getting the Docker images built with AmazonLinux  
+	
+Run the following command to get the AmazonLinux Docker image to your local environment. E.g.
+
+`sudo docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-cpp-amazon-linux:latest`
+`sudo docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-raspberry-pi:latest`   
+
+you can verify the images in your local docker environment by running `docker images`.
+
+
+#### Step 3: Run the Docker Image (start the container)
+
+Run the following command to start the kinesis video sdk container 
+
+`sudo docker run -it --network="host" --device=/dev/video0 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-cpp-amazon-linux:latest /bin/bash`
+
+
+#### Step 4: Run the GStreamer plugin
+
+Follow the next few steps to start Producer SDK GStreamer plugin element for sending video streams from webcamera to Kinesis Video:
+
+##### 4.1 Set these environment variable:
+
+`export LD_LIBRARY_PATH=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib:$LD_LIBRARY_PATH`
+
+`export PATH=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/bin:$PATH`
+
+`export GST_PLUGIN_PATH=/opt/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib:$GST_PLUGIN_PATH`
+
+
+##### 4.2 Start the streaming with `gst-launch-1.0` command.
+
+`gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 ! x264enc bframes=0 key-int-max=45 bitrate=512 ! h264parse ! video/x-h264,stream-format=avc,alignment=au,width=640,height=480,framerate=30/1 ! kvssink stream-name="YOURSTREAMNAME" access-key=YOURACCESSKEY secret-key=YOURSECRETKEY` 
+     
+For additional examples refer [Readme](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/README.md) in  https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp. 
+