|
Lines 1-22
Link Here
|
| 1 |
Firebird 1.0.2 FreeBSD Release Notes 05-Jan-2003 |
1 |
Firebird 1.5.0 FreeBSD Release Notes 11-Jan-2004 |
| 2 |
-------------------------------------- |
2 |
-------------------------------------- |
| 3 |
FB-T6.2.908 Firebird Final Release |
3 |
FB-V1.5.0.4201 Firebird 1.5 Release Candidate 8 |
| 4 |
|
4 |
|
| 5 |
Welcome to the FreeBSD Firebird port! Users should note that there |
5 |
Welcome to the FreeBSD Firebird port! |
| 6 |
was a package called `firebird-1.0.tgz' released in mid-August |
|
|
| 7 |
2000. Unfortunately, that package was released before Firebird |
| 8 |
version numbering conventions were established, so although the |
| 9 |
version number would suggest that it is newer than the current |
| 10 |
release, it is certainly not. Users of the August 1.0 package |
| 11 |
should upgrade to 0.9_4 or later, which has fixed many bugs and |
| 12 |
security problems, including the recently-discovered back door. |
| 13 |
|
| 14 |
Firebird originally required a running copy of Firebird (or |
| 15 |
InterBase) in order to build itself. This port uses a boot kit to |
| 16 |
overcome that, so that it does not require itself to build. |
| 17 |
Unfortunately, the side effect of this is that if you have a lock |
| 18 |
manager running from an already-installed version of Firebird or |
| 19 |
InterBase, this port will not build. |
| 20 |
|
6 |
|
| 21 |
Firebird is installed SUID with owner and group `firebird'. |
7 |
Firebird is installed SUID with owner and group `firebird'. |
| 22 |
This does affect where you can and cannot create databases when |
8 |
This does affect where you can and cannot create databases when |
|
Lines 30-41
Link Here
|
| 30 |
do this is to build and install the port. :) If this happens, |
16 |
do this is to build and install the port. :) If this happens, |
| 31 |
make sure that the lock manager is not running and its semaphores |
17 |
make sure that the lock manager is not running and its semaphores |
| 32 |
have been removed. The former can be accomplished with 'ps ax |
18 |
have been removed. The former can be accomplished with 'ps ax |
| 33 |
|grep gds' and 'kill'; the latter with 'ipcs -s' and 'ipcrm -s'. |
19 |
|grep fb' and 'kill'; the latter with 'ipcs -s' and 'ipcrm -s'. |
| 34 |
|
20 |
|
| 35 |
For example, after building and installing the port, you will |
21 |
For example, after building and installing the port, you will |
| 36 |
probably go through something like this: |
22 |
probably go through something like this: |
| 37 |
|
23 |
|
| 38 |
# isql /usr/interbase/isc4.gdb |
24 |
# isql /usr/local/firebird/security.fdb |
| 39 |
Statement failed, SQLCODE = -902 |
25 |
Statement failed, SQLCODE = -902 |
| 40 |
|
26 |
|
| 41 |
operating system directive semget failed |
27 |
operating system directive semget failed |
|
Lines 62-75
Link Here
|
| 62 |
|
48 |
|
| 63 |
/usr/local/etc/rc.d/pgsql.sh stop |
49 |
/usr/local/etc/rc.d/pgsql.sh stop |
| 64 |
|
50 |
|
| 65 |
and see if that helps. |
51 |
and see if that helps. Alternatively, increase the value of SEMMNS |
|
|
52 |
by 48 in your kernel configuration file. This can be found by getting |
| 53 |
the current value with 'sysctl -a | grep semmns'. You can either add |
| 54 |
this to your kernel config, or add the following line to /boot/loader.conf: |
| 55 |
|
| 56 |
kern.ipc.semmns=X |
| 57 |
|
| 58 |
where is is the current value plus 48. If this doesn't resolve the issue, |
| 59 |
try adding 48 again. |
| 60 |
|
| 61 |
Please note that RC8 has changed the libgds.so symlink to point to |
| 62 |
libfbembed.so. This has been done to resolve compatability issues with |
| 63 |
older versions of Firebird. The FreeBSD port of RC7 had libgds.so |
| 64 |
pointing to libfbclient.so. libfbclient.so is a remote access-only |
| 65 |
shared library with threaded support, which requires target applications |
| 66 |
to link with a threaded library such as libc_r.so, libkse.so or libthr.so. |
| 67 |
|
| 68 |
Super Server support in Firebird 1.5 for FreeBSD is not currently |
| 69 |
available due to the Firebird code using POSIX threads APIs not available |
| 70 |
in FreeBSD 4.x or not yet complete in FreeBSD 5.x. This issue will become |
| 71 |
more important once the scalability issues of Super Server have been |
| 72 |
resolved. |
| 73 |
|
| 74 |
This installation has already inserted the necessary line to |
| 75 |
/etc/inetd.conf so that you can connect to Firebird across the network. |
| 76 |
However you may need to add the remote host to /etc/hosts.equiv. For |
| 77 |
example, to allow the local machine to make connections to Firebird |
| 78 |
using TCP, the following command needs running: |
| 79 |
|
| 80 |
echo localhost >> /etc/hosts.equiv |
| 81 |
|
| 82 |
Please note that adding machines to /etc/hosts.equiv can reduce the |
| 83 |
security of your system. If in doubt, try connecting to Firebird with |
| 84 |
a username and password already defined in security.fdb. For example: |
| 85 |
|
| 86 |
gsec |
| 87 |
> add myuser -pass mypass |
| 88 |
> quit |
| 89 |
isql -u myuser -p mypass localhost:/usr/local/firebird/examples/employee.fdb |
| 66 |
|
90 |
|
| 67 |
Super Server support has recently been added. However, there is |
91 |
This should reduce the need for hosts defined in /etc/hosts.equiv. |
| 68 |
anecdotal evidence that it is not as reliable nor as scalable as the |
|
|
| 69 |
Classic Server version. For this reason, I have not included a |
| 70 |
start up method for Super Server. For those that are interested, |
| 71 |
traversing to /usr/interbase/misc will find the startup scripts for |
| 72 |
the various flavours of Linux. |
| 73 |
|
92 |
|
| 74 |
Complete documentation for InterBase(tm) is available (free of |
93 |
Complete documentation for InterBase(tm) is available (free of |
| 75 |
charge) from http://www.interbase.com/ in PDF format. While |
94 |
charge) from http://www.interbase.com/ in PDF format. While |
|
Lines 82-86
Link Here
|
| 82 |
http://www.interbase2000.org/ |
101 |
http://www.interbase2000.org/ |
| 83 |
http://www.firebirdsql.org/ |
102 |
http://www.firebirdsql.org/ |
| 84 |
|
103 |
|
|
|
104 |
Please also see the doc directory in the Firebird package for |
| 105 |
documentation specific to Firebird. |
| 106 |
|
| 85 |
Chris Knight |
107 |
Chris Knight |
| 86 |
<chris@aims.com.au> |
108 |
<chris@aims.net.au> |