Tuesday, April 1, 2008

Samba Server on ATV

AwkwardTV Community & Forums • View topic - SMB in reverse
First of all big thanks to user adn77. Both for his instructions and for the Binaries that he has sent. My thanks are well overdue!

I have finally got the Samba server running on the AppleTV, so I would like to write a little explanation of what I did to get there!
I am not a big computer person, so if I did it, probably anyone can do it!

1. I don't know if it is legal to publish the link to the binaries on this forum, but if you don't have a mac in the house (and this is probably the reason why you want the smb server in the first place!) you will need to get hold of the binaries somehow. On the other hand samba is a free package, so I don't know why it would be illegal to distribute the binaries of it!

2. Untar the binaries in the root folder of your appletv. I am not too clever so I could not untar the file on appletv, so I used winrar to unpack the file on the PC and used SSH to copy the entire /opt directory onto AppleTV - nice and easy

3. I have had the most problems editing /etc/rc.local. The file is write protected and it is not possible to change permissions using winscp.
Hence used the comand (from putty): sudo ed /etc/rc.local Using ed was a pain but I managed to add the recommended lines to the file:
/opt/local/sbin/smbd -c /opt/local/etc/samba3/smb.conf
/opt/local/sbin/nmbd -c /opt/local/etc/samba3/smb.conf

4. It is necessary to change the permissions and ownership for /opt/local/sbin/smbd and /opt/local/sbin/nmbd I used the instructions for ATVLoader to do this and used the following commands (using putty):
sudo chown root:wheel /opt/local/sbin/smbd
sudo chmod 4555 /opt/local/sbin/smbd
sudo chown root:wheel /opt/local/sbin/nmbd
sudo chmod 4555 /opt/local/sbin/nmbd

5. You will need to change the permissions for your Movies folder: /mnt/Scratch/Users/frontrow/Movies as well as Torrents, Documents, etc. You can use WinSCP to do this by right-clicking on a Movies and allowing guestes and user to change and delete files (basically tick all boxes!)


6. Copy the file /opt/local/etc/samba3/smb.conf.sample to /opt/local/etc/samba3/smb.conf and edit to your linking. Mine looks like this:

# This is the main Samba configuration file. You should read the
# smb.conf(5) manual page in order to understand the options listed
# here. Samba has a huge number of configurable options (perhaps too
# many!) most of which are not shown in this example
#
# For a step to step guide on installing, configuring and using samba,
# read the Samba-HOWTO-Collection. This may be obtained from:
# http://www.samba.org/samba/docs/Samba-H ... ection.pdf
#
# Many working examples of smb.conf files can be found in the
# Samba-Guide which is generated daily and can be downloaded from:
# http://www.samba.org/samba/docs/Samba-Guide.pdf
#
# Any line which starts with a ; (semi-colon) or a # (hash)
# is a comment and is ignored. In this example we will use a #
# for commentry and a ; for parts of the config file that you
# may wish to enable
#
# NOTE: Whenever you modify this file you should run the command "testparm"
# to check that you have not made any basic syntactic errors.
#
#======================= Global Settings =====================================
[global]

# workgroup = NT-Domain-Name or Workgroup-Name, eg: MIDEARTH
workgroup = MSHOME

# server string is the equivalent of the NT Description field
server string = AppleTV Samba Server

# Security mode. Defines in which mode Samba will operate. Possible
# values are share, user, server, domain and ads. Most people will want
# user level security. See the Samba-HOWTO-Collection for details.
security = user

# This option is important for security. It allows you to restrict
# connections to machines which are on your local network. The
# following example restricts access to two C class networks and
# the "loopback" interface. For more examples of the syntax see
# the smb.conf man page
; hosts allow = 192.168.1. 192.168.2. 127.

# If you want to automatically load your printer list rather
# than setting them up individually then you'll need this
load printers = no

# you may wish to override the location of the printcap file
; printcap name = /etc/printcap

# on SystemV system setting printcap name to lpstat should allow
# you to automatically obtain a printer list from the SystemV spool
# system
; printcap name = lpstat

# It should not be necessary to specify the print system type unless
# it is non-standard. Currently supported print systems include:
# bsd, cups, sysv, plp, lprng, aix, hpux, qnx
; printing = cups

# Uncomment this if you want a guest account, you must add this to /etc/passwd
# otherwise the user "nobody" is used
; guest account = pcguest

# this tells Samba to use a separate log file for each machine
# that connects
; log file = /usr/local/samba/var/log.%m

# Put a capping on the size of the log files (in Kb).
max log size = 50

