Running OpenSAF on Fedora14

Comments:

- You can probably disable SELinux during installation (but I forgot so I describe
howto disable it afterwards).

- By default OpenSAF uses MDS/TIPC as its internal messaging protocol. Since TIPC is
not enabled in Fedora kernels nor are the user space tools available. Let's configure
and use the new feature MDS/TCP. That simplifies things on Fedora.

Steps:

1. Install FC14 on some machine (I used VirtualBox)

2. Disable SeLinux and reboot (not needed if SELinux disabled at install)
- set the value of SELINUX in /etc/selinux/config to disabled
- reboot

3. Add OpenSAF repos to yum configuration: http://devel.opensaf.org/wiki/Yum

4. Install OpenSAF (as root):

[root@FC14-1]# yum install opensaf-controller
Loaded plugins: langpacks, presto, refresh-packagekit
Adding en_US to language list
Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package opensaf-controller.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
--> Processing Dependency: opensaf-libs = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-amf-nodedirector = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-log-server = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-ntf-server = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-amf-libs = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-clm-server = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-clm-nodeagent = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-amf-director = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-ntf-libs = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-log-libs = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-imm-director = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-clm-libs = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-imm-libs = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: opensaf-imm-nodedirector = 4.2.M0-201103230402.fc14 for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: libSaImmOi.so.0(OPENSAF_IMM_A.02.01)(64bit) for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: libSaImmOm.so.0(OPENSAF_IMM_A.02.01)(64bit) for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: libopensaf_core.so.0()(64bit) for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: libSaImmOm.so.0()(64bit) for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: librda.so.0()(64bit) for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: libSaAmf.so.0()(64bit) for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Processing Dependency: libSaImmOi.so.0()(64bit) for package: opensaf-controller-4.2.M0-201103230402.fc14.x86_64
--> Running transaction check
---> Package opensaf.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-amf-director.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-amf-libs.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-amf-nodedirector.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-clm-libs.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-clm-nodeagent.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-clm-server.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-imm-director.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-imm-libs.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-imm-nodedirector.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-libs.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-log-libs.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-log-server.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-ntf-libs.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
---> Package opensaf-ntf-server.x86_64 0:4.2.M0-201103230402.fc14 set to be installed
--> Finished Dependency Resolution

Dependencies Resolved

=============================================================================================================================================================================================================================================
 Package                                                       Arch                                        Version                                                        Repository                                                    Size
=============================================================================================================================================================================================================================================
Installing:
 opensaf-controller                                            x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                      167 k
Installing for dependencies:
 opensaf                                                       x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                       49 k
 opensaf-amf-director                                          x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                      276 k
 opensaf-amf-libs                                              x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                      113 k
 opensaf-amf-nodedirector                                      x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                      157 k
 opensaf-clm-libs                                              x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                       59 k
 opensaf-clm-nodeagent                                         x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                       11 k
 opensaf-clm-server                                            x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                       76 k
 opensaf-imm-director                                          x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                      214 k
 opensaf-imm-libs                                              x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                      344 k
 opensaf-imm-nodedirector                                      x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                      203 k
 opensaf-libs                                                  x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                      565 k
 opensaf-log-libs                                              x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                       56 k
 opensaf-log-server                                            x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                       63 k
 opensaf-ntf-libs                                              x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                      134 k
 opensaf-ntf-server                                            x86_64                                      4.2.M0-201103230402.fc14                                       opensaf-default-nightly                                       79 k

Transaction Summary
=============================================================================================================================================================================================================================================
Install      16 Package(s)

