Quick Install

Following is a quick overview of the steps required to be accomplished for compiling and installing the Media Server from its source. If you are new to use this procedure, skip over to Step 1 for a detailed description of all these requirements.

mkdir imsmrf

svn co https://imsmrf.svn.sourceforge.net/svnroot/imsmrf imsmrf

cd imsmrf/sourcecode

./autogen.sh --prefix=/usr --datarootdir=/etc --enable-debug=no --enable-opt=8 --enable-snmp=yes --enable-ms-trace=yes –enable-media-trace=yes

make

make instal

WebManager

Check out the latest ManagerApp NetBeans project from SVN.

To build the application, simply use NetBeans Build operation.

WebManager is dependent on various third party libraries and following NetBeans Project modules which should be

in class path of the current project. In case “Resolve Reference Problem” error is popped up from NetBeans then

adjust the libraries path in the project properties which should be [Project Folder]/lib/[Library Name] and checkout

following projects from SVN. Also adjust the project properties to add these projects in classpath if not so already.

   1. SNMPManager
   2. TrapServer

By default building WebManager project module will build SNMPManager and TrapServer projects. However if any source code changes are performed on other projects, those project should be built using NetBeans standard build operation and then WebManager project should be rebuild to reflect the latest changes.
Before deployment following actions should be considered as pre-requisite:
MYSQL DATABASE SETUP
• Install latest MySQL distribution from MySQL along with latest distribution of MySQL GUI Tools.
• Get the latest OAMP MySQL dump from SVN.
• Use MySQL Administrator application to create the schema named OAMP and then restore the downloaded dump file.

APACHE TOMCAT SETUP
• Usually NetBeans ships with built-in apache tomcat distribution, however if it isn’t available you’ll have to download (Apache Tomcat) and register the server in NetBeans. Please refer to NetBeans.org for more details on registering external Tomcat server with the IDE. Server registration is not only used to deploy the application but also to build the application without errors.
• After installing tomcat following action must be performed to enable application security:
• Open [CATALINA_HOME]/conf/Server.xml and add comment out current realm. Then copy and paste the following realm in the server.xml.

<Realm className="org.apache.catalina.realm.JDBCRealm"
debug="99"
driverName="com.mysql.jdbc.Driver" connectionURL="jdbc:mysql://localhost:3306/oamp?
user=root&amp;password=rootroot"
userTable="tbl_users"
userNameCol="username"
userCredCol="password"
userRoleTable="tbl_user_roles" roleNameCol="role_name"
/>

Note: Change the database connection settings according to your own MySQL installation.

OPENJMS SETUP
Download and install OpenJMS and add a topic named TrapsTopic using OpenJMS admin application client. This topic is published from OAMP web service and Network Analyzer listens to this topic to get Trap notifications and details instantly. For more information on this visit OpenJMS Official Web Site.
WEBMANAGER CONFIGURATIONS SETTINGS
• Modify the file in sources:
[Project Folder]\src\java\org\ict\oamp\config\appconfig.xml and change the settings to your own MySQL installation settings.
After performing all above tasks, rebuild the project once again. If you want to deploy the application using NetBeans then just simply right click on the project node and click deploy. If all goes well then application will be available on [tomcat host URL:port /webmanager]. In case some errors were encountered then check Tomcat logs for details.

TRAP Server
Trap server project deploys as part of the WebManager (ManagerApp project).
To build the application though please reset the libraries path from the project properties.

SNMP Manager
Like Trap Server project SNMP Manager project also deploys with WebManager and to build the project from NetBeans reset the libraries path from Project Properties menu option.
Note: for both projects lib directory in project folders contain all the required third party library jars.

Network Analyzer
To build the project, checkout the latest AdvoSSNetworkAnalyzer NetBeans project from SVN.
This project depends on various third party library jars contained in lib folder of the project home directory. Also this project is dependent on OAMPServiceClient project. It is advisable to checkout OAMPServiceClient NetBeans project when working for Network Analyzer application.
Network Analyzer is a desktop application so no deployment is required. Just click the NetBeans standard Run command to run the project.
When client is running, click Tools>Settings from menu bar. A dialog box will appear in which provide the WebManager HTTP URL according to your own installation. Leave the service name unchanged.