# Use password server option only with security = server
# The argument list may include:
# password server = My_PDC_Name [My_BDC_Name] [My_Next_BDC_Name]
# or to auto-locate the domain controller/s
# password server = *
; password server =

# Use the realm option only with security = ads
# Specifies the Active Directory realm the host is part of
; realm = MY_REALM

# Backend to store user information in. New installations should
# use either tdbsam or ldapsam. smbpasswd is available for backwards
# compatibility. tdbsam requires no further configuration.
; passdb backend = tdbsam

# Using the following line enables you to customise your configuration
# on a per machine basis. The %m gets replaced with the netbios name
# of the machine that is connecting.
# Note: Consider carefully the location in the configuration file of
# this line. The included file is read at that point.
; include = /usr/local/samba/lib/smb.conf.%m

# Configure Samba to use multiple interfaces
# If you have multiple network interfaces then you must list them
# here. See the man page for details.
; interfaces = 192.168.12.2/24 192.168.13.2/24

# Browser Control Options:
# set local master to no if you don't want Samba to become a master
# browser on your network. Otherwise the normal election rules apply
; local master = no

# OS Level determines the precedence of this server in master browser
# elections. The default value should be reasonable
; os level = 33

# Domain Master specifies Samba to be the Domain Master Browser. This
# allows Samba to collate browse lists between subnets. Don't use this
# if you already have a Windows NT domain controller doing this job
; domain master = yes

# Preferred Master causes Samba to force a local browser election on startup
# and gives it a slightly higher chance of winning the election
; preferred master = yes

# Enable this if you want Samba to be a domain logon server for
# Windows95 workstations.
; domain logons = yes

# if you enable domain logons then you may want a per-machine or
# per user logon script
# run a specific logon batch file per workstation (machine)
; logon script = %m.bat
# run a specific logon batch file per username
; logon script = %U.bat

# Where to store roving profiles (only for Win95 and WinNT)
# %L substitutes for this servers netbios name, %U is username
# You must uncomment the [Profiles] share below
; logon path = \\%L\Profiles\%U

# Windows Internet Name Serving Support Section:
# WINS Support - Tells the NMBD component of Samba to enable it's WINS Server
; wins support = yes

# WINS Server - Tells the NMBD components of Samba to be a WINS Client
# Note: Samba can be either a WINS Server, or a WINS Client, but NOT both
; wins server = w.x.y.z

# WINS Proxy - Tells Samba to answer name resolution queries on
# behalf of a non WINS capable client, for this to work there must be
# at least one WINS Server on the network. The default is NO.
; wins proxy = yes

# DNS Proxy - tells Samba whether or not to try to resolve NetBIOS names
# via DNS nslookups. The default is NO.
dns proxy = no

# These scripts are used on a domain controller or stand-alone
# machine to add or delete corresponding unix accounts
; add user script = /usr/sbin/useradd %u
; add group script = /usr/sbin/groupadd %g
; add machine script = /usr/sbin/adduser -n -g machines -c Machine -d /dev/null -s /bin/false %u
; delete user script = /usr/sbin/userdel %u
; delete user from group script = /usr/sbin/deluser %u %g
; delete group script = /usr/sbin/groupdel %g


#============================ Share Definitions ==============================
;[homes]
; comment = Home Directories
; browseable = yes
; writable = yes

# Un-comment the following and create the netlogon directory for Domain Logons
; [netlogon]
; comment = Network Logon Service
; path = /usr/local/samba/lib/netlogon
; guest ok = yes
; writable = no
; share modes = no


# Un-comment the following to provide a specific roving profile share
# the default is to use the user's home directory
;[Profiles]
; path = /usr/local/samba/profiles
; browseable = no
; guest ok = yes


# NOTE: If you have a BSD-style print system there is no need to
# specifically define each individual printer
[printers]
comment = All Printers
path = /usr/spool/samba
browseable = no
# Set public = yes to allow user 'guest account' to print
guest ok = no
writable = no
printable = no

# This one is useful for people to share files
;[tmp]
; comment = Temporary file space
; path = /tmp
; read only = no
; public = yes

# A publicly accessible directory, but read only, except for people in
# the "staff" group
;[public]
; comment = Public Stuff
; path = /home/samba
; public = yes
; writable = yes
; printable = no
; write list = @staff

# Other examples.
#
# A private printer, usable only by fred. Spool data will be placed in fred's
# home directory. Note that fred must have write access to the spool directory,
# wherever it is.
;[fredsprn]
; comment = Fred's Printer
; valid users = fred
; path = /homes/fred
; printer = freds_printer
; public = no
; writable = no
; printable = yes

