Installing MediaBeacon for Rich Media EditionAdded by IBM on June 18, 2013 | Version 1 (Original, Show current)
|Before you can use assets from MediaBeacon R3volution Enterprise, you must install and configure the MediaBeacon server. You can install MediaBeacon on the same server as the portal or on a separate server.
Before you can set up MediaBeacon integration, ensure that you complete these steps:
- InstallIBM® WebSphere® Portal V18.104.22.168 or IBM Web Content Manager V22.214.171.124 with Combined Cumulative Fix 06.
- Obtain the installation media, either physical or electronic, for MediaBeacon R3volution Enterprise. For more information about getting the media, see Getting the Rich Media Edition software.
These instructions describe the general steps that are required to set up the MediaBeacon server with the optimal default configuration for integration with Web Content Manager. For detailed instructions on theMediaBeacon server configuration, see the MediaBeacon product documentation.
Start the MediaBeacon setup program, and follow the wizard panels to install the server.
- Access the MediaBeacon installation program.
- cd linux_install_root/mediabeacon/bin
- Windows: Run the MediaBeacon64.exe file.
Start the MediaBeacon console.
Specify the temporary product license information.
- Read and accept the license agreement.
- Choose a shared files directory to store digital assets, such as images, videos, and documents. The default folder is named MBAssets.
- Select a custom port number and web address to use to access assets.
You can change this setting later.
- Select Disable E-mail for the email notifications setting.
You can enable notifications later.
- Enter an administrator password.
This password is used to log in to the MediaBeacon server with the manager account. Record the password for future reference. You can change this setting later.
- Specify the HTML5 video support settings.
- Select a performance option for the server.
You can change this setting later.
- Click Done to complete the installation.
Disable sharing on startup and stop the MediaBeacon server.
- Access the IBM Temporary License from the mediabeacon_license_key.txt file in the root folder of your installation media.
Note: The IBM Temporary License provides a 30-day temporary license. After installation and configuration are complete, there are extra steps to configure your permanent license.
- In the Product License window, enter the name to associate with this license and the license key as specified in the IBM Temporary License.
- Click Enter License.
- On the License window, click Activate.
- On the Activation screen window, click Activate Now.
Set up pre-configured workspaces and default users in MediaBeacon.
- In the MediaBeacon console, click Admin.
- Clear the Enable sharing on MediaBeacon startup check box.
- Click Stop MediaBeacon.
Install a database server for use with MediaBeacon.
This configuration ensures better integration with Web Content Manager. Perform these steps on the MediaBeacon server.
- Stop the MediaBeacon server, and close the MediaBeacon console.
- Ensure that you defined a shared files directory for digital assets. The default folder is named MBAssets. The folder is typically defined during installation, but if you prefer, you can change the folder location after installation.
- Stop both the MediaBeacon server and program.
- Delete any folders in the MBAssets folder that begin with m.
Examples of typical folders include m-archive-userinfo, m-layouts, and m-themes. For a new installation, it is likely that there are no folders yet.
- Delete the temporary directory for the MediaBeacon program.
- Linux: /root/.mediabeacon
- Windows: C:\Users\Administrator\Appdata\local\MediaBeacon
Note: By default, the Appdata folder is a hidden folder. To see this folder, change your folder options to show hidden files and folders.
- Copy the contents of the mediabeacon_install_root/MediaBeacon/etc/custom directory into the MBAssets directory.
Start the MediaBeacon console.
Click the Enterprise tab.
Configure MediaBeacon to use the external database server.
To enable communication with the portal server, you must configure MediaBeacon to use a remote database. The embedded database that is provided with MediaBeacon cannot be used. See the MediaBeacon documentation for more information about supported external databases.
MediaBeacon uses a separate database than the portal server. You can use the same installation of database software to manage the databases, or you can use separate installations.
If you intend to use an existing database installation with the MediaBeacon server, use one of the following options before you configure MediaBeacon to use the database:
- Clean out all non-system tables in the existing database.
- Plan to use a new database for MediaBeacon data.
In the Authentication field, specify the type of authentication to use with the MediaBeacon server.
- Select External database.
- In the Database type field, select the type of database server that you are using.
- Enter the access information for the database.
- Click Verify to confirm that MediaBeacon can connect to the database.
Update the authentication information file for your authentication type.
When a user in the portal wants to access an asset from MediaBeacon, the portal logs in to the MediaBeacon server with that user's credentials. For this reason, both servers must use the same credentials when they communicate with each other. You can ensure that the credentials match in two ways:
- Both servers can share a single LDAP directory.
- You can define the same users and passwords in both servers.
Select the appropriate authentication method:
If you are using an LDAP directory with your portal to manage users and groups, you can use the same LDAP directory with your MediaBeacon server.
- Select the type of LDAP directory that you are using with the portal.
IBM Tivoli Directory note: If you select IBM Tivoli Directory Server, ensure that you also select Ignore LDAP group information.
- Enter the access information for the LDAP directory.
If you are not using an LDAP directory to manage users and groups, select Standard. With this setting, you must manually create the same users from the portal in MediaBeacon.
To work with users and groups in MediaBeacon, access the MediaBeacon web interface, and select Admin -> Setup.
Important: For each user, the short name and password on the MediaBeacon server must match the short name and password for the same user on the portal server.
- Edit the appropriate file, which is in the mediabeacon_install_root/etc directory.
Update the section bean with the ID of principalStore and add or change the defaultGroupName property.
- IBM Tivoli Directory Server: auth-ibmds-nogroups.xml
- Oracle Internet Directory: auth-oid.xml
- No LDAP directory: auth-standard.xml
Enable communication with service-oriented architecture (SOA) applications, such as the portal.
<property name="defaultGroupName"><value>Content Users</value></property>
Authorize the portal to communicate with the MediaBeacon server.
Communication between the portal and MediaBeacon takes place through a SOAP interface. SOAP is a specification for the exchange of structured information in a decentralized, distributed environment.
- Select External SOA applications.
- Click Change Remote Password, and enter a password for remote applications to use when they access MediaBeacon. WebSphere Portal uses these credentials to contact the MediaBeacon server.
- In the Port field, specify the port number for remote applications to use when they access MediaBeacon.
On the Enterprise tab, click Apply to save your changes.
Restart the MediaBeacon server.
- Click Applications.
- Click Add, and then enter the IP address for the portal server.
Complete the license registration.
- Click the Admin tab.
- Click Stop MediaBeacon, and then click Start MediaBeacon.
- Verify that the server started successfully.
In the MediaBeacon console, click Start MediaBeacon to start the server.
Disable the extended view in MediaBeacon for the Content Administrators and Content Users groups.
- From a web browser, log in to the MediaBeacon server.
This URL is specified on the Sharing tab of the MediaBeacon console.
- Log in with the user manager, and specify the administrator password that you entered during the setup process.
If you changed this password after setup, the password is specified in the Admin Password field on the Admin tab in the console.
- Click the Content Users tab in the browser to change the view.
- In the widget entitled Using Temporary License, scroll down and click Click to permanently activate WCM_RME MB.
- In the MediaBeacon console, click Stop MediaBeacon on the Admin tab.
- Close the MediaBeacon console.
- Reopen the MediaBeacon console.
- Click Activate and then Activate Now to complete the registration process.
Parent topic: Setting up MediaBeacon integration for Rich Media Edition
Next topic: Configuring the portal for MediaBeacon (Rich Media Edition)
Getting the Rich Media Edition software
- In a browser, log in to the MediaBeacon server with a user ID that has administrator access, such as the manager ID.
Example URL: http://www.example.com:55555/gwtmain/GwtMain.html
- Click Admin -> Setup -> Groups.
- Click Content Administrators -> Permissions -> Edit.
- In the list of privileges, select No for the Enable Full Extended View field.
- Click Done, and save your changes for the group.
- Click Content Users, and repeat the steps to disable the extended view for the Content Users group.