Changes

===Prerequisites===

===Prerequisites===

The current releases of SME do not support Samba Server Roles directly.  Modification of several core SME packages is required to support Samba Server Roles, therefore it is not possible to provide Advanced Samba functions with a typical Contrib RPM.   

The current releases of SME Server do not support Samba server roles directly.  Modification of several core SME Server packages is required to support Samba server roles, therefore it is not possible to provide advanced Samba functions with a typical contrib RPM.   

An effort to update the necessary Core SME packages is being tracked in the following SME bug report:

An effort to update the necessary core SME Server packages is being tracked in the following SME Server bug report:

http://bugs.contribs.org/show_bug.cgi?id=4172

[[bugzilla:4172]].

It is the Maintainers opinion that these changes will ultimately be included in the core SME packages.   When this occurs, it is very likely that this section of this contrib will go away.

It is the maintainers opinion that these changes will ultimately be included in the core SME Server packages. When this occurs, it is very likely that this section of this contrib will be removed.

Until these changes are incorporated into the core packages, patched versions of the current release SME packages will be provided as part of this contrib.  It is necessary that users install these "patched" core packages to take advantage of Samba Server Roles.  EVERY effort is made to provide this additional functionality without changing standard SME functionality. In other words, the patched core SME packages will not change they way SME currently functions -- the modified core packages simply provide the additional Server Role functionality.   

Until these changes are incorporated into the core packages, patched versions of the current release SME Server packages will be provided as part of this contrib.  It is necessary that users install these "patched" core packages to take advantage of Samba server roles.  '''Every''' effort is made to provide this additional functionality without changing standard SME Server functionality. In other words, the patched core SME Server packages will not change the way SME Server currently functions -- the modified core packages simply provide the additional server role functionality.   

====Install necessary patched packages====

====Install necessary patched packages====

1. Download the patched Server Role RPMs from my contribs repository to your local machine: http://mirror.contribs.org/contribs/gzartman/Contribs/7/Samba/

1. Download the patched server role RPMs from my contribs repository to your local machine: http://mirror.contribs.org/contribs/gzartman/Contribs/7/Samba/

2. Install the patched rpms:   

2. Install the patched RPMs:   

  yum localinstall *.rpm

  yum localinstall *.rpm

  signal-event post-upgrade; signal-event reboot.

  signal-event post-upgrade; signal-event reboot.

===Install Advanced Samba RPMS===

===Install advanced Samba RPMS===

It is necessary to install one addition RPM prior to configuring SME Server in advanced server roles. This package provides necessary Samba functionality that may not be available in Core SME packages:

It is necessary to install one additional RPM prior to configuring SME Server in advanced server roles. This package provides necessary Samba functionality that may not be available in Core SME Server packages:

1. Download smeserver-adv-samba package to your local machine:

1. Download smeserver-adv-samba package to your local machine:

  signal-event post-upgrade; signal-event reboot

  signal-event post-upgrade; signal-event reboot

=== Configure Server Roles ===

=== Configure server roles ===

As most of those familiar with SME Server know, much of configuration (management) of the SME Server can be done through the Server Manager.  The current SME Server Manager provides a panel, Workgroup, which provides the Administrator the ability to configure SME Server as either a Workgroup Server of a Primary Domain Controller.  NOTHING presented in this Contrib (software or documentation) will change this.  We have worked to provide seamless integration of new functionality with the current SME Server -- nothing will change if you desire to stick with the standard options.

As most of those familiar with SME Server know, much of configuration (management) of the SME Server can be done through the server-manager.  The current SME Server server-manager provides a panel, Workgroup, which provides the Administrator the ability to configure SME Server as either a workgroup server of a primary domain controller.  Nothing presented in this contrib (software or documentation) will change this.  We have worked to provide seamless integration of new functionality with the current SME Server -- nothing will change if you desire to stick with the standard options.

However, further functionality with respect to Samba Server Roles is provided via shell command line options (Note: It is this authors desire to add further functionality to the Server Manager with respect to Server Roles -- perhaps it will happen one day.  I do understand the Development Teams desire to take a conservative stance on functionality)

However, further functionality with respect to Samba server roles is provided via shell command line options  

Advanced Samba Server Role Support is provided as follows:

{{Note box|It is this authors desire to add further functionality to the server-manager with respect to server roles -- perhaps it will happen one day.  I do understand the development teams desire to take a conservative stance on functionality)}}

==== Workgroup Server ====

This Server Role configures SME Server to function as a member of a MS Windows Peer-To-Peer network. In order to access network shares on the SME machine when it is configured in this Server Role, users/clients must have local user accounts on the SME machine.  This is the simplest of MS Network configurations.  In this Server Role, SME will act as a typical Windows Client (e.g., Win 95, Win XP, Win 2000, etc.)   

 

==== Workgroup server ====