# A private directory, usable only by fred. Note that fred requires write
# access to the directory.
;[fredsdir]
; comment = Fred's Service
; path = /usr/somewhere/private
; valid users = fred
; public = no
; writable = yes
; printable = no

# a service which has a different directory for each machine that connects
# this allows you to tailor configurations to incoming machines. You could
# also use the %U option to tailor it by user name.
# The %m gets replaced with the machine name that is connecting.
;[pchome]
; comment = PC Directories
; path = /usr/pc/%m
; public = no
; writable = yes

# A publicly accessible directory, read/write to all users. Note that all files
# created in the directory by users will be owned by the default user, so
# any user with access can delete any other user's files. Obviously this
# directory must be writable by the default user. Another user could of course
# be specified, in which case all files would be owned by that user instead.
[movies]
path = /mnt/Scratch/Users/frontrow/Movies
public = yes
browsable = yes
only guest = yes
writable = yes
printable = no

# The following two entries demonstrate how to share a directory so that two
# users can place files there that will be owned by the specific users. In this
# setup, the directory should be writable by both users and should have the
# sticky bit set on it to prevent abuse. Obviously this could be extended to
# as many users as required.
;[myshare]
; comment = Mary's and Fred's stuff
; path = /usr/somewhere/shared
; valid users = mary fred
; public = no
; writable = yes
; printable = no
; create mask = 0765



7. I still have a problem that AppleTV is called Localhost. No problems for Windows XP, but Vista is not happy!!!!!!!

8. It is possible to mount the remote folders (in my case it is \\Localhost\movies) as a drive: N: for example.

9. If you have installed nitoTV and all other fun stuff that comes with it, your US connected drives will be mounted into Movies folder, and you will be able to access them from your PC, hence you can use AppleTV as a NAS!!

I hope someone can edit this into a proper howto!



1.)
I may as well supply a download link for everyone, as the package should only contain open source binaries...
http://netpbx.de/tmp/samba3_macports_bin.tar.bz2
(this is 25MB in size, as I did not strip the compile down it contains openssl and cups libraries for example)

2.)
I am not sure anymore if the appleTV contained a "bunzip2", if so you can unpack the whole thing via:
Code: Select all
cd /
bunzip2 -C /samba3_macports_bin.tar.bz2| tar -xf -

Otherwise unzip it on another platform using "bunzip2" and untar it on the appleTV.
Code: Select all
cd /
tar -xf /samba3_macports_bin.tar.bz2


3.)
I like "nano" as a Texteditor (unfortunatly not readily available on the appleTV).
But you can do the following without having to mess with the awful "ed"
Code: Select all
sudo echo "/opt/local/sbin/smbd -c /opt/local/etc/samba3/smb.conf" >> /etc/rc.local
sudo echo "/opt/local/sbin/nmbd -c /opt/local/etc/samba3/smb.conf" >> /etc/rc.local


4.)
You might want to set the executable flags on some more programs in the "/opt/local/bin" folder.
If you used the un-tar on the appleTV method as decribed above, all priviledges should be already in place.

5.+6.)
I was using WinXP and set the smb.conf line "security=" to Share-Level security
Code: Select all
...
security = share
...
[yourfunnyshare]
comment = Whatever you please
path = /mnt
public = yes
writable = yes
browsable = yes

(see http://us3.samba.org/samba/docs/man/man ... onf.5.html for further information on "smb.conf")

For any real user shares one would need to setup some appleTV users and use "smbpasswd" in order to create those users for SAMBA as well.
On a Mac users are created with
Code: Select all
sudo niutil -create / /users/[username]
sudo niutil -createprop / /users/[username] uid [numerical UID]
sudo niutil -createprop / /users/[username] gid [numerical GID]
sudo mkdir /Users/[username]
sudo chown -R [username]:[groupname] /Users/[username]
sudo niutil -createprop / /users/[username] home /Users/[username]
sudo niutil -createprop / /users/[username] shell /usr/bin/false

(also see http://docs.info.apple.com/article.html?artnum=30760 for additional information)

In order to actually use these other users, it might be necessary to run Samba with root privileges (sudo)...

7.)
How did you assign the IP to the appleTV? Can you resolve other hostnames?

for NETBIOS name advertising this line in the [global] section of your smb.conf might help.
Code: Select all
netbios name = APPLETV



If the appleTV's IP is static you could also try
Code: Select all
sudo echo " appleTV<.your.domain> appleTV" >> /etc/hosts


Alex

No comments: