ODAVP: How to export ACFS using Samba-CIFS and mount it on local guest VM

Asset ID:	1-71-1968929.1
Update Date:	2018-03-16
Keywords:

Solution Type Technical Instruction Sure

Solution 1968929.1 : ODAVP: How to export ACFS using Samba-CIFS and mount it on local guest VM

Applies to:

Oracle Database Appliance - Version All Versions and later
Oracle Database Appliance Software - Version 12.1.2 and later
Information in this document applies to any platform.

Goal

The aim of this article is to show how to export ACFS using Samba/CIFS to local guest VM running MsWindows

Solution

Due to ACFS regression BUG:18596485 - LNX64-112-CMT: ACFS ASSERT EXPORTING IT USING CIFS
the content of this note can be applied on version 12.1.2.0.0 and above where the GridInfrastracture is 12c

Notes:
- The content of this note is applicable to ODA version 12.1.2.0.0 (GI 12c) and above
- This is NOT applicable to X5-2 with infinibad as interconnect. In such case you should use the public IP avoiding the private one

SAMBA

Please note as this is not a HA configuration and when the ODA_BASE from where you are exporting Samba/CIFS is down, also such filesystem will be done. You should consider to use HANFS feature instead (see ODAVP: HowTo export ACFS (cloudfs) using HANFS and mount it on local guest VM (Doc ID 1968843.1) )

How to export ACFS using Samba/CIFS

1. Setup the private network for your Guest VM

a. Reserve an ip from oda_base, as output you will get an ip, example: 192.168.16.51 . The export of the filesystem will happen over the private network providing better security and performance.

oakcli assign ip -vm <guestvm>

i.e.:
# oakcli assign ip -vm E1_ENT_1

Assigned IP: 192.168.16.51

b. If the private network is not attached to the VM, add it now. Attach the private oda network ("priv1") to your guest VM issuing

oakcli modify vm <guestvm> -addnetwork priv1

DO NOT use this command to assign network to HVM Guests (example: Windows guest without PV Drivers). For such
guests, use the “oakcli configure” command and specify the type=ioemu option as well along with the network bridge:

# oakcli configure vm <vm name> -network <List of networks and MAC address>

Example:
[root@oda9n1 ~]# oakcli configure vm myvm1 -network "['type=ioemu,bridge=net1', 'type=ioemu,bridge=priv1' ]"

# oakcli show vm myvm1 |grep -A 1 Networks
Networks : |type= ioemu,bridge=NET1||type=n
etfront,bridge=priv1|

c. check your guest VM vm.cfg
d. stop/start your VM

oakcli stop vm <guestvm>
oakcli start vm <guestvm>

2. Set your MTU for the Guest MsWindows VM

Make sure the Ms Windows guest has the MTU size for the private network as 9000 to be consistent with the ODA_Base.

a. Find your MTU

From an elevated Command Prompt in Windows enter the following command:

netsh interface ipv4 show subinterfaces

You should get something like this

   MTU MediaSenseState   Bytes In Bytes Out Interface
------ --------------- --------- --------- -------------
4294967295                1          0      56177 Loopback Pseudo-Interface 1
1500                1     484197      84221 Local Area Connection
1500                1       3608       7208 Local Area Connection 2

The guest network interface related to the private network is "Local Area Connection 2" as listed in second position by the command "oakcli show vm myvm1 |grep -A 1 Networks"

b. Set your MTU
From an elevated Command Prompt in Windows enter the following command:

netsh interface ipv4 set subinterface "Local Area Connection 2" mtu=9000 store=persistent

3. Set your IP on the private network for the Guest MsWindows VM

From an elevated Command Prompt in Windows, issue the following command:

netsh interface ip set address name=”<net interface name>” static <generated ip> 255.255.255.0

Example:
netsh interface ip set address name=”Local Area Connection 2” static 192.168.16.51 255.255.255.0

4. Make a samba/cifs base configuration on ODA_BASE

Edit '/etc/samba/smb.conf', example:

# cat /etc/samba/smb.conf
[global]
socket options = TCP_NODELAY SO_RCVBUF=8192 SO_SNDBUF=8192
load printers = no
show add printer wizard = no
printing = none
printcap name = /dev/null
disable spoolss = yes
encrypt passwords = yes

[ODA.ACFS.CIFS]
comment = all my files
path = /cloudfs
valid users = oracle
public = no
writable = yes
printable = no

(check Samba/CIFS manual for more options details)

5. Check smbd configuration file for internal correctness

testparm is a very simple test program to check an smbd configuration file for internal correctness. If this program reports no problems, you can use the configuration file with confidence that smbd will successfully load the configuration file.

testparm /etc/samba/smb.conf

6. Add authentication credentials

# smbpasswd -a oracle
New SMB password:
Retype new SMB password:

7. Start the Samba/CIFS service

# service smb start
Starting SMB services: [ OK ]
Starting NMB services: [ OK ]

8. Check if the samba export is working fine

# smbclient -L //<hostname>/<Samba/CIFS folder> -U oracle
Password:
Domain=[hostname] OS=[Unix] Server=[Samba 3.0.33-3.39.el5_8]

    Sharename       Type      Comment
    ---------       ----      -------
    ODA.ACFS.CIFS   Disk      all my files
    IPC$            IPC       IPC Service (Samba 3.0.33-3.39.el5_8)
Domain=[hostname] OS=[Unix] Server=[Samba 3.0.33-3.39.el5_8]

    Server               Comment
    ---------            -------

    Workgroup            Master
    ---------            -------
    WORKGROUP

9. Mount the Samba/CIFS on remote MsWindows

Map Network Drive issuing the following command:

net use s: \\<oda_base internal IP>\<samba export> /user <username> /P:Yes

Example:
net use s: \\192.168.16.27\ODA.ACFS.CIFS /user oracle /P:Yes

Note: as <oda_base internal IP> you should use the private interconnect IP for ODA_BASE as following:

ODA_BASE node0 --> 192.168.16.27
ODA_BASE node1 --> 192.168.16.28

Note: Mount the Samba/CIFS on Linux host

You can mount Samba/CIFS on a Linux guest (must have samba-client installed) as

mount -t cifs //<oda_base internal IP>/<Samba/CIFS folder> <mount point> -o <options>

ie:
mount -t cifs //192.168.16.27/ODA.ACFS.CIFS /mnt/cifs -o username=oracle,password=welcome1

References

http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/index.html
<BUG:18596485> - LNX64-112-CMT: ACFS ASSERT EXPORTING IT USING CIFS
<NOTE:1968843.1> - ODAVP: HowTo export ACFS (cloudfs) using HANFS and mount it on local guest VM

Attachments

This solution has no attachment