-
Notifications
You must be signed in to change notification settings - Fork 0
Amazon (AWS) S3 Integration
Amazon S3 Integration lets you upload your MP4 files and previews to S3 automatically so that you do not need to worry about disk space in your server. Here is the simple manual how to enable S3 Integration to your streaming app
- In order to programmatically access to S3, you should have an access token and secret keys. You can create a programmatic user to have an access token and secret key from AWS IAM(Identity and Access Management) console.
Just Add User
by checking Programmatic Access
box and then in the next section click Attach existing policies directly
and add AmazonS3FullAccess
access permission to this user. Copy access token and secret key for this user.
- Right now, you should have
access token
,secret key
,bucket name
in your hand.
You also need to know the region of your bucket. If you do not have any bucket, you can create it on S3 Console
- Add a new bean to
red5-web.xml
of your app as below.red5-web.xml
file is underWEB-INF
folder of your app. For instancewebapps
/LiveApp
/WEB-INF
/red5-web.xml
<bean id="app.storageClient" class="io.antmedia.storage.AmazonS3StorageClient">
<property name="accessKey" value="Enter your S3_ACCESS_KEY" />
<property name="secretKey" value="Enter your S3_SECRET_KEY" />
<property name="region" value="Enter your REGION_NAME e.g. eu-central-1" />
<property name="storageName" value="Enter your BUCKET_NAME" />
</bean>
You should set the values accordingly to your access token, secret key, region name and bucket name. You can learn your region's programmatic name from here.
- Save the file and restart the server
sudo service antmedia restart
Your MP4 files and Preview files will be uploaded to your S3 bucket automatically.
This section is optional. If you want to forward HTTP requests to MP4 files, Preview files or m3u8 files to AMS S3 directly, you can use this feature with few basic changes in application settings.
Open AMS-DIR
/ webapps
/ {application}
/ WEB-INF
/ red5-web.properties
with your text editor (vim, nano)
settings.httpforwarding.extension
Usage Example:
settings.httpforwarding.extension=mp4
You can add extensions with a comma: mp4,png
Detail in code: HTTP Forward Extension Settings Details
settings.httpforwarding.baseURL
Usage Example:
settings.httpforwarding.baseURL=https://{s3BucketName}.s3.{awsLocation}.amazonaws.com
Detail in code: HTTP Forward BaseURL Settings Details
When you added above code snippets in Application Settings, your Request URI will be as below.
https://{s3BucketName}.s3.{awsLocation}.amazonaws.com/streams/{streamId.mp4}
Detail in code: HTTP Forward Filter
Note: Don't add any leading, trailing white spaces.
Restart Ant Media Server
sudo service antmedia restart
After server restarted, MP4 and Preview files will be forwarded to S3 directly.
For example; when requested defined MP4 or any file:
https://serverDomain:5443/{streamApp}/streams/{streamId}.mp4
HTTP request will be redirected as below
https://{s3BucketName}.s3.{awsLocation}.amazonaws.com/streams/{streamId}.mp4
- Quick Start
- Introduction
- Installation
- Publishing Live Streams
- Playing Live Streams
- Conference Call
- -Peer to Peer Call
- Adaptive Bitrate(Multi-Bitrate) Streaming
- Video on Demand Streaming
- Simulcasting to Social Media Channels
- Clustering & Scaling
- WebRTC SDKs
- RTMP SDKs
- Android SDK
- iOS SDK
- Security
- Integration with your Project
- REST Guide
- Web Hooks
- AWS S3
- Azure Blob
- User-defined Scripts
- Advanced
- Load Testing
- REST API Reference
- WebRTC - WebSocket Messaging Reference
- Streaming Protocols
- Pixelating issue?
- How to Publish with Wirecast
- Nginx Load Balancer