Total download size: 2.5 M
Installed size: 6.7 M
Is this ok [y/N]: y
Downloading Packages:
Setting up and reading Presto delta metadata
Processing delta metadata
Package(s) data still to download: 2.5 M
(1/16): opensaf-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                                   |  49 kB     00:00     
(2/16): opensaf-amf-director-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                      | 276 kB     00:01     
(3/16): opensaf-amf-libs-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                          | 113 kB     00:00     
(4/16): opensaf-amf-nodedirector-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                  | 157 kB     00:00     
(5/16): opensaf-clm-libs-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                          |  59 kB     00:00     
(6/16): opensaf-clm-nodeagent-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                     |  11 kB     00:00     
(7/16): opensaf-clm-server-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                        |  76 kB     00:00     
(8/16): opensaf-controller-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                        | 167 kB     00:00     
(9/16): opensaf-imm-director-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                      | 214 kB     00:01     
(10/16): opensaf-imm-libs-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                         | 344 kB     00:01     
(11/16): opensaf-imm-nodedirector-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                 | 203 kB     00:05     
(12/16): opensaf-libs-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                             | 565 kB     00:01     
(13/16): opensaf-log-libs-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                         |  56 kB     00:00     
(14/16): opensaf-log-server-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                       |  63 kB     00:00     
(15/16): opensaf-ntf-libs-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                         | 134 kB     00:00     
(16/16): opensaf-ntf-server-4.2.M0-201103230402.fc14.x86_64.rpm                                                                                                                                                       |  79 kB     00:00     
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Total                                                                                                                                                                                                         81 kB/s | 2.5 MB     00:31     
Running rpm_check_debug
Running Transaction Test
Transaction Test Succeeded
Running Transaction
  Installing     : opensaf-libs-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                         1/16 
  Installing     : opensaf-amf-libs-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                     2/16 
  Installing     : opensaf-imm-libs-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                     3/16 
  Installing     : opensaf-clm-libs-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                     4/16 
  Installing     : opensaf-ntf-libs-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                     5/16 
  Installing     : opensaf-log-libs-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                     6/16 
  Installing     : opensaf-clm-server-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                   7/16 
  Installing     : opensaf-ntf-server-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                   8/16 
  Installing     : opensaf-amf-director-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                 9/16 
  Installing     : opensaf-amf-nodedirector-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                            10/16 
  Installing     : opensaf-clm-nodeagent-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                               11/16 
  Installing     : opensaf-log-server-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                  12/16 
  Installing     : opensaf-imm-nodedirector-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                            13/16 
  Installing     : opensaf-imm-director-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                14/16 
  Installing     : opensaf-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                             15/16 
  Installing     : opensaf-controller-4.2.M0-201103230402.fc14.x86_64                                                                                                                                                                  16/16 
For information on how to configure the initial imm.xml file check the readme file: /usr/share/opensaf/immxml/README

Installed:
  opensaf-controller.x86_64 0:4.2.M0-201103230402.fc14                                                                                                                                                                                       

Dependency Installed:
  opensaf.x86_64 0:4.2.M0-201103230402.fc14               opensaf-amf-director.x86_64 0:4.2.M0-201103230402.fc14        opensaf-amf-libs.x86_64 0:4.2.M0-201103230402.fc14      opensaf-amf-nodedirector.x86_64 0:4.2.M0-201103230402.fc14   
  opensaf-clm-libs.x86_64 0:4.2.M0-201103230402.fc14      opensaf-clm-nodeagent.x86_64 0:4.2.M0-201103230402.fc14       opensaf-clm-server.x86_64 0:4.2.M0-201103230402.fc14    opensaf-imm-director.x86_64 0:4.2.M0-201103230402.fc14       
  opensaf-imm-libs.x86_64 0:4.2.M0-201103230402.fc14      opensaf-imm-nodedirector.x86_64 0:4.2.M0-201103230402.fc14    opensaf-libs.x86_64 0:4.2.M0-201103230402.fc14          opensaf-log-libs.x86_64 0:4.2.M0-201103230402.fc14           
  opensaf-log-server.x86_64 0:4.2.M0-201103230402.fc14    opensaf-ntf-libs.x86_64 0:4.2.M0-201103230402.fc14            opensaf-ntf-server.x86_64 0:4.2.M0-201103230402.fc14   

Complete!

5. Create /etc/opensaf/imm.xml as specified in /usr/share/opensaf/immxml/README.

