2. Advanced usage (for Infrastructure)
Estimated reading time: 5 minutes
This chapter describes the procedures for the operation and management of system infrastructure, such as DB backup, the customization of system architecture, etc.
2.1. How to back up and restore the database
This software uses a MongoDB as database software. Backup of this software is executed by backup methods of MongoDB. There are two methods of back up.
[1] Copying underlying files
It’s easy and fast, but you need to stop BRAVIA Signage Server while backing up.
[2] By using mongodump
You can back up while BRAVIA Signage Server is running, but much time is required to back up and restore. A sufficient PC spec is required when you back up while BRAVIA Signage Server is running because it requires many database accesses.
You can also use MMS (MongoDB Management Service). Refer to the official MongoDB web site on how to use MMS. Back up the database and restore with “Administrative Privileges”.
2.1.1. Backup by copying underlying files
Backup
[1] Open [Control Panel] [Security and System] [Administrative Tools], then open [Services].
[2] Select “BRAVIA Signage Server”, then right-click and select [Stop] in the [Services] window.
[3] Select “MongoDB”, then right-click and select [Stop] in the [Services] window.
[4] Copy the “C:\data\db” directory to any path as backup.
[5] Select “MongoDB”, then right-click and select [Start] in the [Services] window.
[6] Select “BRAVIA Signage Server”, then right-click and select [Start] in the [Services] window.
Restore
[1] Execute steps [1] to [3] of “Backup” in 2.1.1.
[2] Delete the “C:\data\db” directory.
[3] Copy a backup directory to “C:\data\db”.
[4] Execute steps [5] and [6] of “Backup” in 2.1.1.
2.1.2. Backup by using mongodump
Backup
[1] Run a command prompt with Administrative Privileges. Right-click the mouse button on the start menu and select the [Run as administrator] option from the Power User menu.
Run all of the following commands in Command Prompt with Administrative Privileges.
[2] Run the following command for backup. Specify any path for a backup file.
"C:\Program Files\MongoDB\Server\3.0\bin\mongodump.exe" --out "D:\mongo-backup"
Restore
[1] Execute the procedure [1] to [3] at “Backup” in 2.1.1.
[2] Delete the “C:\data\db” directory.
[3] Run the following command to create directories where database files will be saved.
mkdir C:\data\db
[4] Execute the procedure [5] at “Backup” in 2.1.1.
[5] Run the following command to restore. Specify the backed up file.
"C:\Program Files\MongoDB\Server\3.0\bin\mongorestore.exe" "D:\mongo-backup"
[6] Execute the procedure [6] at “Backup” in 2.1.1.
2.2. How to migrate the server
The following steps show how to run the BRAVIA Signage Server on other server PC with the existing data.
[1] Back up the database on the source server. Refer to 2.1. How to back up and restore the database on how to backup.
[2] Install the BRAVIA Signage Server on the destination server. Refer to “BRAVIA Signage User Guide” on how to install the server.
[3] Restore the database on the destination server. Refer to 2.1. How to back up and restore the database on how to backup.
2.3. How to operate MongoDB with a separate server PC
The following steps show how to separate PCs that the BRAVIA Signage Server and MongoDB run on.
[1] Install the BRAVIA Signage Server and MongoDB to separate PCs. Refer to “BRAVIA Signage User Guide” on how to install BRAVIA Signage and the official MongoDB web site on how to install MongoDB.
[2] Run a command prompt with Administrative Privileges. Right-click the mouse button on the start menu and select the [Run as administrator] option from the Power User menu.
[3] Run the following command to stop the BRAVIA Signage Server.
cd "c:\Program Files (x86)\SONY\BRAVIA Signage"
braviasignageserver.exe stop
[4] Run any text editor with Administrative Privileges, open “c:\Program Files (x86)\SONY\BRAVIA Signage\braviasignageserver.xml”, edit with the following procedures and save it. Refer to 1.2. How to run multiple services of the BRAVIA Signage Server for XML tag definitions. The following example shows a case where the Server IP address MongoDB runs on is “192.168.10.10”.
<service>
<id>braviasignageserver.exe</id>
<name>BRAVIA Signage Server</name>
<description>BRAVIA Signage Server</description>
<executable>%BASE%\node.exe</executable>
<arguments>--harmony "%BASE%\node_modules\node-windows\lib\wrapper.js" -f "%BASE%\server\app.js" -l "BRAVIA Signage Server" -g 0.25 -w 1 -r 3 -a n</arguments>
<logmode>reset</logmode>
<startmode>Automatic</startmode>
<env name="NODE_ENV" value="production"/>
<env name="PORT" value="50000"/>
<env name="MONGO_URI" value="mongodb://192.168.10.10/braviasignage"/>
</service>
[5] Run the following command to restart the BRAVIA Signage Server.
cd "c:\\Program Files (x86)\\SONY\\BRAVIA Signage"
braviasignageserver.exe start
2.4. Reverse Proxy Server configurations
BRAVIA Signage Server communicates with BRAVIA Signage Player and a browser (Operation Web Application) on the client PC. You can insert the reverse proxy server between these. This section describes the configuration.
Configuration for BRAVIA Signage
[1] config.txt of BRAVIA Signage Player
The “server” key must NOT be the URL of BRAVIA Signage Server. It MUST BE the URL of the reverse proxy server. The directory name can also be included in the URL specified in the “server” key of config.txt For example, “http://192.169.10.10:50000/dir1/dir2” can be specified in the “server” key.
Configuration for reverse proxy server
[2] Communication between BRAVIA Signage Player and Reverse Proxy Server
BRAVIA Signage Player accesses the URL starting with “/socket.io-player/” in the communication with BRAVIA Signage Server. Configure the proxy pass of the reverse proxy server to “http://{server-ip:service-port}/socket.io-player/”. {server-ip:service-port} indicates the server IP address which BRAVIA Signage Server runs on and the BRAVIA Signage Server port number.
[3] Communication between Operation Web Application and Reverse Proxy Server
Operation Web Application accesses the URL starting with “/” in the communication with BRAVIA Signage Server. Configure the proxy pass of the reverse proxy server to “http://{server-ip:service-port}/”.