~ubuntu-branches/ubuntu/oneiric/likewise-open/oneiric

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
                      =================================
                      README File for Likewise Open 5.4
                      =================================

Likewise Open has several goals:

(a) Simplify the process of joining non-Microsoft hosts to Active Directory
    domains,
(b) Simplify the management of these hosts, and
(c) Provide a rich development platform for writing applications in
    heterogeneous networks.

We hope you find this software useful.


                                            -- Gerald Carter
                                               Likewise Open Project Lead
                                               <gcarter@likewiseopen.org.>


Instructions on building likewise-open
======================================

The likewise-open build is driven by a series of shell scripts.
While the code is portable among a variety of *nix based platforms
(Linux, Solaris, AIX, HP-UX, and OS X), this build system is 
primarily intended for Linux & FreeBSD platforms.

You need at least the following minimum versions of the toolchain
components:

  * gcc >= 3.x
  * autoconf >= 2.61
  * libtool >= 2.2.4
  * automake >= 1.9.6
  * pkg-config >= 0.23

Before you begin, please read over this list of prerequisite development
packages (depending on your Linux distro):

  * RedHat/Fedora - gcc, autoconf, automake, e2fsprogs-devel,
    pam-devel, ncurses-devel, flex, bison, rpm-build, rpm-devel,
    openssl-devel

    Optional packages: 
       o libglade2-devel - To build domainjoin-gui GTK application
       o libattr-devel   - To enable extended attribute support for the 
                           Likewise CIFS server (experimental)

  * Ubuntu - build-essential, fakeroot, devscripts, debhelper,
    autoconf, automake, libtool, libncurses5-dev, uuid-dev,
    flex, bison, libpam0g-dev, libssl-dev

    Optional packages: 
       o libglade2-dev - To build domainjoin-gui GTK application
       o libattr1-dev  - To enable extended attribute support for the 
                         Likewise CIFS server (experimental)

  * SLES/SLED/openSUSE - TDB

The easiest way to begin a build is to run:

  $ build/mkcomp all

This will build the necessary components and install them to the
staging/install-root/ directory.  

You may then create a set of packages by executing (currently only debs
and rpms are supported)

  $ build/mkpkg all

Both mkcomp and mkpkg support the --debug option for including (and not
stripping) debug symbols.

If you are working directory from the likewise-open git tree, the
"'build/mkdist" script can be used to generate a release tarball file.


Note: It is currently necessary to manually import all the service
registry files after installing the packages.

  $ sudo bash -c 'for file in /etc/likewise/*reg; do \
      /opt/likewise/bin/regshell import $file; \
    done'


Likewise Registry Service
=========================

The Likewise Registry Service (lwregd) is the configuration data store
used by all Likewise services.  You can view and modify the registry
settings by running /opt/likewise/bin/regshell as the root user.  For
example:

  $ sudo /opt/likewise/bin/regshell
  > cd hkey_this_machine\\services

  hkey_this_machine\services> dir
  [hkey_this_machine\services]
  [HKEY_THIS_MACHINE\Services\lsass]
  ...

  hkey_this_machine\services> cd lsass

  hkey_this_machine\services\lsass> dir
  Arguments    REG_SZ   "lsassd --syslog"
  Dependencies REG_SZ   "netlogon lwio lwreg rdr"
  Description  REG_SZ    "Likewise Security and Authentication Subsystem"
  Path         REG_SZ    "/opt/likewise/sbin/lsassd"
  Type         REG_DWORD 0x00000001 (1)

  [HKEY_THIS_MACHINE\Services\lsass\Parameters]


Likewise Service Manager
========================

The Likewise Service Manager (lwsmd) provides a service control
architecture for starting and stopping all Likewise daemons and drivers
based on a dependency graph.

The lwsmd daemon itself is managed using the standard SysV init
script:

  $ /etc/init.d/lwsmd start
  * Starting Likewise Service Manager: lwsmd              [ OK ] 

Only the registry service (lwregd) is hard coded to be started
initially.  The user space CLI for managing services is the "lwsm"
utility.

  $ lwsm list
  lwreg       running (standalone: 19415)
  dcerpc      running (standalone: 19453)
  eventlog    stopped
  lsass       running (standalone: 19475)
  lwio        running (standalone: 19438)
  rdr         running (io: 19438)
  srv         running (io: 19438)
  pvfs        running (io: 19438)
  npfs        running (io: 19438)
  netlogon    running (standalone: 19468)
  srvsvc      running (standalone: 19529)

  $ lwsm info lsass
  Service: lsass
  Description: Likewise Security and Authentication Subsystem
  Type: executable
  Autostart: no
  Path: /opt/likewise/sbin/lsassd
  Arguments: 'lsassd' '--syslog'
  Dependencies: netlogon lwio lwreg rdr

  $ lwsm stop-all lsass
  Stopping service reverse dependency: srvsvc
  Stopping service reverse dependency: srv
  Stopping service: lsass

  $ lwsm start-all srvsvc
  Starting service dependency: lsass
  Starting service dependency: srv
  Starting service: srvsvc



Likewise-CIFS
=============

We are actively implementing a full SMBv1 and SMBv2 protocol stack in the
Likewise I/O Manager.  Some overview information and details about the
server architecture are available at http://www.likewiseopen.org/.
The server offers support for the following client architectures:

  * WinXP
  * Vista
  * Win2003/2008 (including R2)
  * Windows 7
  * OS 10.5 and later
  * Gnome Desktop smb:// URL

No support is planned for any client requiring port tcp/139 (e.g.
Windows 95, Linux smbfs, or OS X 10.4)

Be warned that the server represents active design and development.  It is
not recommended in any way for production use at this time.  If you are
interested in track Likewise development or just experimenting with
upcoming release feature, please note that the server drivers
(srv.sys.so, pvfs.sys.so, and npvfs.sys.so) are not loaded by default.
The easier way to start the CIFS server to for force the Likewise
Service Manager (lwsmd) to launch all the dependent services for the
srvsvcd daemon (lwsm start-all srvsvc)/

Finally, the SRV driver exports the /lwcifs directory as the C$ share.
This directory is created for you automatically and cannot currently
be disabled.

This following is a short list of known issues in the Likewise CIFS 
server:

  * No interaction with POSIX file permissions (uses Extended
    Attributes for storing the Windows security descriptor). (planned)
  * No file system integration with byte-range locks or change
    notification (planned)
  * Missing NT_CANCEL support (planned)
  * No raw NTLMSSP support (only NTLMSSP encapsulated inside SPNEGO) 
    (future)
  * No printing support (future)

That said, I am using the server for roaming user profiles, iTunes media
libraries, network home directories, "My Documents" redirection, and other
fundamental file services on a daily basis.


Getting Help
============

The main Likewise Open web site is at http://www.likewiseopen.org/.
From here you will find links to the project forums, and pre-built
package downloads.

If you find any bugs, please file a report at
   http://lobugs.likewiseopen.org/

There are also mailing lists available for developer interaction at
http://lists.likewiseopen.org/.  There is also a link to the user
community forums on the community section of likewise.com.

====