Make sure to edit nodes.cfg, the line with SC-1, third column to match the short
hostname of the system.

6. Configure OpenSAF to use MDS/TCP:
- Go to /etc/opensaf
- Edit nodeinit.conf.controller and remove line with nid_tipc
- Edit nid.conf and set MDS_TRANSPORT=TCP
- Edit dtmd.conf and change DTM_NODE_IP to the IP address of the local/self node
- Create a custom login file for OpenSAF:
echo "export MDS_TRANSPORT=TCP" > /etc/profile.d/opensaf.sh

7. Start OpenSAF as root (or reboot):

[root@FC14-1 opensaf]# /etc/init.d/opensafd start
Starting OpenSAF Services:                                 [  OK  ]


8. Check status:

[root@FC14-1 opensaf]# /etc/init.d/opensafd status
safSISU=safSu=SC-1\,safSg=NoRed\,safApp=OpenSAF,safSi=NoRed2,safApp=OpenSAF
    saAmfSISUHAState=ACTIVE(1)
safSISU=safSu=SC-1\,safSg=2N\,safApp=OpenSAF,safSi=SC-2N,safApp=OpenSAF
    saAmfSISUHAState=ACTIVE(1)



9. Do some stuff:
- For example examine IMM content with the imm* commands
- Add an application (to be described later)

Comments

1. vwg874 -- 2011-07-12 10:58

Hi,

It works but the system controllers are not running as a redundant pair. All the components are running on one but not on other, for instance, the amf_Demo component:

safComp=AmfDemo?,safSu=SU1,safSg=AmfDemo?,safApp=AmfDemo?1

saAmfCompOperState=DISABLED(2) saAmfCompPresenceState=UNINSTANTIATED(1) saAmfCompReadinessState=OUT-OF-SERVICE(1)

safComp=AmfDemo?,safSu=SU2,safSg=AmfDemo?,safApp=AmfDemo?1

saAmfCompOperState=ENABLED(1) saAmfCompPresenceState=INSTANTIATED(3) saAmfCompReadinessState=IN-SERVICE(2)

Where do we configure the peer's ip address? how do we bring in the other component instance running on the peer as standby? Could you guide me to any manual on "How configuration is done in opensaf 4.0.0/4.1.1?"

Thanks, Amit

2. ramvvs -- 2011-08-04 07:33

Could you please extend this blog with adding a sample application to OpenSAF ? or provide some links related to this ? .. It will be helpful for beginners like me. Thanks a ton !

3. Santanu -- 2011-08-10 04:20

Hi Thanks, it helped. Some tips to run it on CentOS 5

Running OpenSAF on RHEL/CentOS 5


There are no rpm packages available for RHEL/CenOS5. But the following steps will get you through. 1)Download the opensaf source. I downloaded version 4.1.1 2)yum install libxml2 libxml2-devel autoconf gcc gcc-c++ 3)cd opensaf-source-dir ./configure make make install Compilation should go fine. In case it has some missing libraries , just install them. 4)Patch the file /etc/redhat-lsb/lsb_start_daemon This is a redhat bug. Patch available here  https://bugzilla.redhat.com/show_bug.cgi?id=485367 5)Do step 2 and then continue with 5 to 9 as mentioned here

4. Santanu -- 2011-08-10 04:24

Running OpenSAF on RHEL/CentOS 5


There are no rpm packages available for RHEL/CenOS5. But the following steps will get you through.

1)Download the opensaf source. I downloaded version 4.1.1
2)yum install libxml2 libxml2-devel autoconf gcc gcc-c++

3)cd opensaf-source-dir ./configure make make install Compilation should go fine. In case it has some missing libraries , just install them.

4)Patch the file /etc/redhat-lsb/lsb_start_daemon This is a redhat bug. Patch available here  https://bugzilla.redhat.com/show_bug.cgi?id=485367

5)Do step 2 and then continue with 5 to 9 as mentioned here