This server role configures SME Server to function as a member of a Microsoft Windows peer-to-peer network. In order to access network shares on the SME Server machine when it is configured in this server role, users/clients must have local user accounts on the SME Server machine.  This is the simplest of Microsoft network configurations.  In this server role, SME Server will act as a typical Windows client (e.g., Win 95, Win XP, Win 2000, etc.)   

=====Configuration=====

=====Configuration=====

''Currently supported via the standard Server Manager Panel''

''Currently supported via the standard Server Manager Panel''

==== Primary Domain Controller ====

==== Primary domain controller ====

This Server Role configures SME Server to function as a Windows NT4 type Domain Controller.   

This server role configures SME Server to function as a Windows NT4 type domain controller.   

=====Configuration=====

=====Configuration=====

''Currently supported via the standard Server Manager Panel''

''Currently supported via the standard server-manager panel''

==== Domain Member ====

==== Domain member ====

In this Server Mode, SME Server will act as a File and/or Print Server to an existing Windows Network Domain. User/Client accounts on the local machine are not required to access Domain Member resources (shares).  Ibays created will be presented as standard Windows shares.

In this server role, SME Server will act as a file and/or print server to an existing Windows network domain. User/client accounts on the local machine are not required to access domain member resources (shares).  Ibays created will be presented as standard Windows shares.

=====Configuration=====

=====Configuration=====

1. Open a shell (bash) session and log into your SME box with root access.

1. Open a SME Server shell session and log into your SME Server box with root access.

2. At the bash prompt:

2. At the SME Server prompt:

  config setprop smb ServerName machine_name_of_domain_member_box

  config setprop smb ServerName machine_name_of_domain_member_box

3. At the bash prompt:

3. At the SME Server prompt:

  config setprop smb ServerRole DM

  config setprop smb ServerRole DM

4. At the bash prompt:

4. At the SME Server prompt:

  config setprop smb WINSServer ip_address_of_domain_PDC

  config setprop smb WINSServer ip_address_of_domain_PDC

     status=enabled

     status=enabled

6. At bash prompt:

6. At SME Server prompt:

  signal-event workgroup-update

  signal-event workgroup-update

For example:

For example:

  [root@testbed2 ~]# signal-event workgroup-update

  [root@testbed2 ~]# signal-event workgroup-update

7. At the bash prompt:

7. At the SME Server prompt:

  net rpc join -U pdc_admin_username%pdc_admin_password

  net rpc join -U pdc_admin_username%pdc_admin_password

Output:

Output:

Also, take specific note of the format of the net command above.  The admin username and password MUST follow the -U flag, otherwise the command will fail.  This is due to a bug in the net command in the current version of samba.}}

Also, take specific note of the format of the net command above.  The admin username and password MUST follow the -U flag, otherwise the command will fail.  This is due to a bug in the net command in the current version of samba.}}

8.  At the bash prompt:

8.  At the SME Server prompt:

  signal-event workgroup-update.

  signal-event workgroup-update

Your SME Domain Client box shares should now be accessable.

Your SME Server domain client box shares should now be accessible.

==== Backup Domain Controller ====

==== Backup domain controller ====

Preliminary support for this Server Role Only.  DO NOT TO ATTEMPT to deploy this Server Role on SME Server unless you are very experienced with SME Server.  

{{Warning box|Preliminary support for this server role only.  Do '''not''' attempt to deploy this server role on SME Server unless you are very experienced with SME Server.}}

SME Server support for this Server Role is coming soon.  

SME Server support for this server role is coming soon.  

Please report all bugs and comments to the bug tracker. Thank you.

{{Note box|Please report all bugs and comments to the bug tracker. Thank you.}}

==== Active Directory Domain Controller ====

==== Active Directory domain controller ====

Preliminary support for this Server Role Only.  DO NOT TO ATTEMPT to deploy this Server Role on SME Server unless you are very experienced with SME Server.  

{{Warning box|Preliminary support for this server role only.  Do '''not''' attempt to deploy this server role on SME Server unless you are very experienced with SME Server.}}

SME Server support for this Server Role is coming soon.  

SME Server support for this server role is coming soon.  

Please report all bugs and comments to the bug tracker. Thank you.

{{Note box|Please report all bugs and comments to the bug tracker. Thank you.}}

==== Active Directory Domain Member ====

==== Active Directory domain member ====

Preliminary support for this Server Role Only.  DO NOT TO ATTEMPT to deploy this Server Role on SME Server unless you are very experienced with SME Server.  

{{Warning box|Preliminary support for this server role only.  Do '''not''' attempt to deploy this server role on SME Server unless you are very experienced with SME Server.}}

SME Server support for this Server Role is coming soon.  

SME Server support for this server role is coming soon.  

Please report all bugs and comments to the bug tracker. Thank you.

{{Note box|Please report all bugs and comments to the bug tracker. Thank you.}}

=== Known Issues ===

=== Known Issues ===

=== Bugs ===

=== Bugs ===

Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}.

Please raise bugs under the SME Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}.

 

[[Category: Contrib]]

[[Category: Contrib]]

[[Category: Webapps]]

[[Category: Webapps]]