IPBrick Reference Manual

Transcription

IPBrick Reference Manual
IPBrick
Reference Guide
Version 5.0
iPortalMais
August 2008
2
c
Copyright iPortalMais
All rights reserved. August 2008.
The information in this manual is submitted to changes without previous communication. The presented explanations, technical data, configurations and recommendations are precise and trustful. Nevertheless they have no expressed or
implied guarantees.
Reference Guide - Version 5.0
iPortalMais - 2008
Contents
1 Aim of this document
13
2 Before Starting
15
3 IPBrick.I
3.1 Machines Groups . . . . . . .
3.2 Machine Management . . . .
3.2.1 Mass Operations . . .
3.3 User Groups . . . . . . . . . .
3.4 Users Management . . . . . .
3.4.1 Mass Operations . . .
3.5 Domain Server . . . . . . . .
3.5.1 Configure . . . . . . .
3.5.2 Users Management . .
3.6 File Server . . . . . . . . . . .
3.6.1 Individual Work Areas
3.6.2 Group Work Areas . .
3.6.3 Kaspersky . . . . . . .
3.7 E-Mail . . . . . . . . . . . . .
3.7.1 Configure . . . . . . .
3.7.2 Definitions . . . . . . .
3.7.3 Queue Management . .
3.7.4 Users management . .
3.7.5 Mailing Lists . . . . .
3.7.6 Kaspersky Anti-Vı́rus .
3.7.7 Kaspersky Anti-Spam
3.8 Print Server . . . . . . . . . .
3.9 Backup . . . . . . . . . . . . .
3.9.1 Bacula . . . . . . . . .
3.9.2 Remote . . . . . . . .
3.10 Fax Server . . . . . . . . . . .
3.10.1 Fax2Mail . . . . . . .
3.10.2 Mail2Fax . . . . . . .
3.10.3 Statistics . . . . . . . .
3.11 Terminal Server . . . . . . . .
3.11.1 Configuration . . . . .
17
17
18
20
23
25
28
31
32
32
32
33
34
37
41
42
47
48
49
53
54
59
62
65
66
66
69
70
74
74
76
77
iPortalMais - 2008
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Reference Guide - Version 5.0
4
CONTENTS
3.11.2 Client configuration . . . . . . . . . . . . . . . . . . . . . . . 81
4 IPBrick.C
4.1 Firewall . . . . . . . . . . . . . . . . . . .
4.1.1 Available Services . . . . . . . . . .
4.1.2 Block Services . . . . . . . . . . . .
4.2 Proxy . . . . . . . . . . . . . . . . . . . .
4.2.1 Configuration . . . . . . . . . . . .
4.2.2 Statistics . . . . . . . . . . . . . . .
4.2.3 Kaspersky Proxy . . . . . . . . . .
4.3 VPN . . . . . . . . . . . . . . . . . . . . .
4.3.1 PPTP . . . . . . . . . . . . . . . .
4.3.2 IPSec . . . . . . . . . . . . . . . .
4.3.3 SSL . . . . . . . . . . . . . . . . .
4.4 E-mail . . . . . . . . . . . . . . . . . . . .
4.4.1 Advanced relay . . . . . . . . . . .
4.4.2 Get Mail from ISP . . . . . . . . .
4.4.3 Mail Copy . . . . . . . . . . . . . .
4.5 Web Server . . . . . . . . . . . . . . . . .
4.5.1 Creating a new site . . . . . . . . .
4.5.2 Management . . . . . . . . . . . . .
4.6 Webmail . . . . . . . . . . . . . . . . . . .
4.7 FTP Server . . . . . . . . . . . . . . . . .
4.7.1 Access log . . . . . . . . . . . . . .
4.8 VoIP . . . . . . . . . . . . . . . . . . . . .
4.8.1 Phone management . . . . . . . . .
4.8.2 Services . . . . . . . . . . . . . . .
4.8.3 Monitoring . . . . . . . . . . . . .
4.8.4 Routes Management . . . . . . . .
4.8.5 Music on Hold . . . . . . . . . . . .
4.9 IM . . . . . . . . . . . . . . . . . . . . . .
4.9.1 Enabling / disabling the IM server
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
85
85
85
86
86
87
96
97
100
100
102
104
108
108
108
111
112
112
114
118
120
122
123
123
125
141
147
152
152
154
5 Advanced Configurations
5.1 IPBrick . . . . . . . . . .
5.1.1 Definitions . . . . .
5.1.2 System Information
5.1.3 Web Access . . . .
5.1.4 Authentication . .
5.1.5 Update . . . . . . .
5.2 Network . . . . . . . . . .
5.2.1 Firewall . . . . . .
5.2.2 Route management
5.2.3 QOS . . . . . . . .
5.2.4 Service Routing . .
5.3 Support services . . . . . .
5.3.1 LDAP . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
159
159
159
161
161
164
167
168
168
171
172
174
187
187
Reference Guide - Version 5.0
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
iPortalMais - 2008
CONTENTS
5.4
5.5
5.6
5.3.2 DNS . . . . . . . .
5.3.3 DHCP . . . . . . .
5.3.4 ENUM . . . . . . .
Disaster recovery . . . . .
5.4.1 Configurations . . .
5.4.2 Applications . . . .
System . . . . . . . . . . .
5.5.1 Services . . . . . .
5.5.2 Task Manager . . .
5.5.3 Date and Hour . .
5.5.4 System users . . .
5.5.5 Monitoring . . . .
5.5.6 SSH . . . . . . . .
5.5.7 Reboot . . . . . . .
5.5.8 Shutdown . . . . .
Telephony . . . . . . . . .
5.6.1 Cards . . . . . . .
5.6.2 Registered Phones
5.6.3 Configurations . . .
5.6.4 Interfaces . . . . .
5.6.5 SIP peers . . . . .
5.6.6 IAX peers . . . . .
5
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
6 Apply Configurations
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
188
192
198
200
200
202
204
204
205
206
206
207
210
211
211
211
212
214
216
224
226
226
231
7 Appendix A - Join in the domain
233
7.1 Windows XP Professional Workstation . . . . . . . . . . . . . . . . 233
8 Appendix B - Configuring a VPN connection
237
9 Appendix C - Configuration of a VPN SSL connection (Open
VPN)
239
9.1 Two or more SSL certificates . . . . . . . . . . . . . . . . . . . . . . 239
9.2 Configuration of a SSL Connection for Windows Vista . . . . . . . 240
10 Appendix D - Backup Service - Arkeia
241
10.1 Advanced Administration . . . . . . . . . . . . . . . . . . . . . . . 242
iPortalMais - 2008
Reference Guide - Version 5.0
6
Reference Guide - Version 5.0
CONTENTS
iPortalMais - 2008
List of Figures
3.1
3.2
3.3
3.4
3.5
3.6
3.7
3.8
3.9
3.10
3.11
3.12
3.13
3.14
3.15
3.16
3.17
3.18
3.19
3.20
3.21
3.22
3.23
3.24
3.25
3.26
3.27
3.28
3.29
3.30
3.31
3.32
3.33
3.34
3.35
3.36
Machine Groups - List . . . . . . . . . . . . . .
Machine Groups - Example . . . . . . . . . . .
Machines Management - Machine registration .
Machines Management - Options . . . . . . . .
Machines Management - List . . . . . . . . . . .
Machine Management - Export . . . . . . . . .
Machine Management - Mass Operations . . . .
User Groups - Group creation . . . . . . . . . .
User Groups - Groups List . . . . . . . . . . . .
User Groups - Users . . . . . . . . . . . . . . .
Users Management - Insert . . . . . . . . . . . .
Users Management - List . . . . . . . . . . . . .
Users Management - Operations . . . . . . . . .
Users Management - Modify . . . . . . . . . . .
Domain Server - Definitions . . . . . . . . . . .
Domain server - Users Management . . . . . . .
Work Areas - Summary . . . . . . . . . . . . . .
Work Areas - List . . . . . . . . . . . . . . . . .
Work Areas - Summary of Individual Areas . .
Work Areas - List . . . . . . . . . . . . . . . . .
Work Areas - Group - Insert with recycle bin . .
Work Areas - Group - Insert without recycle bin
Work Areas - Group - Management . . . . . . .
Work Areas - Group - Users Access . . . . . . .
Workareas - Kaspersky Licence . . . . . . . . .
Workareas - Kaspersky - Configure 1/2 . . . . .
Workareas - Kaspersky - Configure 2/2 . . . . .
Workareas - Kaspersky . . . . . . . . . . . . . .
Workareas - Kaspersky - Statistics 1/2 . . . . .
Workareas - Kaspersky - Statistics 2/2 . . . . .
E-mail - Configure . . . . . . . . . . . . . . . .
E-Mail - Definitions 1/2 . . . . . . . . . . . . .
E-Mail - Definitions 2/2 . . . . . . . . . . . . .
E-Mail - Definitions - Valid internal recipients .
E-Mail - Definitions - Invalid senders . . . . . .
E-Mail - Queue Management . . . . . . . . . . .
iPortalMais - 2008
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
18
19
20
21
22
23
24
25
26
27
28
29
30
31
33
34
35
36
37
38
39
40
41
42
43
44
45
45
46
46
47
49
50
50
51
51
Reference Guide - Version 5.0
8
LIST OF FIGURES
3.37
3.38
3.39
3.40
3.41
3.42
3.43
3.44
3.45
3.46
3.47
3.48
3.49
3.50
3.51
3.52
3.53
3.54
3.55
3.56
3.57
3.58
3.59
3.60
3.61
3.62
3.63
3.64
3.65
3.66
3.67
3.68
3.69
3.70
3.71
E-mail - Users Management . . . . . . . . . . . . . . . . . . . .
E-Mail - Alternative addresses, Forwarding and automatic replys
E-Mail - Mailing List - Insert . . . . . . . . . . . . . . . . . . .
E-Mail - Mailing List - Users . . . . . . . . . . . . . . . . . . . .
E-Mail - Mailing List - External users . . . . . . . . . . . . . . .
E-Mail - Kaspersky Anti-Vı́rus . . . . . . . . . . . . . . . . . . .
E-Mail - Kasp. Anti-Vı́rus - General Configurations . . . . . . .
E-Mail - Kasp. Anti-Vı́rus - Groups Management . . . . . . . .
E-Mail - Kasp. Anti-Vı́rus - Notification Rules . . . . . . . . . .
E-Mail - Kasp. Anti-Vı́rus - Filter . . . . . . . . . . . . . . . . .
E-Mail - Kasp. Anti-Vı́rus - Statistics 1/2 . . . . . . . . . . . .
E-Mail - Kasp. Anti-Vı́rus - Statistics 2/2 . . . . . . . . . . . .
E-Mail - Kasp. Anti-Spam - Protected Domains . . . . . . . . .
E-Mail - Kasp. Anti-Spam - Actions . . . . . . . . . . . . . . .
E-Mail - Kasp. Anti-Spam - Rules . . . . . . . . . . . . . . . . .
E-Mail - Kasp. Anti-Spam - Statistics . . . . . . . . . . . . . . .
Print Server - Inserting a network printer at IPBrick . . . . . .
Print Server - Printer configurations . . . . . . . . . . . . . . . .
Backup - Task insertion . . . . . . . . . . . . . . . . . . . . . .
Backup - Task list . . . . . . . . . . . . . . . . . . . . . . . . . .
Fax Server - Configure . . . . . . . . . . . . . . . . . . . . . . .
Fax Server - FAX at telephony card . . . . . . . . . . . . . . . .
Fax Server - Serial Fax Modem . . . . . . . . . . . . . . . . . .
Fax Server - Fax Users . . . . . . . . . . . . . . . . . . . . . . .
Fax Server - Fax line definitions . . . . . . . . . . . . . . . . . .
Fax Server - Sent Faxes . . . . . . . . . . . . . . . . . . . . . . .
Fax Server - Received Faxes . . . . . . . . . . . . . . . . . . . .
Fax Server - Current Faxes . . . . . . . . . . . . . . . . . . . . .
Terminal Server - General Configuration - 1/2 . . . . . . . . . .
Terminal Server - General Configuration - 2/2 . . . . . . . . . .
Terminal Server - Boot System configuration . . . . . . . . . . .
Terminal Server - Boot Loader configuration . . . . . . . . . . .
Terminal Server - Operating System . . . . . . . . . . . . . . . .
Terminal Server - Configuration for PXE boot . . . . . . . . . .
Terminal Server - Machines . . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
52
53
54
55
56
56
57
57
58
58
59
60
61
62
63
64
65
65
67
68
69
71
72
73
73
75
75
76
79
80
80
81
81
82
82
4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
4.9
4.10
Firewall - Available Services . . . . .
Firewall - Block Services . . . . . . .
Proxy - Configuration . . . . . . . . .
Proxy - Rules 1/2 . . . . . . . . . . .
Proxy - Rules 2/2 . . . . . . . . . . .
Proxy - Source groups . . . . . . . .
Proxy - Source groups - LDAP filter .
Proxy - Destination groups . . . . . .
Proxy - Access Lists . . . . . . . . .
Proxy - Remote Proxy . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
87
88
89
90
91
92
92
93
94
95
Reference Guide - Version 5.0
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
iPortalMais - 2008
LIST OF FIGURES
4.11
4.12
4.13
4.14
4.15
4.16
4.17
4.18
4.19
4.20
4.21
4.22
4.23
4.24
4.25
4.26
4.27
4.28
4.29
4.30
4.31
4.32
4.33
4.34
4.35
4.36
4.37
4.38
4.39
4.40
4.41
4.42
4.43
4.44
4.45
4.46
4.47
4.48
4.49
4.50
4.51
4.52
4.53
4.54
4.55
4.56
9
Proxy - Other configurations . . . . . . . . . . . . . .
Proxy - Statistics . . . . . . . . . . . . . . . . . . . .
Proxy - Kaspersky - Licence . . . . . . . . . . . . . .
Proxy - Kaspersky - General Settings . . . . . . . . .
Proxy - Kaspersky - Statistics . . . . . . . . . . . . .
VPN - PPTP - Users . . . . . . . . . . . . . . . . . .
VPN - IPSec Configuration 1/2 . . . . . . . . . . . .
VPN - IPSec Configuration 2/2 . . . . . . . . . . . .
VPN - SSL Settings . . . . . . . . . . . . . . . . . . .
E-Mail - Advanced relay . . . . . . . . . . . . . . . .
E-Mail - Get Mail from ISP - Base menu . . . . . . .
E-Mail - Get mail from ISP - Servers Management . .
E-Mail - Get mail from ISP - Add Account . . . . . .
E-Mail - Mail copy . . . . . . . . . . . . . . . . . . .
Web Server - Hosted sites . . . . . . . . . . . . . . .
Web Server - Adding sites . . . . . . . . . . . . . . .
Web Server - Features . . . . . . . . . . . . . . . . .
Web Server - Alias 1 . . . . . . . . . . . . . . . . . .
Web Server - Alias 2 . . . . . . . . . . . . . . . . . .
Web Server - Alias List . . . . . . . . . . . . . . . . .
Web Server - Redirect - Example 1 . . . . . . . . . .
Web Server - Redirect - Example 2 . . . . . . . . . .
Web Server - Redirections List . . . . . . . . . . . . .
Web Server - Reverse Proxy - Example 1 - Empty site
Web Server - Reverse Proxy - Example 1 - Add . . .
Web Server - Reverse Proxy - Example 2 - Add . . .
Web Server - Reverse Proxy - Example 2 - List . . . .
Web Server - Statistics . . . . . . . . . . . . . . . . .
WebMail - Servers . . . . . . . . . . . . . . . . . . .
FTP Server - Account definitions . . . . . . . . . . .
VoIP - Registered Phones . . . . . . . . . . . . . . .
VoIP - Alternative Addresses . . . . . . . . . . . . .
VoIP - Call groups . . . . . . . . . . . . . . . . . . .
VoIP - Sequence definitions . . . . . . . . . . . . . .
VoIP - Attendance sequences list . . . . . . . . . . .
VoIP - IVR attendance configuration . . . . . . . . .
VoIP - Call conference insertion . . . . . . . . . . . .
VoIP - Call conference list . . . . . . . . . . . . . . .
VoIP - Dynamic call conferences . . . . . . . . . . . .
VoIP - Call Parking . . . . . . . . . . . . . . . . . . .
VoIP - Call Parking - Modify . . . . . . . . . . . . .
VoIP - Scheduling . . . . . . . . . . . . . . . . . . . .
VoIP - Scheduling - Insert rules . . . . . . . . . . . .
VoIP - Scheduling - Rules list . . . . . . . . . . . . .
VoIP - DISA - Insert . . . . . . . . . . . . . . . . . .
VoIP - Call queue definitions . . . . . . . . . . . . . .
iPortalMais - 2008
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
created
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
97
98
98
99
100
101
104
105
106
109
110
110
111
112
113
114
115
116
116
117
117
118
118
119
119
120
120
121
121
122
124
125
126
128
129
130
131
131
132
132
133
133
135
135
136
138
Reference Guide - Version 5.0
10
LIST OF FIGURES
4.57
4.58
4.59
4.60
4.61
4.62
4.63
4.64
4.65
4.66
4.67
4.68
4.69
4.70
4.71
4.72
4.73
4.74
VoIP - Call queue members . . . . . . . . .
VoIP - Call queue agents . . . . . . . . . . .
VoIP - Access Classes - Insert . . . . . . . .
VoIP - Access Classes - Members . . . . . .
VoIP - Speed Dial . . . . . . . . . . . . . . .
VoIP - Online phones . . . . . . . . . . . . .
VoIP - Statistics filter . . . . . . . . . . . .
VoIP - Call Manager configuration . . . . .
VoIP - Call Manager . . . . . . . . . . . . .
VoIP - Routes Management . . . . . . . . .
VoIP - Local Routes . . . . . . . . . . . . .
VoIP - Outbound route definition . . . . . .
VoIP - Prefix definition . . . . . . . . . . . .
VoIP - SIP server for registering . . . . . . .
VoIP - Music on hold . . . . . . . . . . . . .
IM - Enabling Instant Messaging Server . .
IM - Blocking MSN applications . . . . . . .
IM - Web messenger sites blocking in firewall
5.1
5.2
5.3
5.4
5.5
5.6
5.7
5.8
5.9
5.10
5.11
5.12
5.13
5.14
5.15
5.16
5.17
5.18
5.19
5.20
5.21
5.22
5.23
5.24
5.25
5.26
5.27
Advanced Configurations - Definitions . . . . .
Advanced Configurations - System Information Advanced Configurations - System Information Advanced Configurations - Web Access . . . . .
Advanced Configurations - Language . . . . . .
Advanced Configuration - Authentication . . . .
Advanced Configurations - Update . . . . . . .
Network - Firewall . . . . . . . . . . . . . . . .
Network - Firewall - General settings rule . . . .
Network - Firewall - Disable access rule . . . . .
Network - Firewall - DNAT rule . . . . . . . . .
Network - Firewall - Order . . . . . . . . . . . .
Network - Route management . . . . . . . . . .
Network - QoS management . . . . . . . . . . .
Network - QOS - General Configurations . . . .
Network - Service Routing . . . . . . . . . . . .
Support Services - LDAP . . . . . . . . . . . . .
Support Services - DNS - Name resolution zones
Support Services - DNS - Zone Management 1/2
Support Services - DNS - Zone Management 2/2
Support Services - DNS - Forwarders . . . . . .
Support Services - DNS - Name resolution . . .
Support Services - DHCP - Subnets . . . . . . .
Support Services - DHCP - General Options . .
Support Services - DHCP - Subnets Definition .
Support Services - DHCP - Redundancy . . . .
Support Services - DHCP - Machines . . . . . .
Reference Guide - Version 5.0
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
139
140
141
142
143
143
145
145
146
147
149
151
152
153
153
155
156
157
. . .
1/2
2/2
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
161
162
163
164
165
166
168
169
171
172
173
174
175
176
177
178
187
189
192
193
194
195
196
197
198
198
199
iPortalMais - 2008
LIST OF FIGURES
11
5.28
5.29
5.30
5.31
5.32
5.33
5.34
5.35
5.36
5.37
5.38
5.39
5.40
5.41
5.42
5.43
5.44
5.45
5.46
5.47
5.48
5.49
5.50
5.51
5.52
5.53
5.54
5.55
5.56
5.57
5.58
Support Services - ENUM . . . . . . . . . . . . . . . . . . .
Disaster Recovery - Replace configuration . . . . . . . . . .
Disaster Recovery - Download configuration . . . . . . . . .
Disaster Recovery - Upload configuration . . . . . . . . . . .
Disaster Recovery - Applications - Data backups list . . . . .
Disaster Recovery - Applications - Data restore confirmation
System - Services . . . . . . . . . . . . . . . . . . . . . . . .
System - Task Manager . . . . . . . . . . . . . . . . . . . . .
System - Date and Hour . . . . . . . . . . . . . . . . . . . .
System - System users . . . . . . . . . . . . . . . . . . . . .
System - Monitoring - System Logs . . . . . . . . . . . . . .
System - SSH . . . . . . . . . . . . . . . . . . . . . . . . . .
System - Reboot . . . . . . . . . . . . . . . . . . . . . . . .
System - Shutdown . . . . . . . . . . . . . . . . . . . . . . .
Telephony - Cards - Insert . . . . . . . . . . . . . . . . . . .
Telephony - Card definitions . . . . . . . . . . . . . . . . . .
Telephony - Cards list . . . . . . . . . . . . . . . . . . . . .
Telephony - Simple phone register . . . . . . . . . . . . . . .
Telephony - Configurations . . . . . . . . . . . . . . . . . . .
Telephony - Analog and ISDN PRI options . . . . . . . . . .
Telephony - ISDN BRI options . . . . . . . . . . . . . . . .
Telephony - Configurations - Codecs . . . . . . . . . . . . .
Telephony - Configurations - Codecs with g729 . . . . . . . .
Telephony - Configurations - g729 licence . . . . . . . . . . .
Telephony - IP PBX remote managers . . . . . . . . . . . .
Telephony - IP PBX remote managers - Configuration . . . .
Telephony - VoIP domain alias . . . . . . . . . . . . . . . . .
Telephony - Interfaces . . . . . . . . . . . . . . . . . . . . .
Telephony - Interface insertion . . . . . . . . . . . . . . . . .
Telephony - SIP peers . . . . . . . . . . . . . . . . . . . . .
Telephony - IAX Peers . . . . . . . . . . . . . . . . . . . . .
6.1
Apply Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . 231
10.1
10.2
10.3
10.4
10.5
10.6
Backup
Backup
Backup
Backup
Backup
Backup
-
Arkeia
Arkeia
Arkeia
Arkeia
Arkeia
Arkeia
iPortalMais - 2008
-
Main Menu . . . . . .
Running Jobs . . . . .
Backups confirmation
Add Users . . . . . . .
Directories to save . .
Levels . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
200
201
202
203
203
204
205
206
207
208
209
211
212
213
214
215
215
216
217
219
221
222
222
223
224
225
226
227
228
229
229
242
243
243
244
245
245
Reference Guide - Version 5.0
12
Reference Guide - Version 5.0
LIST OF FIGURES
iPortalMais - 2008
Chapter 1
Aim of this document
This reference guide give you a detailed description of the following IPBrick
menus:
• IPBrick.I configuration;
• IPBrick.C configuration;
• IPBrick.GT configuration;
• IPBrick.KAV configuration;
• Advanced Configurations.
In appendix we present the procedure to deal with the Workstation configurations. You will find the following configurations
• Process of joining a workstation (MS Windows) in a domain;
• Procedures for the establishment of a virtual private network (VPN) PPTP
and SSL.
iPortalMais - 2008
Reference Guide - Version 5.0
14
Reference Guide - Version 5.0
Aim of this document
iPortalMais - 2008
Chapter 2
Before Starting
IPBrick is a complete integrated server system based in a Linux distribution.
When installed you can access IPBrick with a Internet browser. The IPBrick IP
address by default is 192.168.69.199. The address to write on the browser bar
is https://192.168.69.199.
When you open a WEB session with IPBrick you will see a web page authentication. After a correct validation IPBrick allows you to change the domain and
the IP networks of the private and public server interfaces.
Attention: If the communication network where you are trying to install IPBrick has already a DHCP server you should deactivate this in order to avoid
conflicts.
For more information about installing IPBrick and configuring a workstation,
please consult the Installation Manual.
IPBrick web interface management is divided into five main menus:
• IPBrick.I : For configuration of specific Intranet services;
• IPBrick.C : For configuration of specific Communication services outside the
LAN;
• IPBrick.GT : Permit an easy configuration of services normally active at the
IPBrick.GT appliance1 ;
• IPBrick.KAV : Permit an easy configuration of services normally active at
the IPBrick.KAV appliance2 ;
• Advanced Configurations.
All configurations done by the IPBrick administrator are stored in a PostgreSQL database. Only when the option Apply Configurations is clicked, the
1
It’s a IPBrick hardware appliance for telephony gateway. Can have analogic/ISDN telephony
cards
2
It’s a IPBrick hardware appliance acting as a security gateway, including Kaspersky licences
iPortalMais - 2008
Reference Guide - Version 5.0
16
Before Starting
database will generate all the new system configurations files. Changing configurations in the following menus:
• Advanced Configurations
IPBrick
Definitions;
• Advanced Configurations
IPBrick
Authentication;
• Advanced Configurations
System
Date and Hour
Time zone;
causes a restart of IPBrick (IPBrick needs approximately 1 minute to restart,
depending on the hardware where it is installed).
IPBrick allows an efficient management of configurations where, whenever
changes are made in the system by the web interface, a new configuration is locally
recorded or automatically stored in an USB pen if one is plugged. This way the
Disaster Recovery is guaranteed, one of the surplus values of IPBrick. For example, if the hard drive crashes down you can quickly restore the configurations with
the IPBrick Installation CD and the Pen Drive.
On the management interface there are some links that allow you to manage
the services. You will find links like:
• Back : Allows you to turn back to the previous page without saving changes;
• Insert: Allows you to insert new items;
• Modify: Allows you to change item settings;
• Delete: Allows you to delete an item;
Reference Guide - Version 5.0
iPortalMais - 2008
Chapter 3
IPBrick.I
This chapter describes the IPBrick.I menus used to manage the main Intranet
services.
It is divided into the following main sections:
• Machine Groups
• Machines Management;
• User Groups;
• Users Management;
• Domain server;
• File Server;
• E-mail;
• Print Server;
• Backup;
• Fax Server;
• Terminal Server.
3.1
Machines Groups
In this menu you can manage groups of machines that lets you create groups
and assign machines to each group. For instance, machine groups can be used to
configure web proxy accesses. To insert a group of machines you have to set:
• Group name: The name assigned to the group of machines;
• Group type
– Machines Subnets: Depending on the used IP address, the groups of
machines can be split into defined sizes.
iPortalMais - 2008
Reference Guide - Version 5.0
18
IPBrick.I
– Machines: If you choose this option and Insert, it’s possible to assign
existing network machines to the group;
• Machine count: If the group is a subnet of machines, you can choose the
number of machines for the group;
• Subnet: This field defines the subnet for the group of machines. It represents
the range of IP addresses concerning the defined group.
By clicking Insert, the group is created and its settings are displayed. In that
screen you can see three links: Back to go back to the list; Modify to change the
name of the present group; Delete to remove the group of machines. We can see
an example of a machine group at Figure 3.2 and the general list at Figure 3.1
Figure 3.1: Machine Groups - List
3.2
Machine Management
This section deals with adding or changing machine registrations in LDAP (e.g.
PC, laptop, printer). A machine is represented by the type, name, group, IP address and MAC address, as you can see in Figure 3.3.
There are these machines types:
Reference Guide - Version 5.0
iPortalMais - 2008
3.2 Machine Management
19
Figure 3.2: Machine Groups - Example
• Workstation: Workstation in LAN running a Windows operating system;
• Workstation + SoftPhone: Windows workstation in LAN with a softphone
association;
• Linux Workstation: Workstation in LAN running a Linux distribution, so
it will be possible to export the user’s home account by NFS to that Linux
clients;
• Linux Workstation + SoftPhone: Linux workstation in LAN with a softphone association. The name will be the SIP username and it will always be
associated to the IP address;
• Printer: Network printer. Location is a description about the printer location. Port will be the port where the print server is running. Example: 9100
for HP’s;
• IP Phone: Hardware IP SIP phone in LAN. The name will be the SIP
username and it will always be associated to the IP address;
• Linux Terminal: Thinclient with remote session to a Linux machine that will
be used with the Terminal Server in IPBrick;
iPortalMais - 2008
Reference Guide - Version 5.0
20
IPBrick.I
• Windows Terminal: Thinclient with remote session to a Windows machine
that will be used with the Terminal Server in IPBrick;
In order to insert a machine you only have to define the type, introduce the
name and IP Address. In this way the machine is registered in the LDAP and
the DNS server. If you fill in the MAC Address field with the MAC adddress of
the machine to be registered then a record is also created for this machine in the
DHCP server.
Note: The machine MAC address can be obtained from the network connection
icon in Windows XP or by executing the order ipconfig /all in the command line.
Figure 3.3: Machines Management - Machine registration
You can manage a specific machine clicking over its name in the list. You will
get the screen present at Figure 3.4. If you click the link Modify, the form from
Figure 3.3 is displayed and enables you to redefine the machine parameters. If you
click Delete, the machine will be deleted. When all the machines are registered
you can get the list at the main menu (Figure 3.5).
3.2.1
Mass Operations
The Export feature will export all the data to a .csv file (Figure 3.6). The
Mass operations option permit an import of a .csv file (Figure 3.7). You can edit
Reference Guide - Version 5.0
iPortalMais - 2008
3.2 Machine Management
21
Figure 3.4: Machines Management - Options
a .csv file in a spreadsheet application, choosing the ; to split the columns. The
fields are:
Mandatory fields:
• actionmachine: Options available:
– I: To insert a machine in IPBrick;
– U: To update machine information in IPBrick;
– D: To delete a machine in IPBrick;
• machinetype: Options available:
– 1: For Workstation;
– 3: For Workstation + Softphone;
– 14: For Linux Workstation;
– 15: For Linux Workstation + Softphone;
– 16: For Printer;
– 2: For IP Phone;
– 7: For Linux Terminal;
– 4: For Windows Terminal.
iPortalMais - 2008
Reference Guide - Version 5.0
22
IPBrick.I
Figure 3.5: Machines Management - List
• name: Machine single name;
• ip: Machine IP. The format is xxx.xxx.xxx.xxx;
• mac: Machine NIC MAC address. The format is xx:xx:xx:xx:xx:xx;
• password: Password to use if a SIP phone is selected. Example: 123;
Other fields:
• computernumber: Machine LDAP ID;
• groupnumber: Machine group number if associated to some group;
• rdpsrvaddress: Remote server IP if a terminal is selected;
• rdpsrvdomain: Remote server domain if a Windows terminal is selected.
Example of a .cvs file content for mass operations import option:
"actionmachine";"machinetype";"name";"ip";"mac";"password"
"I";"1";"wrk01";"192.168.69.100";"00:E0:98:9C:49:03";""
"I";"1";"wrk02";"192.168.69.101";"00:E0:98:4D:23:12";""
"I";"1";"wrk03";"192.168.69.102";"00:E0:98:9B:45:04";""
"I";"3";"softphone01";"192.168.69.102";"00:E0:98:9B:45:04";"1234"
Reference Guide - Version 5.0
iPortalMais - 2008
3.3 User Groups
23
! Attention:
• The computer name has to be an alphanumerical name. Exceptions are the
characters _ and -;
• The computer name shouldn’t have spaces nor diacritical marks on characters
neither punctuation. Its maximum size should be 15 characters;
• Is is not allowed to register neither machine with the same name nor machine
whose names are identical with a registered user log in;
• For a registration of a Windows station, the name as to be always in small
letters and if necessary change the Computer name to small letters, too.
Figure 3.6: Machine Management - Export
3.3
User Groups
A group is an set of users generally created when you wish that all people in
that group share the same permissions to a group of files. In this section you
manage IPBrick user groups.
• To create a new group:
iPortalMais - 2008
Reference Guide - Version 5.0
24
IPBrick.I
Figure 3.7: Machine Management - Mass Operations
– Click on Insert ((Figure 3.8);
– Choose the group name.
• To add or remove users from a group:
– Click on the group name (Figure 3.9);
– In the generated page (Figure 3.10) choose the users that should be
added or removed from the defined group.
There are two pre-defined groups that cannot be deleted or changed. These
groups are:
• Administrators;
• General.
Users that belong to the Administrators group have administrator permissions
in the domain served by IPBrick. You may add or remove users of this group with
the exception of the pre-defined Administrator. The General group is a common
group for all users created in IPBrick.
! Attention:
• When inserting new groups their name can be in capital and/or small letters.
Reference Guide - Version 5.0
iPortalMais - 2008
3.4 Users Management
25
• The group name can contain spaces, but can’t have more than 32 only alphanumerical characters without accents.
• When the user is created, there shouldn’t be other group with the same
name, including domains.
Figure 3.8: User Groups - Group creation
3.4
Users Management
In this section you learn how to register new users, change the information of
already existing users and delete users. When creating a new user IPBrick creates
automatically an e-mail account, and individual work area (user drive space in the
server) and a net logon in order to identify the user in the domain.
After being installed, IPBrick creates by default one user and two groups.
The created user have the login Administrator and the two groups are the
Administrators and the General. The user with Administrator login has a work
area created in the Work Area 1. This user has special characteristics because he
belongs to the Administrators group and is responsible for the management of
some system functions. Therefore he can never be removed.
The user registration is composed of the following fields:
• Name: User’s name. Normally is the first and last name;
• Login: User’s identification to be used for any IPBrick authentication process.
iPortalMais - 2008
Reference Guide - Version 5.0
26
IPBrick.I
Figure 3.9: User Groups - Groups List
• Server: Selection of the server where the user account shall be created. The
user account stands for the hard drive space in the server where various user
contents are stored, including email folder, Windows profile and documents.
If there are slaves servers they are also listed.
• Work Areas: Partition of the server drive selected to create the account.
The users should be distributed the fairest way in order to use the available
space most efficiently.
• Password: Password definition;
• Retype Password: Confirmation of the password;
• Quota: Value that limits the user hard drive space in the system. The unit
os measurement is kilobytes. If you don’t indicate a limit value, the user will
have unlimited space to occupy.
An example is present at Figure 3.11.
! Attention:
• When inserting users only use characters without accents for their name,
login and e-mail address.
Reference Guide - Version 5.0
iPortalMais - 2008
3.4 Users Management
27
Figure 3.10: User Groups - Users
• Spaces, brackets, full stops, small and capital letters are possible in the Name
field.
• You are not allowed to use spaces in the Login field. Avoid using capital
letters.
• Every login has to be unique. There cannot be a login with the same name
of a machine registered in IPBrick.
In order to modify some user information you have to click over the name (Figure 3.12).
In the form where you change the user (Figure 3.14) you can see all fields
that were defined when the user account was created. The only exception is the
uidNumber which is an IPBrick user identification number. The password is
not shown. All defined fields are editable with the exception of the login and
uidNumber.
To remove a IPBrick user record:
• Click on the user name;
iPortalMais - 2008
Reference Guide - Version 5.0
28
IPBrick.I
Figure 3.11: Users Management - Insert
• In the generated page, besides from displaying user properties, you can also
delete the user (Figure 3.13).
⇒ Note: The user contents (personal files, profile, e-mails) are not eliminated
when deleting his registration. They are moved to an administrative share called
BackupX (X representing the number of the work area where the user was registered, 1 or 2). Only members of the Administrators group have access to this
share from any Windows station. Therefore they have to do the following:
• Press the keys [Win]+[R] at the same time
• Write \\ipbrick\backup1 and press the button ”OK”
All folders and files deleted in these administrative shares are finally eliminated
in IPBrick.
3.4.1
Mass Operations
The Export feature will export all the data to a .csv file. The Mass operations
option permit an import of a .csv file. You can edit a .csv file in a spreadsheet
application.
Mandatory fields:
Reference Guide - Version 5.0
iPortalMais - 2008
3.4 Users Management
29
Figure 3.12: Users Management - List
• actionuser: Options available:
– I: To insert a user in IPBrick;
– U: To update user information in IPBrick;
– D: To delete a user in IPBrick;
• login: User login;
• name: User name. If more than one word is used the " is necessary;
• email: User email;
• accountquota: Quota for the user account. The 0 is unlimited;
• idworkarea: User workarea number;
• password: Insert a user password. Later the user can change it by the
myipbrick site. Note that this field is not present when we export a .cvs file,
so you must create it;
• mailalias: User email alias.
Other fields:
iPortalMais - 2008
Reference Guide - Version 5.0
30
IPBrick.I
Figure 3.13: Users Management - Operations
• usernumber: User LDAP ID;
• groupnumber: Group LDAP ID of user;
• idserver: Slave server IP where to create the account. The 0 is for local;
• passwordtype: 1 for normal, 2 for biometric mode;
• randompassword: Used to generate random password’s for users;
• sipurl: User’s SIP url, representing the phone near the user;
• mailaccountstatus: 1 for active, 2 for inactive;
• mailquota: Maximum mail account quota in MBytes;
• mailmaxsize: Maximum received message size in MBytes;
• mailforward: It’s a forward mail for the user;
• mailoutoreply: It’s the automatic reply message. The use of " is needed;
• homedrive: Represents the account network drive. The default is Z;
• roamingprofile: 1 for a roaming profile, 2 for a local profile.
Reference Guide - Version 5.0
iPortalMais - 2008
3.5 Domain Server
31
Figure 3.14: Users Management - Modify
Example of a .cvs file content for mass operations import option:
”actionuser”;”login”;”name”;”email”;”accountquota”;”idworkarea”;”password”;”mailalias”
”I”;”jsmith”;”John Smith”;”jsmith@domain.com”;”0”;”1”;”123456”;”john.smith@domain.com”
”I”;”bjones”;”Bill Jones”;”bjones@domain.com”;”0”;”2”;”123456”;”bill.jones@domain.com”
”I”;”shamilton”;”Sara Hamilton”;”shamilton@domain.com”;”0”;”2”;”123456”;”sara.hamilton@domain.com”
3.5
Domain Server
IPBrick as a Intranet server manages all the network resources belonging to
a certain domain and provides important network support services as DNS and
DHCP. A relevant feature to consider in the domain server 1 is that it works with
the authentication server, where all the users have a username/password match
defined in the LDAP database of IPBrick. PDC is checked whenever there is a
authentication demand in a workstation.
1
Primary Domain Controller
iPortalMais - 2008
Reference Guide - Version 5.0
32
IPBrick.I
3.5.1
Configure
In this section you define the name of the domain served by IPBrick as well as
this fields (Figure 3.15):
• Domain Login:
– YES: IPBrick will be a Primary Domain Controller in the chosen domain;
– NO: IPBrick will not operate as a domain server.
• Default account network drive: Will be the drive where the users account
will be mapped in the workstations side. The default is Z;
• Default type of profile: The profile is a Windows workstation is a group of
folders that are stored normally at c:\Documents and Settings\user_login;
– Roaming: In this case when the user logout at workstation, all the profile
folders are synchronized to the user personal account in IPBrick, located
at \\ipbrick\user_login\.profiles. When he logins again in the
same workstation or a different one, the profile will be synchronized
back to the workstation;
– Local: The profile will never be synchronized to IPBrick.
⇒ Note: The information on this page is only valid for the MS Windows
environment. The IPBrick Domain Name field is related to the Workgroup or
Domain Name in the MS Windows environment.
3.5.2
Users Management
For each user it’s possible to specify:
• Account network drive: Z: by default;
• Type of profile: Roaming or local;
Clicking at that option the user’s list is presented. Choosing a specific user as
shown at Figure 3.16, we can configure the domain server definitions for him.
3.6
File Server
A workarea corresponds to a physical partition in the drive with the denomination /home1 or /home2. When a new user is created, the system also creates its
personal account that represents a folder structure that supports the user account.
1. Personal Accounts: Located in the MS Windows environment, containing
e-mails files and the user profile;
2. Group Sharing: Responsible for storing user group files
Reference Guide - Version 5.0
iPortalMais - 2008
3.6 File Server
33
Figure 3.15: Domain Server - Definitions
3. Administrative Sharing: Responsible for sharing user accounts and eliminated group sharings. These areas are only available for Administrators.
IPBrick has two Work Areas by default: Work Area 1 and Work Area 2.
When you click on Work Areas you are given a list of all users and sharing groups
classified by Work Area as well as information about the occupied space in the
system of each individual Work Areas (Figure 3.17).
3.6.1
Individual Work Areas
When you select Individual Work Areas, IPBrick shows you a list with the
existing Work Areas and a schedule of the occupation rate for each Work Area
(Figure 3.18). These Work Areas correspond to the hard drive space where the
users data is stored.
When you click on a Work Area, e.g. Work Area 1, you are given a list with
all users introduced in this area as well as the occupied space of each user (Figure
3.19). Each user area is created in the moment you make the IPBrick registration
in IPBrick.I Users Management. In individual workareas we have too the list
of FTP accounts created in FTP menu at IPBrick.C.
! Attention: If the occupied space in the Work Areas reaches 100% users can
longer save their data in IPBrick. More over, e-mails are no more delivered to the
iPortalMais - 2008
Reference Guide - Version 5.0
34
IPBrick.I
Figure 3.16: Domain server - Users Management
users. They stay in the queue till some space is released in the Work Areas. It is
recommended to keep the occupation rate of each Work Areas under 95%.
3.6.2
Group Work Areas
The group work areas are network shares that can be acceded by SMB or by
NFS clients. You can create network shares in any Work Area. After creating a
network share you have to define the correspondent access permissions.
When inserting a Group Work Area you have to first choose the workarea were
the share will be created (Figure 3.20) and fill in the following fields:
• Name: Name of the share folder. Try to avoid spaces, characters with accents
and punctuation;
• Description: Share description. It’s a optional field;
• Administrator: Share administrator’s email. It’s a optional field;
• Browseable: If Yes it will appear in the server browse list. If No the share
will became hidden;
• Recycle bin: Enables the use of a recycle bin;
Reference Guide - Version 5.0
iPortalMais - 2008
3.6 File Server
35
Figure 3.17: Work Areas - Summary
• Name of the recycle bin folder: If you choose to enable the previous
option, you can set in this field the folder that will be used as a recycle bin.
Two examples can be viewed at (Figure 3.21) and (Figure 3.22).
Access Permissions
After creating a Group Work Area you have to give permissions to the users
in order to have access to the network share. This is done by first clicking at the
share name as shown at Figure 3.23.
There are 3 different types of permissions:
• None: No access to the share. Users have no access to open a share folder of
a workstation;
• Read Only: Users have access to share folders and its files. Nevertheless,
they are not allowed to change these files;
• Read/Write: Users have access to share folders and its files and are allowed
to change files and save changes.
Permissions are given to individual users or user groups (Figure 3.24). Users
groups are defined in IPBrick.I Group Management.
For example, in order to create a share folder for users belonging to a commercial department you have to do the following steps:
iPortalMais - 2008
Reference Guide - Version 5.0
36
IPBrick.I
Figure 3.18: Work Areas - List
• Create group ”Dept Financeiro”, in Group Management and add the users
of this department to the group.
• Create an area called ”Financeiro” in Work Areas
Group Work Areas.
• Give read and write permissions to the group ”Dept Financeiro”. The other
groups have either reading permissions or no access to this area.
⇒ Note: When defining user group permissions any change in the General
group leads to changes for all the other groups. This happens because all users
introduced in IPBrick are part of General group.
⇒ Note: A deleted share is no more available for users. All files in this share
are moved to an administrative share called BackupX (X representing the number
of the work area where the share was created, 1 or 2) that you find in the same
Work Area. Only useres belonging to the IPBrick Administrators group have
access to this administrative folder. You can access this share from a Windows
station. Therefore you have to do the following steps:
• Press the keys [Win]+[R] at the same time
• Write \\ipbrick\backup1 and press ”OK” (share that exist in Workarea 1)
All files and folders deleted in these administrative share are definitively deleted
in IPBrick.
Reference Guide - Version 5.0
iPortalMais - 2008
3.6 File Server
37
Figure 3.19: Work Areas - Summary of Individual Areas
3.6.3
Kaspersky
Kaspersky Antivirus for Samba Server (file server) is already installed in IPBrick. After inserting a valid license (Figure 3.25), Kaspersky Antivirus for Samba
Server is activated and displays the interface with the following links:
• Update: After the license expiration you should renew with a new license
file;
• Delete: Removes the license;
• Configure: It provides you a general Anti-Virus configuration option;
• Work areas: Antivirus behavior in work areas;
• Statistics: Interface with specific statistics about the file server AntiVirus.
Configuration
General settings:
• Notify from the address: Sender that will make the notifications;
iPortalMais - 2008
Reference Guide - Version 5.0
38
IPBrick.I
Figure 3.20: Work Areas - List
• Notify to the address: Email address that will receive notifications.
Object settings:
• Directory exclusion mask: Directories that will be analyzed;
• File exclusion mask: Files that will be analyzed;
• Packed Files: If you choose this item, this type of file will be analyzed;
• Archives: If you choose this item, this type of file will be analyzed;
• Auto-extraction files: If you choose this item, this type of file will be
analyzed;
• Email database: If you choose this item, this type of file will be analyzed;
• Text format email: If you choose this item, this type of file will be analyzed.
Scan settings:
• Cure: If activated, detected virus will be automatically removed;
• Use heuristic: If activated, virus can be detected through the analysis of
the code with characteristics and behavior similar to a virus;
Reference Guide - Version 5.0
iPortalMais - 2008
3.6 File Server
39
Figure 3.21: Work Areas - Group - Insert with recycle bin
• Usar IChecker: If the file was not modified since the last time that was
checked, there will be no new analysis for this file.
Actions Settings: Defines what the Anti-Virus will do with infected and suspecting files or with warnings
• Remove: Removes the file;
• Inalterable: Doesn’t make any action on the file;
• Move: Moves the file.
Notification settings: Defines what notifications the Anti-Virus will do about
infected and suspecting files or with warnings.
• Notify user through winpopup: Notification using the Windows net send
command;
• Notify user through email;
• Notify administrator through email.
To change settings click on Modify. You can see the configuration interface at
Figure 3.26 and Figure 3.27.
iPortalMais - 2008
Reference Guide - Version 5.0
40
IPBrick.I
Figure 3.22: Work Areas - Group - Insert without recycle bin
Workareas
By default, work areas are verified when they are opened and closed. You can
set for each share if it will be protected, or not, and if it will be verified when users
open and/or close files, like shown at Figure 3.28.
Statistics
Several statistics are displayed in this interface:
• Virus Statistics in period: Options to display present graphic in Virus
Statistics (Figure 3.29):
– Start: The starting date for statistics;
– View: Can be set in hours, days, months or years;
– Repetition: Scale of the graphic horizontal axis;
– Group: It enables you to group data, depending on the chosen view
• Vı́rus statistics: The display can be filtered by: Infected files, protected,
corrupted, errors and files where disinfection failed;
• Virus list: Can be organized by Virus name/Number of occurrences (Figure 3.30).
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
41
Figure 3.23: Work Areas - Group - Management
3.7
E-Mail
Email is the most used network service in Internet, increasingly replacing traditional mail and fax. The protocol that is used to send electronic messages is SMTP
(Simple Mail Transfer Protocol) that runs on gate 25 TCP. It enables email sending
for one or several recipients and is implemented by MTA (Mail Transfer Agents).
IPBrick MTA is Qmail2 .
SMTP is only capable of sending messages, being necessary to users the use
of an email client that supports the protocols aiming to download messages from
servers POP3/IMAP.
IPBrick’s Email section is composed by:
• Configure;
• Queue Management;
• Users Management;
• Mailing Lists;
• Kaspersky Anti-Virus;
2
http://cr.yp.to/qmail.html
iPortalMais - 2008
Reference Guide - Version 5.0
42
IPBrick.I
Figure 3.24: Work Areas - Group - Users Access
• Kaspersky Anti-Spam.
3.7.1
Configure
An important concept about the email server configuration is open relay. A
server that works in open relay processes messages between senders and recipients
out of the server domain, that actually can even be non-existent. Obviously, IPBrick doesn’t work as open relay, only forwarding Internet emails to domains that
are explicitly indicated.
Is is important to mention four very simple and decisive concepts in the E-mail
configuration:
1. Locally delivered domains: E-mail addresses with destination to the IPBrick server itself, that is, the associated e-mail accounts are in the local
network. E-mails that are in the queue and whose recipient is one of these
domains are not sent to another server in order to be delivered. The domains
served by the machine have to be correctly configured in each DNS domain
server. That is, the ”E-mail servers” of these domains have to be configured
to this machine.
2. Authorized relay domains: IPBrick forwards all the messages that have
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
43
Figure 3.25: Workareas - Kaspersky Licence
their domains in this list and will be accepted by the server to a queue list.
Messages to other recipients that don’t belong to this domains won’t be
accepted by the server (please see 3 .
3. Relay networks definitions: IPBrick relays to any domain as long as the
e-mail is sent from his corresponding internal network. If there are different
internal IP networks it is necessary to add these networks to the list. This
way all machines in the networks are able to send e-mails to other domains
using IPBrick as a relay server. The Other networks (Internet IP’s) could
use this SMTP server but only with TLS authentication. So someone in
Internet that want to use the IPBrick’s SMTP to send email is forced to
authenticate with his LDAP username/password;
4. SMTP Routes: SMTP routes are configured when you want e-mails to follow
a certain way (server) in order to find their recipient. Normally, a SMTP
route is defined by default (showing the SMTP route and leaving the Domain
empty).When the server is not correctly registered with the IP name in the
Internet DNS, you have to define a SMTP route. In this route it should be
either the server responsible for the forward of company e-mails or the SMTP
server of the ISP used by firms to access the Internet. This configuration is
3
Only e-mails from the Internet respecting these rules are processed. IPBrick is not configured
as open-relay.
iPortalMais - 2008
Reference Guide - Version 5.0
44
IPBrick.I
Figure 3.26: Workareas - Kaspersky - Configure 1/2
necessary because certain e-mail servers make additional verifications of the
sending server authenticity. If they can’t resolve the server name into the
corresponding IP address (reverse DNS check), the mail may be deleted or
sent back as SPAM. In case no SMTP route is used the server tries to send
the mails in the queue by his own. With the help of the DNS registrations
he tries to find the recipients directly in the Internet.
Each e-mail configuration option has a link to Insert new entries (Figure 3.31).
The domains for local delivery (domains with IPBrick serves) and relay (domains which IPBrick forwards) can be edited and/or deleted. The exception is
the domain whose name is the same as that of the machine in the local networks
or that of the local domain in the relay.
⇒ Note: To make IPBrick relay e-mails to another server that has the accounts, the firm base domain has to be retreated from the domains served by
IPBrick, since it is a domain served by IPBrick by default.
By default IPBrick only forwards email messages that come from is private
network. If there are different internal IP networks, they should be added to let
them send messages.
There are two different types of SMTP routes:
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
45
Figure 3.27: Workareas - Kaspersky - Configure 2/2
Figure 3.28: Workareas - Kaspersky
1. FQDN4 of the route server. For example: smtp.exchange.telepac.pt.
2. IP address of the route server. Please give attention to the brackets 195.22.133.45.
In the following you are given two examples of configurations, one with an
IP for a specific domain and another configuration for the same domain with the
FQDN:
4
Fully Qualified Domain Name
iPortalMais - 2008
Reference Guide - Version 5.0
46
IPBrick.I
Figure 3.29: Workareas - Kaspersky - Statistics 1/2
Figure 3.30: Workareas - Kaspersky - Statistics 2/2
First Example:
Domain
: abzas.miz
SMTP route : 195.22.133.45
Second Example:
Domain
: abzas.miz
SMTP route : smtp.exchange.telepac.pt
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
47
Figure 3.31: E-mail - Configure
An important configuration is that of a machine relaying e-mails. Whenever
you add in this situation a SMTP route by default (without indicating the domain)
you have to add another SMTP route to forward e-mails do the internal e-mail
server. In the following you can see an example of such a configuration.
In this configuration IPBrick is relaying all the e-mails comming to an internal
e-mail server called accounts. IPBrick have a second route to deliver all the mail
to the Internet by the smarthost smtp.isp.pt:
Domain: domain.com
SMTP route: accounts.domain.com
Domain:
SMTP route: smtp.isp.pt
3.7.2
Definitions
There is a link called Definitions (see Figure 3.32 and Figure 3.33) to define
characteristics of the e-mail server:
• Message maximum size: It’s the global message maximum size of a sending
message
Value by default: unlimited.
iPortalMais - 2008
Reference Guide - Version 5.0
48
IPBrick.I
• Maximum time to hold the message in the server: Maximum time the
message will be in mail queue
Value by default: 604800 seconds (7 days)
• Maximum number for simultaneous SMTP connections: Number of connections that the server can support
Value by default: 20
• Incoming message timeout: Maximum time to receive a single message in
server. If reached it will timeout
Value by default: 1200 seconds
• Outgoing message timeout: Maximum time to send a single message. If
reached it will timeout
Value by default: 1200 seconds
• Reject emails from invalid domains: The server will reject incoming
mail if the sender’s domain MX record don’t exist, so it will be invalid.
Default value: Yes
• Reject emails from invalid servers: The server will reject incoming
mail if the sender’s FQDN don’t have a reverse DNS record.
Default value: No
In this interface it is even possible to define permissions of sending and receiving
e-mails:
• Valid internal recipients: This list is important to fill in order to protect the server from a mailbomb attack. Here should be listed all the internal
valid email addresses. If the list is empty all the internal recipients will be
accepted (Figure 3.34);
• Invalid senders: A list with e-mail addresses that are not allowed to send
email ((Figure 3.35).
3.7.3
Queue Management
The Queue Management (Figure 3.36) allows you to manage and visualize emails that are in the e-mail server queue waiting to be delivered to their local or
remote recipient.
You can see the number of e-mails that are in the queue waiting to be delivered
to their local or remote recipient as well as the total number of e-mails in the queue.
The list presents the following fields:
• ID: The only message identification added by IPBrick ;
• Date: E-mail sending date;
• From: E-mail sender;
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
49
Figure 3.32: E-Mail - Definitions 1/2
• To: e-mail recipient;
• Subject: Message subject;
• Size: Message size displayed in Kbytes.
You can delete several e-mails at the same time by selecting the corresponding
checkboxes and clicking in the Delete Mails option. You have to confirm this
action in order to eliminate the chosen mails.
When selecting a mail you can see its complete source. This operation is done
in real time. Therefore is not necessary to Apply Configurations.
! Attention: E-mails deleted in the queue are eliminated definitely. A email
can stand in queue for a default value of 7 days.
! Attention: When a message in queue is deleted the qmail service is restarted.
3.7.4
Users management
This option provides a centralized management for each user email account of
the system and it’s possible to configure:
• State: The user email account can be enable or disabled;
• Default mail: The user default mail address. It’s not mandatory to be equal
to login@domain;
iPortalMais - 2008
Reference Guide - Version 5.0
50
IPBrick.I
Figure 3.33: E-Mail - Definitions 2/2
Figure 3.34: E-Mail - Definitions - Valid internal recipients
• Alternative addresses;
• Mail quota;
• Message maximum site;
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
51
Figure 3.35: E-Mail - Definitions - Invalid senders
Figure 3.36: E-Mail - Queue Management
• Forward to;
• Automatic reply message.
Configuration example at Figure 3.38.
Alternative Addresses
Alternative addresses (Figure 3.38) allow you on the one hand to have practical
logins which are easily to manage and on the other hand the confort to use more
personalized e-mail addresses. This way the user can have an e-mail address with
which he identifies himself more.
iPortalMais - 2008
Reference Guide - Version 5.0
52
IPBrick.I
Figure 3.37: E-mail - Users Management
All mails that are sent to any defined alternative e-mail user address are delivered to the inbox respectively.
Example:
name : John Smith
login : jsmith
email : jsmith@domain.com
Alternative Addresses:
john_smith@domain.com
john.smith@domain.com
john@domain.com
To Insert a new email address:
• Select the account (user);
• In the Alternative Addresses field: Set the alternative email address(es).
Whenever you want to you can access the e-mail address list (IPBrick user
e-mail address arranged in groups) and change the names or the user of an e-mail
address. Is it obvious that when you change the user of an alternative e-mail
address new mails will be delivered to the new user while the other alternative
addresses stay with the old user.
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
53
Figure 3.38: E-Mail - Alternative addresses, Forwarding and automatic replys
Mail Forward
Mail forward allows delivered mails to be sent to the user’s email and other
internal or external e-mail addresses.
To insert a new mail forward (Figure 3.38):
• Select the account (user);
• In the Forward to field: Set the recipient email address(es).
Automatic reply message
A automatic reply message is an e-mail automatically send by IPBrick to answer other e-mails. When a e-mail arrives at a user account with Auto Response
configured, IPBrick send a mail to this send with the personalized user contents.
In order to Insert a new Auto Respond you need to (Figure 3.38):
• Select the account (user);
• Insert in the Automatic reply message text area, insert the content you
want. Ex: Vacations
3.7.5
Mailing Lists
A mailing list provides the feature of sending email from one to many.
To add a mailing list:
iPortalMais - 2008
Reference Guide - Version 5.0
54
IPBrick.I
• Click on Insert;
• Write the address you want in the mail field (Figure 3.39);
• Click on Insert.
After you add a mailing list (Figure 3.40), you have to configure:
• Internal Users List: Set the IPBrick Users that will be part of the mailing
list;
• IPBrick Contacts address list: Set if any contact present at IPBrick
Contacts site will be part of the mailing list;
• External Users List: Set the email addresses that don’t belong to the
LAN ((Figure 3.41)).
In both cases you only have to click Modify to add members to the list.
Figure 3.39: E-Mail - Mailing List - Insert
3.7.6
Kaspersky Anti-Vı́rus
The Anti-Virus is already installed in the Email section. You only have to
acquire a license to activate its management interface. After inserting the license,
the interface displays the following links (Figure 3.42):
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
55
Figure 3.40: E-Mail - Mailing List - Users
• Update: After the license expiration, you need to renew with a new license
file;
• Delete: Removes the licence;
• Configure: Provides a general configuration of notifications;
• Groups Management: Provides personalization of Kaspersky Antivirus configuration and filtering;
• Statistics: Interface with specific statistics about the Anti-Virus use.
General configurations
Click in Modify to configure email address of notifications (Figure 3.43).
General Settings:
• Notify from address: Sender will make the notifications;
• Notify to address: Email address that will receive notifications.
Limits:
• Do not send notification to: Address that won’t be able to receive notifications (the notification sender).
iPortalMais - 2008
Reference Guide - Version 5.0
56
IPBrick.I
Figure 3.41: E-Mail - Mailing List - External users
Figure 3.42: E-Mail - Kaspersky Anti-Vı́rus
Groups Management
The group default is already created. If you click on the group, the default
general settings are displayed. If you click on Modify, you can personalize the
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
57
Figure 3.43: E-Mail - Kasp. Anti-Vı́rus - General Configurations
following options (Figure 3.44):
• Enable: Kaspersky Anti-Vı́rus State;
• Group administrator address: Group administrator email;
• Quarantine path: The files in the quarantine state are stored in this directories;
• Sender mask: You may add this item if a new group is created;
• Recipient mask: You may add this item if a new group is created;
Figure 3.44: E-Mail - Kasp. Anti-Vı́rus - Groups Management
iPortalMais - 2008
Reference Guide - Version 5.0
58
IPBrick.I
The notification rules for any type of object can be changed in Notification Rules
menu, as you can see in Figure 3.45.
Figure 3.45: E-Mail - Kasp. Anti-Vı́rus - Notification Rules
In the Filter menu (Figure 3.46), you may set the filter rules/exceptions by the
name of the files or by mime-type.
Figure 3.46: E-Mail - Kasp. Anti-Vı́rus - Filter
Statistics
Several statistics are displayed in this interface:
• Virus Statistics in period: Options to display present graphic in Virus
Statistics:
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
59
– Start: The starting date for statistics;
– View: Can be set in hours, days, months or years;
– Repetition: Scale of the graphic horizontal axis;
– Group: It enables you to group data, depending on the chosen view
• Virus statistics: The display can be filtered by: Infected files, protected,
corrupted, errors and files where disinfection failed;
• Virus List: Can be organized by Virus name/Number of occurrences;
• List of email senders: Shows some statistics about files by sender addresses;
• List of email recipients: Shows some statistics about files by IPBrick
recipients addresses;
An example can be seen at Figure 3.47 and Figure 3.48.
Figure 3.47: E-Mail - Kasp. Anti-Vı́rus - Statistics 1/2
3.7.7
Kaspersky Anti-Spam
Like Kaspersky Anti-Virus, Anti-Spam is already installed, you only need to
apply a license to activate this feature at the communications IPBrick. After the
activation, the following options are displayed:
iPortalMais - 2008
Reference Guide - Version 5.0
60
IPBrick.I
Figure 3.48: E-Mail - Kasp. Anti-Vı́rus - Statistics 2/2
• Update: After the license expiration, you need to renew with a new license
file;
• Delete: Removes the licence;
• Configure: Provides a general configuration of notifications;
• Statistics: Interface with specific statistics about the Anti-Spam use.
The most important Anti-Spam configuration features are:
• To add every email domains of the company that the Anti-Spam should filter
(Figure 3.49);
• To set Kaspersky Anti-Spam detection level. Standard is the default level.
If the spam reception rate is high, the level of detection should be increased
(Figure 3.51);
• To redirect all the emails classified by KaspersKy Anti-Spam to a email
account (At Figure 3.50: kaspersky@domain.com). This enables the network
administrator to analyze all the emails classified as Spam - if there is any
misclassified email, the administrator may forward this email to his recipient.
In a Intranet and a Communications IPBrick topology we can use a local
mailbox from the Communications IPBrick (ex: spam@com.domain.com),
because all the spam must stay at the com. server;
Reference Guide - Version 5.0
iPortalMais - 2008
3.7 E-Mail
61
• Email and IP addresses Whitelists and Blacklists should be added - if there
is any (menu on Figure 3.49).
Figure 3.49: E-Mail - Kasp. Anti-Spam - Protected Domains
Statistics
Several statistics are displayed in this interface:
• Spam Statistics in period: Options to display present graphic in Spam
Statistics:
– Start: The starting date for statistics;
– View: Can be set in hours, days, months or years;
– Repetition: Scale of the graphic horizontal axis;
– Group: It enables you to group data, depending on the chosen view
• Spam statistics: The display can be filtered by: Clean files, Spam, probable and blacklists;
• List of email recipients: Shows some statistics about files by IPBrick
recipients addresses.
An example is present at Figure 3.52.
iPortalMais - 2008
Reference Guide - Version 5.0
62
IPBrick.I
Figure 3.50: E-Mail - Kasp. Anti-Spam - Actions
3.8
Print Server
This section deals with the interface management of the printers intended to
be available in the network. When you define a printer you are asked to define
that fields (Figure3.53):
1. Name: Printer name;
2. Description: Simple description about the printer. This field is not mandatory;
3. Location: Physical location in the company. This field is not mandatory;
4. Interface: Interface type used between the printer and the server. There
are 4 options:
• Parallel port;
• Serial port;
• USB port;
• Network printer: Connected to a LAN switch.
5. Device: Used by the printer. This is directly related to the interface. (This
option is only available for interfaces with parallel port, series port and USB
port) (e.g. Interface–>Parallel Port, Hardware ->Parallel Port 1)
Reference Guide - Version 5.0
iPortalMais - 2008
3.8 Print Server
63
Figure 3.51: E-Mail - Kasp. Anti-Spam - Rules
6. In case of a network printer, the following information is necessary:
• Address: Network printer address. (this option is only available for
network printers) (e.g. 192.168.1.1)
• Port: Used by the network printer. This field is not obligatory. (This
option is only available for network printers) (e.g. for a HP printer:
9100)
After inserting a printer IPBrick has to put the drivers available for the client
stations in order to finish the configuration. Therefore the printer drivers have to
be transferred to the server:
1. Log on in a Windows station with a user of the Administrators group (the
workstation has to be already registered in the IPBrick domain);
2. Press the keys [Win]+[R] at the same time and type \\ipbrick;
3. Select Printers and Faxes
Verify if the added printer to the IPBrick Web interface is shown.
4. Right click inside the window Printers and Faxes and select Server Properties;
5. Select the Drivers option in the presented window.
6. Choose ”Add”, set the manufacturer and the printer model and click Next;
iPortalMais - 2008
Reference Guide - Version 5.0
64
IPBrick.I
Figure 3.52: E-Mail - Kasp. Anti-Spam - Statistics
7. Select the Windows version which the drivers have to correspond with.
8. Click Finish
Now the printer’s drivers are transferred to IPBrick.
9. At share named Printers and Faxes on IPBrick, right click at the printer
and choose Printer Properties. You’ll be prompted with a message like
the one in Figure3.54. Choose ”No”.
10. Enter in ”Advanced”, select the new driver just added and click ”Apply”.
To configure the printer on the client side, you must:
• Press the keys [Win]+[R] at the same time;
• Type \\ipbrick at the new window;
• Right click on the printer and choose ”Connect”.
Now the printer is listed at ”Printers and fax’s” on the client side.
Reference Guide - Version 5.0
iPortalMais - 2008
3.9 Backup
65
Figure 3.53: Print Server - Inserting a network printer at IPBrick
Figure 3.54: Print Server - Printer configurations
3.9
Backup
Backup consists of copying data from one device to another with the aim of
preserving the data in case of future problems. Usually this copy is made from the
hard disk to tapes, DVD or other disks. Nowadays paper is increasingly replaced
by digital files, bringing companies to the importance of having a reliable backup
system.
iPortalMais - 2008
Reference Guide - Version 5.0
66
IPBrick.I
3.9.1
Bacula
In IPBrick 5.0 we include Bacula that is a complete network backup solution.
Link: http://www.bacula.org.
3.9.2
Remote
This option enables the possibility of configuring scheduled backups to a NAS5
device or to a rsync server. Rsync is a powerful backup tool included in IPBrick,
that does incremental copies of files/directories to another rsync server.
To add a backup task you must click Insert (Figure 3.55). You will have the
following fields:
Backup definitions:
• Backup Name: It’s the backup name.
• Notification E-mail: Recipient that will receive all the backup notifications;
• Job to do: There are two options:
– Copy: It will copy all work areas to the backup device(/home1, /home2,
/home3...);
– Restore: It will restore all work areas from the backup device;
• Periodicity: The backup will be allways daily;
• Time to start: Time when the copy will start;
Destination Data Definitions:
• Data Location: The only option is remote. It will always be a remote machine.
• Backup Device
– NAS (SMB): The backup device is a NAS6 with a SMB share created.
The backup method is done using the archiving utility tar. Options
available:
∗
∗
∗
∗
IP address: Backup device’s IP address;
Login: Username that has access to the share;
Password: Share password;
Share Name: Name of the share created in the NAS.
– NAS (NFS): The backup device is a NAS7 with a NFS share created.
The backup method is done using the incremental backup utility rsync.
Options available:
5
Network Attached Storage
Network-attached Storage
7
Network-attached Storage
6
Reference Guide - Version 5.0
iPortalMais - 2008
3.9 Backup
67
Figure 3.55: Backup - Task insertion
∗ IP address: Backup device’s IP address:
∗ Share Name: Name of the share created in the NAS.
– Rsync Server: The backup device is a machine running a rsync server.
You can see an example of a rsync server configuration in the next
section;
∗ IP address: The rsync server’s IP address.
When a backup task is inserted, we have a Backups List with the following
options (Figure 3.56):
• Name: Clicking in the Backup Name you will have access to these options:
– Back: Go to backups list;
– Modify: Modify the current backup task definitions;
– Delete: Delete the current backup task;
• Start copy: Starts the backup immediately;
• Statistics: Backup statistics;
• LOG: Backup log messages.
iPortalMais - 2008
Reference Guide - Version 5.0
68
IPBrick.I
Figure 3.56: Backup - Task list
Rsync server configuration
If the backup device is another IPBrick, the server must be prepared to act
as a rsync server. First let’s suppose that the client IPBrick machine has that
configurations:
• IP: 192.168.69.199;
• FQDN: ipbrick.domain.com;
At IPBrick rsync server we need to:
1. Create a group workarea (share) using the Workarea 1, with the FQDN as
the share name: ipbrick.domain.com;
2. Connect by SSH to the IPBrick server and type the following command in
order to put rsync allways running when the server reboots:
update-rc.d rsync defaults 20
3. Create the configuration file for rsync by typing: nano /etc/rsyncd.conf
4. Fill the following content:
Reference Guide - Version 5.0
iPortalMais - 2008
3.10 Fax Server
69
uid = root
[ipbrick.domain.com]
path = /home1/_shares/ipbrick.domain.com
hosts allow = 192.168.69.199
read only = false
write only = false
5. Save the file and exit from the file editor nano;
6. Start rsync using this command: /etc/init.d/rsync start
3.10
Fax Server
The fax server is integrated at IPBrick from version 4.1. It works with serial
modem/fax or integrated in the PBX IP server. Incoming faxes are automatically
forwarded trough email.
The FAX Server configurations are implemented through the web interface in
IPBrick.I - FAX Server (Figure 3.57).
Figure 3.57: Fax Server - Configure
IPBrick provides you the use of two services: FAX2Mail e Mail2FAX. With the
FAX2Mail service, a FAX sent by an external FAX device is received by the FAX
iPortalMais - 2008
Reference Guide - Version 5.0
70
IPBrick.I
connected to IPBrick and then is forwarded to a defined email address.
With Mail2FAX you can send from an email an attached pdf file to a defined
FAX number. to enable this task you have to configure the email client with the
SMTP server where the FAX service is running and add the configured fax domain
to the domain list that is allowed to be forwarded by the email server.
3.10.1
Fax2Mail
To configure the service you have to click on Modify link and select Yes to
Enable Configuration. The following options are displayed:
• Fax Device: Type of physical connection/FAX hardware.
– Line type: When the server has a telephony PCI card acting as Fax.
The type of line could be ISDN or ANALOG in the case of an analogic
telephony access (Figure 3.58);
– Serial Fax Modem: If the modem is connected to the server serial port
you should choose the port that connects to the the modem in the Serial
Ports list (COM1 to COM8), the Baud rate (1200 to 38400) and Class
of the modem (Class1 to Class2.1). To know the appropriate values you
should read the modem manual (Figure 3.59).
• Number of virtual fax machines: You can use more that one virtual fax
machine;
• Main Fax Number: The PSTN Fax number to be present when a FAX is
sended;
• Company identification: Company name to be present when a FAX is sended;
• Country Code: Country phone number code to be present when a FAX is
sended;
• Area Code: Area phone number code to be present when a FAX is sended;
• Long distance prefix: 0 by default;
• International prefix: 0 by default;
• Rings Before Answer: Number of rings before IPBrick answers to Fax. Can
be useful if another FAX equipment is connected. For example, if the FAX
equipment can’t receive the FAX, IPBrick FAX server can answer at the 5th
ring;
• Speaker volume: FAX sound volume;
• Enable delay: Should be active by default;
Reference Guide - Version 5.0
iPortalMais - 2008
3.10 Fax Server
71
Figure 3.58: Fax Server - FAX at telephony card
• Sender of notifications: It’s a internal email account that will send the notifications to users that are using the Mail2FAX. Examples: Error sending the
fax, successfully task completed etc. By default we use IPBrick Fax Server
that will use the current domain;
• Sender of received fax notifications: Identification of the reception warnings
sender. By default we use IPBrick Fax Server.
If the inserted Fax is connected to a serial port, there are some options:
• Send to: At this moment the single option available is sending to email;
• Destination: Is the email address where the IPBrick incoming faxes are
forwarded;
• File type: The format faxes will be delivered (pdf, ps or tiff);
To activate configuration, click Modify
If you access the menu again, there will two new options near the link Modify:
Fax Users e Fax Lines (if the Fax is connected to an analogic telephony/ISDN
card).
iPortalMais - 2008
Reference Guide - Version 5.0
72
IPBrick.I
Figure 3.59: Fax Server - Serial Fax Modem
In Fax users (Figure 3.60), you can set which users may be authenticated in
the Fax client application and which will have permissions to manage Fax queue
lists. The FAX client is WHFC that is available for download in http://whfc.
uli-eckhardt.de/. The advantage of using a FAX client at the workstations side
Fax Line
The fax line settings are (Figure 3.61):
• Line Type: ISDN is the only option. The FAX arrives by the PSTN at a
ISDN line;
• Fax Interface: By default we can use the PSTN. It’s possible too to specify a
trunk only for FAX at Advanced Configurations - Telephony - Interfaces,
option Insert;
• Fax number: It could be represented by its DDI, by the complete fax number
or after a 0;
• Send to: Email. It’s the only option;
• Destination: Recipient email address for the Faxes;
• File type: The FAX can be received in attachment by .pdf, .ps or .tif.
Reference Guide - Version 5.0
iPortalMais - 2008
3.10 Fax Server
73
Figure 3.60: Fax Server - Fax Users
Figure 3.61: Fax Server - Fax line definitions
By default, notifications and reception warnings are delivered to email fax@<domain>.
That’s why you have to create an email account with this name or an alternative
email with the same name for other existing account.
Note: You have to activate the Fax service in Advanced Configurations - System - Services
and click in FAX. Enable Active and Automatic start.
iPortalMais - 2008
Reference Guide - Version 5.0
74
IPBrick.I
3.10.2
Mail2Fax
In Mail2Fax definitions we have two options:
• Domain for fax sending: It’s a internal domain used just to send FAX’s. You
can choose any domain you want, but the recommended one is fax.domain.com.
When the email server receives one message for that FQDN, the message attachment will be forwarded to the FAX server that sends the FAX by the
PSTN;
• Presented source fax number: For each LDAP group it’s possible to define
what would be the source fax number field when someone sends a FAX to
the PSTN;
After update configurations you will be able to send Faxes from a workstation
using a simple email client. At the workstation side just:
• Map a email account pointing the SMTP to the IPBrick or use webmail;
• At the To: field insert number@fax_domain. Example 221121112@fax.domain.com;
• The subject is optional, so the next step is to attach a .pdf file that will be
the FAX;
3.10.3
Statistics
This menu displays statistics about Sent Faxes, Incoming Faxes and in course
tasks.
Sent Faxes
Visible fields (Figure 3.62):
• ID: Fax identification;
• Date: Sending date;
• Owner: Fax Sender;
• Pages: Number of Pages;
• Origin: Origin email address;
• Number: Fax number;
• Attempts: Number of attempts;
• State: Fax sending status.
Reference Guide - Version 5.0
iPortalMais - 2008
3.10 Fax Server
75
Figure 3.62: Fax Server - Sent Faxes
Received Faxes
Visible fields (Figure 3.63):
• Sender: Sender name;
• Destination: Receiver number;
• Pages: Number of pages;
• Reception date;
• File: Fax file.
Figure 3.63: Fax Server - Received Faxes
iPortalMais - 2008
Reference Guide - Version 5.0
76
IPBrick.I
Current faxes
Visible fields (Figure 3.64):
• Delete: Deletes Fax;
• ID: Fax identification;
• Owner: Fax sender;
• Number: Fax number;
• Pages: Number of pages;
• Attempts: Number of attempts;
• State: Fax sending status.
In this menu you can visualize statistics and Delete Tasks.
Figure 3.64: Fax Server - Current Faxes
3.11
Terminal Server
IPBrick terminal server provides an Operating System loading through the
network for the terminal stations, that can operate only with browsers, and for
Windows machines through remote desktop. ⇒ Note: IPBrick must be working
as a DHCP in the network (and has to be the only DHCP server). The client of
terminal server receives from IPBrick the necessary information to boot from the
network.
Reference Guide - Version 5.0
iPortalMais - 2008
3.11 Terminal Server
3.11.1
77
Configuration
First, you have to activate Terminal Server in IPBrick’s web interface. To
proceed with this operation go to IPBrick.I - Terminal Server. To activate,
click Modify and choose Yes;
After the activation, you may configure terminal server in this fields:
• Display [2 to 5]:
– Server Remote Desktop: The connection is made by the terminals to
IPBrick. IPBrick is responsible for the connection with the Windows
Server:
∗ Server: Address to connect by remote desktop;
∗ Domain: Indicate the Windows domain that is going to connect (ex:
iportal2003).
– Terminal Remote Desktop: The connection to the server is directly
made by the terminal:
∗ Server: IP Address of the server to connect by remote desktop;
∗ Domain: Indicate the Windows domain that is going to connect (ex:
iportal2003).
– Mozilla-Firefox: Open a Firefox browser session;
– Telnet Session:
∗ Server: IP Address of the telnet server. It is possible to connect to
other service by indicating a specific gate. Syntax: ip_address:port;
– Linux Remote Desktop: Remote connection to a Linux machine;
– Others: It presents a command line
• Keyboard model: It depends on the number of keys. There are the following
options:
– pc101;
– pc102;
– pc103;
– pc104;
– pc105.
• Keyboard layout:
– de: german;
– es: spanish;
– fr: french;
– pt: portuguese;
– us: english.
iPortalMais - 2008
Reference Guide - Version 5.0
78
IPBrick.I
• Mouse protocol: Type of protocol used by the mouse in the client station;
• Mouse device: System Device that will be used (/dev/...);
• Mouse resolution: Resolution mode that is used by the mouse;
• Mouse buttons: Number of mouse buttons;
• X Server: Specific commands to run the graphic environment. auto is the
default mode;
• Printer [0...1] type: Sets the printer type you want to use;
• Printer
[0...1] device: Specific device for the printer (/dev/...);
• Local Device [0...2]: Other devices you want to use (/dev/...);
• Mode [0...2]: Possible image resolutions..
– 1768x1024;
– 1024x768;
– 800x600;
– 640x480;
• Module 01...02: Makes possible the loading of two Kernel modules.
You can see a first configuration example in Figure 3.65 and Figure 3.66
Boot and Operating System
If using thinclients, after the first terminal configuration here, IPBrick will need
a LTSP boot system and a operating system. The boot system (kernel) will be
loaded into the thinclients memory.
Boot Systems
To load Boot systems (Kernel) click on kernel link (Figure 3.67). The following
fields are displayed:
Boot system configuration:
• Description: Kernel text description;
• Boot loader: It will be selected later;
• Kernel: If you click Archive you should select the Kernel file from the above
link.
In the next step you have to choose the boot loader. If the thinclients support
PXE boot, choose the following boot loader /pxelinux.0 (Figure 3.68).
Operating Systems
To load the Operating System you have to click in top menu on OS (Figure
3.69), and after that click insert to display the following options:
Reference Guide - Version 5.0
iPortalMais - 2008
3.11 Terminal Server
79
Figure 3.65: Terminal Server - General Configuration - 1/2
• Description: Description of the operating system;
• Operating system: If you click Archive you should select the OS version
to run.
The Kernel and Operating System files should be downloaded at:
http://downloads.ipbrick.com/IPBrick/download/ltsp/
For IPBrick 5.0 you need to download the files:
debian_ltsp5_BOOT_final.tgz
debian_ltsp5_OS_final.tgz
For older versions of IPBrick you need the files root.tgz (OS) and 2.6.9-ltsp-3.tgz
(Boot system). A full configuration example to boot from a PXE thinclient can
be viewed at Figure 3.70.
Machines
If the terminals are registered in IPBrick (IPBrick.I - Machines Management)
you may personalize configurations for a terminal in the machines link (Figure
3.71) by selecting if the default options set in the top menu of configuration are
going to be used.
iPortalMais - 2008
Reference Guide - Version 5.0
80
IPBrick.I
Figure 3.66: Terminal Server - General Configuration - 2/2
Figure 3.67: Terminal Server - Boot System configuration
After loading the boot system(s) and the operating system(s), you should click
Back and Terminal OS and choose the Kernel and the Operating System you want
to use.
Reference Guide - Version 5.0
iPortalMais - 2008
3.11 Terminal Server
81
Figure 3.68: Terminal Server - Boot Loader configuration
Figure 3.69: Terminal Server - Operating System
3.11.2
Client configuration
You should boot from network to make available for the clients the Terminal
Server. For example if you use a Book PC, the machine should be booted and the
access to BIOS is made with the keys Shift + F10. The configuration should be
(it is possible to modify the values through the directional keys (<- and ->)):
Network Boot Protocol : PXE
Boot Order : Int 19h
Show Config Message : Enable
Show Message Time : 3 Seconds
After this configuration, it appears a orange window with this message:
Always boot network first, the local devices.
iPortalMais - 2008
Reference Guide - Version 5.0
82
IPBrick.I
Figure 3.70: Terminal Server - Configuration for PXE boot
Figure 3.71: Terminal Server - Machines
After these changes you have to confirm them by clicking the key F4. This
procedure makes sure that the client machine will boot from the network.
After the client machine rebooting, this machine will boot through IPBrick.
Note: If the login screen of Linux graphic interface appears after the booting
, you have to restart X Server with the keys [CTRL] + [ALT] + [BACKSPACE].
If the same window appears even after the restart, it is possible to validate with
user ltsp and password ltsp.
Reference Guide - Version 5.0
iPortalMais - 2008
3.11 Terminal Server
83
Several screens may be active for the same client (depending on what was set
in the Number of Displays field of IPBrick). Browsing across screens can be made
with keys combination [CTRL] + [ALT] + [F1] for screen 1, [CTRL] + [ALT] +
[F2] for the screen 2, and so on.
iPortalMais - 2008
Reference Guide - Version 5.0
84
Reference Guide - Version 5.0
IPBrick.I
iPortalMais - 2008
Chapter 4
IPBrick.C
This chapter describes the IPBrick menus that are used to manage the main
communication services between the company and the Internet. The menu IPBrick.C like the menu IPBrick.I is a menu of functional configuration. The IPBrick Administrator says what he pretends and the software makes the configurations according to the given indications and maintains the consistence of them.
This chapter is divided into the following sections:
• Firewall;
• Proxy;
• VPN;
• E-Mail;
• Web Server;
• FTP Server;
• Webmail;
• VoIP;
• IM.
4.1
Firewall
Note: Any rule change of the firewall implies the activation of the firewall.
Even if the firewall has been expressively stopped the change of one of its rules
implies the restart of the firewall.
4.1.1
Available Services
Presentation
IPBrick has a number of installed services. Part of them is enabled and part
of them is stopped. Part of them is for the Intranet and (some) others are wanted
iPortalMais - 2008
Reference Guide - Version 5.0
86
IPBrick.C
to be available for the Internet, too. In this interface you give indication to the
firewall concerning the services related with the Internet that have to be available
from the external world.
These services are:
• Web Server;
• E-mail server;
• SSH;
• FTP.
Body
The list (Firewall ¿ Available Services (Figure 4.1), indicates the service status
- whether the firewall is configured to let that service work (Active) or it is configured to block those service ports (Inactive).
Note that defining here a service as active doesn’t start the service or stops it.
The single change implemented in the Definitions Update only affects the firewall
service (first it stops, reconfigures and then restarts). In other words, here you can
only configure the firewall to open or to shut the Internet port for a defined service
(whether the service is working is another configuration besides this section).
4.1.2
Block Services
Like the situation before the option to block services only Enables (unlocked)
or Disable (locked) the normal operation of the shown applications (Figure 4.2).
4.2
Proxy
The proxy service aims the Web access to network users and is commonly used
to get a better network management. It makes cache from the accessed site files,
providing a better band width management and the personalization of parameters
like who’s allowed to access the web and in what time and kind of pages can be
visited.
The software that implements the IPBrick proxy service is named squid and
runs on gate 3128.
The section is subdivided into three parts, namely:
• Configuration;
• Statistics;
• Kaspersky Proxy.
Reference Guide - Version 5.0
iPortalMais - 2008
4.2 Proxy
87
Figure 4.1: Firewall - Available Services
4.2.1
Configuration
Presentation The presented main proxy configuration (Figure 4.3) determines
the normal operation of the Internet browsers. Therefore it is recommendable to
define each Proxy type first:
1. Standard Proxy: It is not obligatory to use the proxy to access the Internet.
The proxy is only used by those who configure the browser to use the proxy
from the IPBrick port 3128. Users without any additional browser configurations continue to access the Internet without any problems.The web accesses
are registered by IP’s for statistical aims.
2. Transparent Proxy: Every Internet access is done through the proxy. The
firewall has to be activated. Users may configure their browsers to use the
indicated proxy. They may also continue to access the Internet without any
proxy configurations in their browsers. Here the firewall makes the traffic
routing to the proxy. The web accesses are registered by IP’s for statistical
aims.
3. Proxy with authentication: The Internet access is only possible by using
this proxy. In order to have a web access users have to configure their browser
with this proxy. Once the browsers are configured a valid authentication is
asked whenever the users open the browser to access the Internet. The user
iPortalMais - 2008
Reference Guide - Version 5.0
88
IPBrick.C
Figure 4.2: Firewall - Block Services
authentication is done with logins and passwords. The firewall has to be
activated. All web accesses are registered for each user for statistical aim.
Configurations
Link to the proxy rules settings. This interface (Figure 4.4) has the following
options:
• Source groups list: Sets an origin group with access to proxy. After this
group creation, the accesses can be set by: Machine group, Machine, IP
Subnets, IP Machines and IP ranges.By default IPBrick has a LAN group
with its own defined IP Subnet;
• Destination groups list: Sets destination groups (Web servers). You
can set Domains, Extensions or Words in the URL each created destination
group. By default the created group is named INVALID;
• Blacklists: Displays the set of blacklists that were configured at Other
configurations;
• List of time spaces: Sets specific periods based on hours and week days;
• Access Lists: Sets access permissions from the created origin and destination groups, as well as defined blacklists and periods. For instance, you
Reference Guide - Version 5.0
iPortalMais - 2008
4.2 Proxy
89
Figure 4.3: Proxy - Configuration
can set that all destinations can be accessed by the LAN group, with the
exception of INVALID destination group and blacklist porn, in an undefined
period (always).
Source groups list
To modify the LAN group you just have to click on the name. You can insert
a new origin group clicking on Insert link. Settings:
• Machine groups: You can associate to this group an existing machine group;
• Machines: Lists the machines that are registered in IPBrick and provides
direct association to the origin group;
• IP subnets: Provides subnets association, defining the network IP and its
mask;
• IP machines: Provides machine association to the group by IP;
• IP ranges: You can set IP ranges with proxy access.
By default the proxy have a source group called LAN where only the IP Subnet
is used (Figure 4.6).
iPortalMais - 2008
Reference Guide - Version 5.0
90
IPBrick.C
Figure 4.4: Proxy - Rules 1/2
If you choose the proxy with authentication mode, it’s possible to filter the
web access’s not only by machines IP but using LDAP too. In Figure 4.7 we can
see an example of a source group represented only by a LDAP group.
Destination groups
Destination groups (Figure 4.8) are like a group (identified by name) of access
web servers. This destinations are configurable with their definitions in:
• Domains: You may configure FQDN1 access, by domain or by TLD2 accessadding a record to each line. Some possible denial examples:
FQDN example:
www.sapo.pt
www.marca.es
Domain example:
sapo.pt
marca.es
1
2
Fully Qualified Domain Name
Top Level Domains
Reference Guide - Version 5.0
iPortalMais - 2008
4.2 Proxy
91
Figure 4.5: Proxy - Rules 2/2
TLD example:
pt
es
• Extensions: In order to prevent certain files download through web pages you
need to deny access to some file extensions. The following example shows
that the download of three file extensions won’t be possible.
Example of extensions denial:
mp3
mov
mpg
• Words in URL: You can deny in this field the access to pages that contain
certain words after the domain (after the slash). An example for two words:
Denial example for word in the URL:
video
jokes
The following sites would be denied:
http://www.mtv.com/music/video/
iPortalMais - 2008
Reference Guide - Version 5.0
92
IPBrick.C
Figure 4.6: Proxy - Source groups
Figure 4.7: Proxy - Source groups - LDAP filter
http://en.wikipedia.org/wiki/Video
http://kids.yahoo.com/jokes
Reference Guide - Version 5.0
iPortalMais - 2008
4.2 Proxy
93
Figure 4.8: Proxy - Destination groups
List of time spaces
This option lets you specify periods to be used afterwards in Access Lists. This
periods could be week days or hours.
Access Lists
There is already a pre-configured access list in IPBrick specifying this: Attempts to access sites made from LAN origin which aim sites not included in the
destination group INVALID nor the porn blacklist, in an undefined period (24
hours) are accepted. Because there are no more lines created, all the remaining
will be blocked (Figure 4.9).
Access lists have the following structure:
• Source: Origin group identification that is aimed by the rule;
• Destination: Destination groups identification that are aimed by the rule;
– Available Groups: You can make for the created destination groups
the following rules: Access to included sites ONLY IN destination group
x; Access to sites NOT IN destination group x; Access to sites ALLOW
IN destination group x;
iPortalMais - 2008
Reference Guide - Version 5.0
94
IPBrick.C
– Blacklists: Lets you select which blacklists are activated. Example:
If the porn list is selected, every sites that are out of the list can be
accessed.
• Period: The time period (already inserted) that the rule is active;
• Policy: This is not configurable, the value is always to deny all that is not
set in the access lists.
Access lists should be ordered by rules from generic to specific. The generic
rules should be placed at the top and more specific rules should be placed at the
bottom (as in the firewall case). If there are several access lists you can order them
clicking on Order by.
Figure 4.9: Proxy - Access Lists
Remote Proxy
In this option you can indicate a list of remote proxy servers. These servers
should provide web access because they usually have a huge cache, increasing the
speed of web access (Figure 4.10).
• List of remote proxy servers: You can use several web proxy’s and after
that order that list;
Reference Guide - Version 5.0
iPortalMais - 2008
4.2 Proxy
95
• Dont use remote proxy for the following sites: If you don’t want to
use remote proxy for certain sites, you must indicate them here.
Figure 4.10: Proxy - Remote Proxy
Other configurations
Blacklists
In this context, blacklists are set as site lists organized by several categories
that are considered inconvenient. You can find here the following options (Figure
4.11):
• Url for update: Address that provides the file download with the list of
sites to block - by default this is the squidGuard URL. The file is automatically uncompressed to the system. To update the list immediately click
Update;
• Current file MD5SUM: MD5 Hash of the file if it’s calculated. It lets you
check file integrity;
• Available categories: Categories list present in the compilation (usually
they are considered unsuited to LAN use)
– ads: List of advertisement sites;
iPortalMais - 2008
Reference Guide - Version 5.0
96
IPBrick.C
–
–
–
–
–
–
–
–
–
–
aggressive: List of violent content sites;
audio-video: List of music and video content sites;
drugs: List of drug related content sites;
gambling: List of gambling sites;
hacking: List of hacking sites;
mail: List of sites that provide free webmail services;
phishing: List of sites about phishing;
porn: List of sites with pornographic content;
proxy: List of sites that provide anonymous proxy service;
warez: List of sites with pirate software content.
Content access management
Sets the number of simultaneous filtering processes that depends on the machine performance and the present CPU load. The default is five processes.
Proxy cache options
• Cache enabled: Activates the Proxy cache service. If the cache is activated,
every page accessed by the origin groups are stored in the server. Example:
If the page www.google.com is in the cache, the browser will only access to
IPBrick, instead of accessing the google web server, providing a better band
width management.
• Cache size: Maximum cache size. If the limit is reached, the older cache
files are removed.
• Cache location: The default is the /var partition. If you choose a big
cache size it’s a good option to choose the /home1 or /home2 partition.
All this settings can be viewed at Figure 4.11.
4.2.2
Statistics
Advanced Web Statistics 6.4 is the software that generates several important
statistics for the network administrator, like detailed cache statistics, accesses (Figure 4.12).
There are different statistics types:
• Global statistics: Global network statistics;
• Statistics by machine: You have to select the machine you want from a
list of LAN machines. The purpose is to give individual statistics for each
machine;
• User statistics: If proxy configuration has authentication, it’s displayed
here a user list. You have to select the user from this list to have their
individual statistics.
Reference Guide - Version 5.0
iPortalMais - 2008
4.2 Proxy
97
Figure 4.11: Proxy - Other configurations
4.2.3
Kaspersky Proxy
In this section you may activate Kasperky license for the proxy. With this
procedure all the web accesses made from the browser are filtered by the Anti-Virus
that is running on the proxy to provide an effective protection against Trojans,
Spyware, Dialers, etc.
After inserting the license, the interface displays the following links (Figure
4.13):
• Update: After the license expiration you should renew with a new license
file;
• Delete: Removes the license;
• Configure: It provides you a general Anti-Virus configuration option;
• Statistics: Interface with specific statistics about proxy Anti-Virus.
Configure
General settings:
• Notify from the address: Sender that will make the notifications;
iPortalMais - 2008
Reference Guide - Version 5.0
98
IPBrick.C
Figure 4.12: Proxy - Statistics
Figure 4.13: Proxy - Kaspersky - Licence
• Notify to the address: Email address that will receive notifications.
Object settings:
• Objects to analyse:
– Compressed files;
– Archives;
Reference Guide - Version 5.0
iPortalMais - 2008
4.2 Proxy
99
– Mail databases;
– Plain mail format.
Scan settings:
• Cure: If activated, detected virus will be automatically removed;
• Use heuristic: If activated, virus can be detected through the analysis of
the code with characteristics and behavior similar to a virus.
To modify that configurations (Figure 4.14) you need to click Modify.
Figure 4.14: Proxy - Kaspersky - General Settings
Statistics
Several statistics are displayed in this interface:
• Virus Statistics in period: Options to display present graphic in Virus
Statistics:
– Start: The starting date for statistics;
– View: Can be set in hours, days, months or years;
– Repetition: Scale of the graphic horizontal axis;
– Group: It enables you to group data, depending on the chosen view
• Vı́rus statistics: The display can be filtered by: Infected files or protected;
• Virus list: Can be organized by Virus name/Number of occurrences.
An example can be viewed at Figure 4.15
iPortalMais - 2008
Reference Guide - Version 5.0
100
IPBrick.C
Figure 4.15: Proxy - Kaspersky - Statistics
4.3
VPN
VPN3 provide remote access from the exterior (ex. Internet) to the network
resources of a defined network.
4.3.1
PPTP
A PPTP4 VPN type works by providing a PPP session with the recipient
through the tunneling GRE protocol. It needs another network connection to
start and manage PPP session that runs on port 1723 TCP. In IPBrick case, you
have to indicate who are the users that access VPN-PPTP connections, as well as
the address range that will be used by clients.
Configurations
Top Menu Here you have a link to Configurations. This link gives you access
to a form where you define the range of IP addresses chosen for VPN connections.
3
4
Virtual Private Networks
Point-to-Point Tunneling Protocol
Reference Guide - Version 5.0
iPortalMais - 2008
4.3 VPN
101
Figure 4.16: VPN - PPTP - Users
Remote clients will get an IP in this group when they make an IPBrick connection.
It is as if they were connected to the network server with an IP from this range.
Body The user list shown on the left side in Figure 4.16 presents the selected
VPN users. On the right side you find the users registered in IPBrick.
Access log
The access log option permit the visualization of all PPTP accesses. It’s possible to filter by:
• IP;
• User;
• Notes:
– Connected;
– Disconnected;
– Wrong password;
– Illegal user;
– Locked;
iPortalMais - 2008
Reference Guide - Version 5.0
102
IPBrick.C
– Timeout.
• Date;
Options available:
• Clean filters: Will clean all the chosen filters;
• Export PDF: Exports all the information to a .pdf;
• Back: Go back to the top menu;
4.3.2
IPSec
IPSec (IP security) technology is a suite of protocols that ensure confidentiality, integrity, authenticity to data transmission on an IP network. SSL protocol
works at the transport layer level - IPSec operates at the network layer level and
consequently provides data encryption in this level.
VPN through PPTP or SSL provides a connection between a defined machine
and the network. On the contrary VPN IPSec allows two networks to communicate permanently and in a transparent way. This is accomplished with an IPSec
configured between two IPBrick’s or between an IPBrick and a router, providing
full configuration transparency to users from the two networks.
Example: 192.168.2.0 network that belongs to the Company X headquarters
in Oporto, Portugal and network 192.168.4.0 belongs to its office branch located
in Japan. Both networks should have Internet connection to make possible the
communication between their machines through a VPN IPSec tunnel. With this
feature two networks can behave as if they where one.
To configure a VPN connection between two networks you need to have the
appropriate configuration in origin and destination IPBrick’s for the IPSec tunnel.
Body After clicking the IPSec, the configured IPSec tunnels are displayed in
that section body.
Top Menu There is a connection named Insert that allows to insert a new IPSec
tunnel.
Body In this page we have configured the IPSec connection (as you may see in
Figure 4.17). The following data are necessary:
• General settings
– Name: VPN IPSec name;
– Description: Description of the IPSec connection;
Reference Guide - Version 5.0
iPortalMais - 2008
4.3 VPN
103
– State: VPN IPSec state - enable or disable;
• Local Network Definitions
– Local IP: IPBrick external interface address;
– Local network: Local network address and respective IPBrick network
mask;
– Local Gateway: Router internal interface address;
– Local Identification: Dynamic DNS address (by default, this field
should be empty. It’s used if the network don’t have fixed public IP);
– Server IP in local network: IPBrick internal interface address.
• Remote network definitions
– Remote IP: Remote public address;
– Remote network: Remote network address and mask;
– Remote Gateway: Remote network router internal interface address (by
default, this field should be empty);
– Remote identifier: Dynamic DNS address (by default, this field should
be empty. It’s used if the network don’t have fixed public IP).
• Keys Management
– Password: A Pre-Shared Key is a shared key that the VPN service
expects as a first credential (before username and password). In order
that the VPN server allows the authentication process to continue, it is
necessary to pass the correct PSK;
– Type: The IPSec supplies two operation methods specified in this field,
which are Tunnel (where the original IP pack is encrypted) and Transport (the data (payload) are encrypted, but the original IP heading is
not changed);
– Authentication: IPSec adds two extra headers to the IP package AH and ESP. The AH (Authentication Header) insures integrity and
authenticity, but not confidentiality. ESP provides data integrity, authenticity and confidentiality;
– PFS5 : Allows PFS protocol that adds additional security in the keys
exchange;
– Start: Only automatic is available.
NOTE: When a IPSec tunnel is configured, the MTU for the public IPBrick
interface is changed to 1400 because of the additional header overhead added by
the IPSec. If you found some LAN problems with web access, change again the
MTU to 1500 bytes.
5
Perfect Forward Secrecy
iPortalMais - 2008
Reference Guide - Version 5.0
104
IPBrick.C
Figure 4.17: VPN - IPSec Configuration 1/2
Router configuration
In case of a VPN IPSec not between two IPBrick’s but between a IPBrick and
a router, at the router side it’s important to know all parameters used by the
IPBrick that are transparent to the web interface. Here are the most important
ones:
• Negotiation key protocol: IDE;
• Negotiation mode: Normal;
• Fase 1 encryption Algorithm: 3DES;
• Fase 1 authentication Algorithm: MD5;
• Fase 2 encryption Algorithm: 3DES;
• Fase 2 authentication Algorithm: SHA1;
• Key Group: DH2;
4.3.3
SSL
A VPN-SSL uses the SSL encryption protocol to insure data privacy and integrity between the two parts because the protocol provides data encryption and
Reference Guide - Version 5.0
iPortalMais - 2008
4.3 VPN
105
Figure 4.18: VPN - IPSec Configuration 2/2
authentication. SSL is based on TCP protocol and uses the Public key cryptography concept (introduced by Diffie-Hellman in the 1970 decade).
This concept specifies that each part has a Private Key and a Public Key that can
be distributed by people that want to have encrypted communication. Encrypted
data with the Public Key are only decrypted by the corresponding Private Key.
Encrypted data with the Private Key are only decrypted by the corresponding
Public Key.
After clicking on SSL the list of VPN SSL servers is shown. To configure the
tunnel you must click on it (Figure 4.19).
Definitions In this section you can configure the definitions of the VPN-SSL
network.
• Name/IP: Name or public IP address of the network;
• Port: The port of the VPN server. The default for SSL is 1194;
• Protocol: The transport protocol used in the communication. TCP is more
reliable buy will add an extra overhead;
• VPN Network: The IP network which will be given to the clients. When a
user connects to this vpn server, he will get an IP address in this IP network.
iPortalMais - 2008
Reference Guide - Version 5.0
106
IPBrick.C
Figure 4.19: VPN - SSL Settings
This network should be different from any other IP network in the company;
• Domain: The domain offered to the clients;
• DNS Servers: The DNS server passed to the clients;
• NetBios Servers: The netbios server passed to the clients;
• Routes for clients: Sets all the networks that client must have access
through the tunnel.
NOTE: If you want to use a VPN SSL and use the same email client with
the internal mail server configurations, you need to add the VPN Network to the
Relay networks definitions at email;
Certificates After Definitions configuration its necessary to create SSL digital
certificates. A digital certificate has the following informations:
• Identification of the titular entity;
• Public Key for the titular entity;
• Serial number Certificate;
Reference Guide - Version 5.0
iPortalMais - 2008
4.3 VPN
107
• Valid date Certificate;
• Identification of the Certifying Authority (The Certificate issuing entity);
• Digital signature of the Certifying Authority.
It will be generated a Digital Certificate for the server and for each of the
clients using the VPN SSL connection. Clicking on Insert you start by the server
Certificate generation. You have to insert data in the following fields:
• Country Code;
• Country;
• City;
• Company;
• Nome: Certificate name;
• Email: Company’s email.
Then you generate the client certificates - you have to insert Certificate name,
Client email and Password. The next step consists in downloading the certificate
and sending it to the client that will make the VPN connection. The .zip file
contains: Server and client public key, client private key and the VPN tunnel configuration that will be implemented.
Client
In the client side you have to install the specific software to create the VPN
SSL connection- OpenVPN6 . Then you must uncompress the certificate file to a
new directory in
c:\Program Files\OpenVPN\config.
To start VPN connection you have to click on the OpenVPN icon located in the
tool bar with the right button, choose the connection you want and click Connect.
The option Delete All should only be used to restart the all process.
State
This interface shows you the active tunnels and their respective traffic, users
and IP
After configuring this service you have to activate it in section Advanced
Configurations System Services. The procedure to configure VPN client
is described in detail at Appendix B.
6
Software: openvpn.net — Windows GUI: openvpn.se
iPortalMais - 2008
Reference Guide - Version 5.0
108
IPBrick.C
⇒ Note: Before configuring a VPN connection, PPTP, IPSec or SSL, you
have to know what is the addressing system used by the local network where the
client connects and what is the destination network addressing system. If there is
the same addressing system in both networks, obviously the VPN connection will
be impossible.
4.4
E-mail
The E-mail section is repeated in the two IPBrick modules. IPBrick.I provides
services oriented to Intranet: Base Configuration, Queue Management, User Management, Distribution Lists and Kaspersky Anti-Virus and Anti-Spam. IPBrick.C
provides additional services:
• Advanced relay;
• Get Mail from ISP;
• Mail copy.
4.4.1
Advanced relay
The advanced relay option makes possible to forward emails based on nonexistent recipients and also to forward all the mail that come to a domain. This
last feature is also known as catchall (Figure 4.20).
Relay definitions:
• Email/Domain
– Email: Insert a invalid recipient that don’t have any LDAP account
created and the internal domain;
– Domain: Choose for each domain you want to relay all the messages;
• Relay to: Destination email. Can be an internal or a external one;
4.4.2
Get Mail from ISP
If company mails are not delivered to an internal firm server, being therefore
only available via POP7 , you can configure IPBrick in order to unload these mails
from the ISP8 periodically to a local server. Once they are in this local server the
mails are associated respectively to the previously configured accounts. In this
way you can configure a server for internal E-mails, even if you only have one, to
automate and centralize all firm e-mails (from the Internet and internal).
This feature normally called fetchmail is useful when the MX from the enterprise domain points to another server.
7
8
Post Office Protocol: Used to access inboxes and transfer mails.
Internet Service Provider
Reference Guide - Version 5.0
iPortalMais - 2008
4.4 E-mail
109
Figure 4.20: E-Mail - Advanced relay
Top Menu
Click Insert (Figure 4.21) external servers that you want to connect to download email and deliver it in the local server. You have to insert data in the following
fields:
• Server: Server identification. It could be FQDN and IP address;
• Protocol: Protocol that is used by the server - POP3 or IMAP;
• Remote domains: Domains that deliver email to the server. It is commonly
used in volume email boxes.
Body
To access server definitions, you must click on its name (Figure 4.21):
• Modify: To change the account data;
• Delete: Deletes the selected account;
• Back: Goes back to email servers list.
To access the management interface of remote mailboxes, you must click insert
and fill in the following fields (Figure 4.23):
iPortalMais - 2008
Reference Guide - Version 5.0
110
IPBrick.C
Figure 4.21: E-Mail - Get Mail from ISP - Base menu
Figure 4.22: E-Mail - Get mail from ISP - Servers Management
1. Mailbox type: Select individual mailbox or volume box, the last one refers
to boxes that are not assigned to any user;
2. Login: Used username to access the email remote box;
Reference Guide - Version 5.0
iPortalMais - 2008
4.4 E-mail
111
3. Password: Needed to validate login;
4. Retype password: Confirm the previous password;
5. Local server email: If the individual mailbox is chosen, this field is the
local email account where the downloaded emails will be delivered;
6. Drop ’Delivered-To’: If the email address in ISP is the same as the email
address in local server, this field must be active.
Figure 4.23: E-Mail - Get mail from ISP - Add Account
4.4.3
Mail Copy
This feature ((Figure 4.24)) aims to save all the incoming and outgoing email
messages in two accounts: sentmail and receivedmail.
Note: It is necessary to pay attention to the management of these Mail Copies,
especially in places with a lot of e-mail traffic. It is very important to control the
development of the occupied server hard drive space. These e-mail inboxes may
quickly reach the full size of the partition. By reaching this size they may cause
some trouble either with interferences with other server applications or to the ones
responsible for these e-mail inboxes that at a certain stage will loose a series of
mails because no copy could have been made.
When you activate this service (Yes) the mails are copied to the corresponding
account, that is:
1. Sent: YES, all mails that get through this SMTP server and whose sender
is from the server domain(s) will be copied to the Sent Mails local account.
2. Received: YES, all mails that get through this SMTP server and whose
sender is not from the server domain(s) will be copied to the Received Mails
local account.
iPortalMais - 2008
Reference Guide - Version 5.0
112
IPBrick.C
Figure 4.24: E-Mail - Mail copy
When you activate the option (Yes) the system shows the Delete Automatically
the Copies field. This field allows defining whether the mail copies that are in
the server are to be deleted or not. The Delete Copies With More Than field
allows specifying the days after which mail copies are to be deleted in the server.
4.5
Web Server
A web server, through the HTTP9 and/or HTTPS protocols, is responsible for
the answers to users requests, concerning the web pages lodged in it, and each
server may lodge several sites. The IPBrick web server running in IPBrick 5.0 is
Apache 2.2.310 . The base virtual hosts registered in IPBrick are displayed after
clicking on Web Server and may be seen in Figure 4.25.
IPBrick hosts the following sites by default:
• ipbrick.domain.com: IPBrick web management interface;
• myipbrick.domain.com: Site for LDAP users configuration reaching general
and email definitions;
• calendar.domain.com: Intranet LDAP agenda;
9
10
HyperText Transfer Protocol
For more information please visit http://www.apache.org
Reference Guide - Version 5.0
iPortalMais - 2008
4.5 Web Server
113
Figure 4.25: Web Server - Hosted sites
• callmanager.domain.com: Flash application for VoIP;
• contacts.domain.com: Intranet LDAP contacts management;
• jwchat.domain.com: A web-based Jabber (XMPP) client for the IPBrick
LDAP users;
• mysqladmin.domain.com: MySQL database web management;
• pgsqladmin.domain.com: PostgreSQL database web management;
• ucoip.domain.com: UCoIP (Unified Communications over IP) site for LDAP
users. All enterprise communications - Voice, Mail, Instant Messaging and
Web - are managed in an integrated way, i.e. unified through a single individual or group address. To reach this goal, IPBrick uses only Internet
communications services (SIP, SMTP/IMAP, XMPP and HTTP) integrating with DNS and LDAP support services.
The generic site is ucoip.domain.com but the idea is to have one site for
each LDAP user. The following options are included:
– A IAX webphone for direct connection to the user SIP url;
iPortalMais - 2008
Reference Guide - Version 5.0
114
IPBrick.C
– A SIP url link to call the user using a softphone previously installed at
workstation;
– A web-based Jabber (XMPP) client to chat directly with the user;
– A SMTP link to mail the user using a email client at workstation;
Like we can see, for SIP/SMTP/XMPP the user will be reached using the
single address user@domain.com. The UCoIP site design is simply but it can
be improved. It’s possible to use a specific FTP account for site management:
– username: ucoip;
– password: 123456.
Now we present all the necessary steps to configure a UCoIP site for a specific
LDAP user with username jsmith, with IPBrick FQDN being ipbrick.domain.com:
– The user jsmith must go to https://myipbrick.domain.com and define a phone (depending of the IPBrick.GT routes can be a SIP/PSTN/GSM
number) at field SIP Address. Examples: 101@domain.com, 00351221121112,
00351963322212;
– Activate the IM service at IPBrick.C - IM;
– Go to IPBrick.C - Web Server, click at ucoip.domain.com and define the alternative address jsmith.domain.com;
– At private/public DNS server add a record named jsmith, pointing to
that IPBrick server;
• webacula.domain.com: Bacula backup server web administration;
• webmail.domain.com: Horde webmail client;
• webphone.domain.com: It’s a IAX webphone example. The idea is to view
the page source code and include it in a real website. This webphone can
be configured to call directly any number you want or to match some direct
access for a VoIP funcionality (sequence, groups, IVR etc). To specify that,
the variable called url must be changed.
The source code of this page is presented next:
<script language="JavaScript">
function webphone() {
var day = new Date();
var id = day.getTime();
var url = ’index2.php’;
eval("page" + id + " = window.open(’" + url +"’ , ’" + id + "’, ’toolba
}
</script>
Reference Guide - Version 5.0
iPortalMais - 2008
4.5 Web Server
115
<h1>Example Link</h1>
<a href="javascript:webphone()"><img alt="IPBrick.GT high versability working
for the New Internet" src="webphone.jpg"></a>
Examples of url variable definition:
var url = ’index2.php?user=jdomingues’;
var url = ’index2.php?user=200’;
var url = ’index2.php?user=IVR2’;
NOTE: From now, this webphone can be used only with Internet Explorer.
4.5.1
Creating a new site
By clicking in Insert it’s possible to create a new site. A new form is displayed
(Figure 4.26) with the following fields:
Figure 4.26: Web Server - Adding sites
1. URL address: It’s the FQDN11 of the new site that will be hosted in the
server. It’s possible to use SSL too. Example: www.domain.com;
11
Fully Qualified Domain Name
iPortalMais - 2008
Reference Guide - Version 5.0
116
IPBrick.C
2. Alternative URL address: Alternative name(s) for the URL address that
was previously set. This field is not mandatory;
3. Site administrator email: E-Mail of the user that is responsible for the
site management;
4. FTP User: A new user login that will access to the site folder through FTP.
This should be the only login and shouldn’t be equal to another IPBrick
LDAP user. The site maintenance will be made through this protocol.
5. Password: Password of the FTP user.
6. Retype Password: Confirmation of Password.
7. Site folder location: Folder to be created in the server filesystem that
will be automatically created on /home1/_sites/. Usually it’s used the
name of the site;
8. Internet Availability: Choosing Yes we say that the virtualhost will be
created from this site to the IPBrick external IP - if this is the case the
created site will be available in the Internet;
9. Safe mode: If the site is php based, it deny’s the access of files outside the
site folder location, so it will interfer too with the global variables. It’s the
reason that the default mode is Disabled;
10. Access authorized only to the directories: By default the php have
access to the site folder location and to /tmp but it’s possible to add more
locations;
11. Character encoding: It’s the encoding that Apache will use for the website
depending of the content language;
12. Always keep the typed URL: Allows to keep always the requested URL;
It is also necessary to create a DNS register in the company’s external DNS
server forwarding to the company’s network public IP (register A or CNAME).
4.5.2
Management
When the site is created if you click on it as we can see at Figure 4.27, you
have many options presented:
• Back: Allows you to go back to the main webserver menu;
• Alias;
• Redirect;
• Reverse Proxy;
Reference Guide - Version 5.0
iPortalMais - 2008
4.5 Web Server
117
• Modify: Allows to modify the site fields;
• Delete: Remove the site from the web server. After clicking on Apply Configurations
the site is no longer available online. The files of the site are not eliminated
but moved to the share sites_bk1. This share is the file location of the
removed sites. When IPBrick removes these sites only the services that are
affected are reconfigured and the contents removed to an own share accessible only to LDAP Administrators. It is like in the user accounts and group
shares;
Figure 4.27: Web Server - Features
Alias
Alias or Host Header is a simple form of having access to certain contents that
are physically dislocated from the main directory of the site. Next we present two
examples:
In Figure 4.28 example we create a web alias for the folder /home1/_sites/www/site/img.
So going to www.domain.com/es/img or www.domain.com/img will be the same.
In Figure 4.29 example we have a subsite called www.domain.com/forum that
is present in filesystem at /home1/_sites/www/site/forum.
You can manage each alias if you click on it (Figure 4.30).
iPortalMais - 2008
Reference Guide - Version 5.0
118
IPBrick.C
Figure 4.28: Web Server - Alias 1
Figure 4.29: Web Server - Alias 2
Redirect
The redirect allows you to be redirected to a new URL when you type a first
URL in the browser. Some examples:
Figure 4.30: Web Server - Alias List
Reference Guide - Version 5.0
iPortalMais - 2008
4.5 Web Server
119
• In Figure 4.31 example when someone try to accede to www.domain.com/index.htm
(the file index.htm don’t exist), it will be automatically redirected to www.domain.com
/index.htm;
• In Figure 4.32 example when someone try to accede to www.domain.com/index.html,
it will be automatically redirected to www.domain.com/web/index.htm. Note
that in the source field you can insert only /index.html or www.domain.com/index.html,
it’s the same.
Figure 4.31: Web Server - Redirect - Example 1
Figure 4.32: Web Server - Redirect - Example 2
You can manage each redirection if you click on it (Figure 4.33).
Reverse Proxy
The reverse proxy is used in front of the webserver and have the main goal to
enable the webserver to provide content from another, in a transparent way for
the users.
iPortalMais - 2008
Reference Guide - Version 5.0
120
IPBrick.C
Figure 4.33: Web Server - Redirections List
• The first example stands for this situation: When LAN users enter the URL
http://estore.domainx.com they will be transfered to a internal site running in another server. So the first step is the site creation (Figure 4.34),
and after that the reverse proxy definition (Figure 4.35);
• In the second example the idea is for someone in Internet that wants to accede
a site running in a internal machine (http://192.168.1.4:85/cgi/site).
To do this we just need to add a new reverse proxy definition at the base
domain (Figure 4.36 and Figure 4.37);
Statistics
Each site in IPBrick uses Advanced Web Statistics to display many statistics
about the site accesses, the same software used for proxy statistics. To access the
statistics just go to IPBrick.C - Web Server, click in the desired site and after
that go to statistics.
Yo can get some useful information like you can at left side of Figure 4.38.
4.6
Webmail
The Webmail installed in IPBrick is Horde and can be configured to deal with
other e-mail servers that are not IPBrick. Therefore you only have to specify in
this section which IMAP12 and SMTP13 servers will be used (Figure 4.39).
To change the servers click Modify. The servers may be identified by their
FQDN14 or their IP address.
12
Internet Message Access Protocol
Simple Mail Transfer Protocol
14
Fully Qualified Domain Name
13
Reference Guide - Version 5.0
iPortalMais - 2008
4.6 Webmail
121
Figure 4.34: Web Server - Reverse Proxy - Example 1 - Empty site created
Figure 4.35: Web Server - Reverse Proxy - Example 1 - Add
If we got a Intranet IPBrick (or another intranet mail server) and a Communications IPBrick, you need to point the IMAP and SMTP to the internal mail
server address. To use the IPBrick webmail at Internet you just need to:
• Register a A record or CNAME called webmail at the public DNS server of
the company domain, pointing to the IPBrick public IP;
• If the IPBrick don’t have a public IP at eth1, configure a DNAT rule in
router to the port 443 and eth1 IPBrick IP.
iPortalMais - 2008
Reference Guide - Version 5.0
122
IPBrick.C
Figure 4.36: Web Server - Reverse Proxy - Example 2 - Add
Figure 4.37: Web Server - Reverse Proxy - Example 2 - List
4.7
FTP Server
In FTP Server it’s possible to manage single FTP accounts. The accounts can
be associated to simple Unix system users or to IPBrick websites.
Clicking Insert this fields will be presented (Figure 4.40):
• Login: FTP account login;
• Password: FTP account password;
• Retype Password;
• Account location: It’s possible to choose a individual FTP work area or
associate the account to a virtualhost;
• Create folder account: Create a new folder account at /home1/_ftp or
/home2/_ftp if the chosen work area is 2;
• Access permissions: Can be only read permission or read and write permissions.
Reference Guide - Version 5.0
iPortalMais - 2008
4.7 FTP Server
123
Figure 4.38: Web Server - Statistics
Figure 4.39: WebMail - Servers
4.7.1
Access log
The access log option permit the visualization of all FTP accesses. It’s possible
to filter by:
• IP;
• User;
• Notes:
iPortalMais - 2008
Reference Guide - Version 5.0
124
IPBrick.C
Figure 4.40: FTP Server - Account definitions
– Connected;
– Disconnected;
– Wrong password;
– Illegal user;
– Timeout/Locked.
• Date;
Options available:
• Clean filters: Will clean all the chosen filters;
• Export PDF: Exports all the information to a .pdf;
• Back: Go back to the top menu;
4.8
VoIP
This section deals with the management interface of the VoIP15 service available
in IPBrick.
15
Voice over IP
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
125
The VoIP (Voice Over IP) technology allows phone calls through an IP network, thus enabling phone calls through the Internet. The main advantages for
the use of VoIP are: reduction of expenses because the rates don’t follow the same
conventional telephony model; better service quality, since commutation by packs
does a better use of the existing network resources, different from the circuit commutation.
The IP Telephony concept sometimes mixes up with VoIP, but they are not
exactly the same thing. The IP Telephony uses VoIP service and defines itself as
the group of services and applications that allow the companies to a reduction of
phone costs.
Signalling VoIP service needs to use a protocol to signal the calls. The signalling
protocol used by IPBrick is SIP, but there are others such as H.323, MGCP, Jingle,
IAX, H.248/MEGACO etc. SIP16 allows calls and conferences through IP, and
those calls may include audio, video and images etc. This way, the SIP protocol
is responsible for all the process of calls between the users independently from the
type of contents of the call itself. The IPBrick.GT acts as an authentic PBX IP
and it can route the calls to/from a traditional PBX, Internet, LAN and PSTN.
All that management is made by a software called Asterisk. Asterisk is compatible
with the several signalling protocols, among which SIP.
The VoIP functionalities accessible through the web interface are next presented.
4.8.1
Phone management
Registered Phones
In (Figure 4.41) it is possible to see the registered IPBrick VoIP clients (IP
telephones, workstations + softphone). In section Machine Management you find
the description of the menu to insert the VoIP machines.
It is also possible to register phones in:
Advanced Configurations - Telephony - Registered Phones
This option is valid, if it isn’t necessary to attribute a specific IP address to
the phone. It is possible to add a phone just by filling the field relating the name
and the access password. This assuming that DNS is working correctly.
Alternative addresses
As you can see in Figure 4.42 , to each telephone (either a hardware telephone or a software telephone) may be associated several alternative addresses.
An alternative address is another name (or number) to reach the telephone. This
16
Session Initiation Protocol
iPortalMais - 2008
Reference Guide - Version 5.0
126
IPBrick.C
Figure 4.41: VoIP - Registered Phones
functionality is very useful when there are telephones from which you can only dial
numbers.
Figure 4.42: VoIP - Alternative Addresses
Example: There is an IP telephone with the name phone01. Through the
site myipbrick, an user called John Smith associates to this telephone, placing
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
127
in the SIP URL the address phone01. An alternative address is also created for
that telephone, with the name 5050. From that moment on, the user John Smith
may be reached either through the phone01 or 5050, but the main idea here is to
contact the user simply by jsmith@domain.com.
In top menu there is a option to insert new alternative addresses. As already
mentioned, these can have two types:
• Phone name: It is necessary to choose between the telephones in IPBrick,
which one do you want to associate to an alternative address;
• New phone alternative address: Insert the alternative address of the
telephone.
To confirm the insertion, it is necessary to click in the Insert button.
SIP URL’s
As already mentioned, it is also possible to associate a certain telephone (number or name) to an internal user of the network. The association is made from
the users email address in the field SIP URL. This operation is made through the
site https://myipbrick.domain.com. This way, to contact a certain user all you
have to do is call him/her through his/her email. The call shall be made, and
the one who’s calling knows which device the addressee shall use (mobile phone,
softphone, analogic/digital telephone).
4.8.2
Services
This section allows to configure all the IP PBX functionalities slitted into
inbound and outbound services.
Inbound
Call Groups
In this interface (Figure 4.43) is possible to define answering groups, i.e., a
group of telephones which shall ring simultaneously when the access to the group
is made. To define a group it is necessary to fulfil:
• Name: Name for the group;
• Caller ID: Possibility to use a specific caller ID for this service;
• Direct access: List of numbers/addresses that will call this service. We
have tree options and it’s possible to use many direct access’s;
– DID: If the IPBrick has a ISDN telephony card, the DID (Direct Inward
Dial) will be the direct PSTN number that will call this service;
– ANA: If the IPBrick has a analogic telephony card, will be the direct
PSTN number that will call this service;
iPortalMais - 2008
Reference Guide - Version 5.0
128
IPBrick.C
– SIP: It’s the specific SIP address that will call this service;
• Group Members
– Internal: Internal SIP phones that belong to the group;
– External: External phones (SIP, PSTN number etc) that belong to the
group.
Figure 4.43: VoIP - Call groups
Attendance seq.
In this section it is possible to define an answering sequence, or see/change/remove
the already defined sequences. To add a new sequence it is necessary to click Insert, define a name for the sequence, select if the voicemail is active or not and
in Direct Access add the addresses DID/SIP/ANA of the telephones by which the
sequence shall be activated.
If you intend to add a Direct Access for an extension defined in IPBrick, it
is possible to choose SIP and select the extension in the address. In Sequence is
possible to add the telephones which shall ring by the desired order and the time
in which each one of them plays till the next one.
To define a attendance seq. it is necessary to fill (Figure 4.44):
• Name: Name for the attendance seq;
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
129
• Caller ID: Possibility to use a specific caller ID for this service;
• Voicemail enabled: Enables the voicemail for the sequence;
• Direct access: List of numbers/addresses that will call this service. We
have tree options and it’s possible to use many direct access’s;
– DID: If the IPBrick has a ISDN telephony card, the DID (Direct Inward
Dial) will be the direct PSTN number that will call this service;
– ANA: If the IPBrick has a analogic telephony card, will be the direct
PSTN number that will call this service;
– SIP: It’s the specific SIP address that will call this service;
• Sequence positions
– Location Internal: Internal SIP phones that belong to the sequence;
– Location External: External phones (SIP, PSTN number etc) that
belong to the sequence;
– Timeout: Timeout in seconds, be default 25.
Figure 4.44: VoIP - Sequence definitions
A attendance sequences list can be viewed at Figure 4.45.
IVR Attendance
In this section is possible to define interactive answering menus (Figure 4.46).
You need to click Insert to add a new one:
iPortalMais - 2008
Reference Guide - Version 5.0
130
IPBrick.C
Figure 4.45: VoIP - Attendance sequences list
• Name: Choose a name for IVR;
• Direct access: List of numbers/addresses that will call this service. We
have tree options and it’s possible to use many direct access’s;
– DID: If the IPBrick has a ISDN telephony card, the DID (Direct Inward
Dial) will be the direct PSTN number that will call this service;
– ANA: If the IPBrick has a analogic telephony card, will be the direct
PSTN number that will call this service;
– SIP: It’s the specific SIP address that will call this service;
• Number of desired shortcuts: Choose how many options does the menu
have;
• Shortcuts: What type of destiny to give (according to the pressed key):
– Phone: To call to a internal telephone;
– IVR: To go to an interactive answering sub-menu;
– Conference: To connect to a conference;
– Scheduler: To connect to a scheduler;
– Group: To ring the telephones of a group;
– Sequence: To activate an answering sequence;
– SIP address: To call a SIP telephone;
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
131
– DISA: It allows someone outside the central to connect as if he/she is
directly connected to the central;
– Call queue: To make the call enter a waiting line;
• Attendance message: It allows the selection of an answering message. Can
be a .mp3 or .wav file;
• Number of message repetitions: Number of attendance messages replays;
• Redirect automatically when no option has been dialed: As Yes if
no DTMF pressed it can redirect the call directly to:
– Phone: To call to a internal telephone;
– IVR: To go to an interactive answering sub-menu;
– Conference: To connect to a conference;
– Scheduler: To connect to a scheduler;
– Group: To ring the telephones of a group;
– Sequence: To activate an answering sequence;
– SIP address: To call a SIP telephone;
– DISA: It allows someone outside the central to connect as if he/she is
directly connected to the central;
– Call queue: To make the call enter a waiting line;
Figure 4.46: VoIP - IVR attendance configuration
Call Conference
iPortalMais - 2008
Reference Guide - Version 5.0
132
IPBrick.C
In this interface (Figure 4.47) is possible to create conferences. To create a
simple static conference just click Insert:
• Name: The conference name;
• Numeric identifier: Numeric identifier for the conference. It’s only a
internal identifier for the VoIP server;
• PIN: Code which shall allow the users to connect to the conference;
• Administrator PIN: Conference code for the administrator;
• Direct access: List of numbers/addresses that will call this service. We
have tree options and it’s possible to use many direct access’s;
– DID: If the IPBrick has a ISDN telephony card, the DID (Direct Inward
Dial) will be the direct PSTN number that will call this service;
– ANA: If the IPBrick has a analogic telephony card, will be the direct
PSTN number that will call this service;
– SIP: It’s the specific SIP address that will call this service.
Figure 4.47: VoIP - Call conference insertion
It is also possible to allow the creation of dynamic conferences. For that, it is
necessary to click Dynamic Conferences (Figure 4.48), modify the option Active
to Yes and insert the address(es) and/or number(s) for the Direct Accesses (Figure
4.49). At dynamic conferences, when someone call to the direct access it’s possible
to enter automatically a existant conference or to create a new one.
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
133
Figure 4.48: VoIP - Call conference list
Figure 4.49: VoIP - Dynamic call conferences
Call Parking
Here (Figure 4.50) is possible to activate or deactivate the option of calls on
hold.
If this option is activated, it is necessary to define an extension to place the
calls on hold, as well the virtual extensions in which calls are going to be placed
(Figure 4.51). To accede to these calls later is necessary to insert in the telephone
keypad the ”#” plus the virtual extension were the call was parked.
iPortalMais - 2008
Reference Guide - Version 5.0
134
IPBrick.C
Figure 4.50: VoIP - Call Parking
Figure 4.51: VoIP - Call Parking - Modify
Scheduling
This option (Figure 4.52) allows to define the behavior of the IP PBX for all
the day. Usually this is the most important inbound service because from here,
we are able to call all the others configured services.
It is necessary to click option Insert (Figure 4.53) and configure the first
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
135
Figure 4.52: VoIP - Scheduling
parameters:
• Name: The name for the scheduler;
• Direct access: List of numbers/addresses that will call this service. We
have tree options and it’s possible to use many direct access’s;
– DID: If the IPBrick has a ISDN telephony card, the DID (Direct Inward
Dial) will be the direct PSTN number that will call this service;
– ANA: If the IPBrick has a analogic telephony card, will be the direct
PSTN number that will call this service;
– SIP: It’s the specific SIP address that will call this service.
Next, it is necessary to add rules for this scheduler. For that:
• Click in the scheduler name;
• Click Insert;
• Choose the type of action to be executed;
• Choose the period to be executed.
Fields explanation:
• Destination type: Where shall the call be routed if the rule defined next
is equalled. Options:
– Phone: To call to a internal telephone;
iPortalMais - 2008
Reference Guide - Version 5.0
136
IPBrick.C
– IVR: To go to an interactive answering sub-menu;
– Conference: To connect to a conference;
– Scheduler: To connect to a scheduler;
– Group: To ring the telephones of a group;
– Sequence: To activate an answering sequence;
– SIP address: To call a SIP telephone;
– DISA: It allows someone outside the central to connect as if he/she is
directly connected to the central;
– Call queue: To make the call enter a waiting line;
• Destination: Telephone address or specific service name were the call shall
be routed;
• Hours: Beginning and end hour, from the timetable in which the rule shall
be valid (format hh:mm at each field);
• Weekdays: Weekdays in which the rule shall be valid. If not chosed it will
use all days;
• Month days: Days of the month in which rule shall be verified. If not chosed
it will use all;
• Months: Months in which the rule shall be valid. If not chosed it will use all
months;
Figure 4.53: VoIP - Scheduling - Insert rules
NOTE: If you don’t select any hour or days of the week/month, hour or
months, the rule shall be valid respectively for all the day. A rule like this one is
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
137
called the default rule;
At Figure 4.54 we can see an example of a scheduling implementation. You
can see that the rule 4 is used from 19:01 to 08:59, because is the default time. It
will call a simple IVR with a voice message telling that nobody is at the company
to answer the phone.
Figure 4.54: VoIP - Scheduling - Rules list
DISA
DISA17 (Figure 4.55) is a service that allows that someone that is not directly
connected to IPBrick or the PBX central, to obtain an internal call sign and
execute calls as if he/she was directly connected to the internal network. The user
calls the access number to DISA and he/she should type a password followed by
the key ”#”. If the password is correct, the user shall hear the sign indicating that
he/she may dial the number. You can also enjoy this service without a password
if you want to. The fields necessary to configure a DISA are:
• Name: Name for DISA;
• Direct access: List of numbers/addresses that will call this service. We
have tree options and it’s possible to use many direct access’s;
– DID: If the IPBrick has a ISDN telephony card, the DID (Direct Inward
Dial) will be the direct PSTN number that will call this service;
– ANA: If the IPBrick has a analogic telephony card, will be the direct
PSTN number that will call this service;
17
Direct Inward System Access
iPortalMais - 2008
Reference Guide - Version 5.0
138
IPBrick.C
– SIP: It’s the specific SIP address that will call this service.
• PIN authentication: It allows the introduction of a password to enable the
dialling through DISA;
• Password: PIN password;
• Allowed caller ID’s: Callers identifiers list which may accede to this service. Insert only one by line.
Figure 4.55: VoIP - DISA - Insert
Call queues
Here (Figure 4.56) it is possible to define waiting lines. When calling to the
telephone defined in Direct Access the caller shall be placed on hold if there is
another call to be answered. An answering message may be defined which shall be
heard when the call is on hold. It is also possible to choose messages by default in
Select queue information from the line which may inform the caller about his/her
position in the line and the time interval between those messages.
The settings where we hit insert are the following ones:
• Name: Name of queue;
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
139
• Direct access: List of numbers/addresses that will call this service. We
have tree options and it’s possible to use many direct access’s;
– DID: If the IPBrick has a ISDN telephony card, the DID (Direct Inward
Dial) will be the direct PSTN number that will call this service;
– ANA: If the IPBrick has a analogic telephony card, will be the direct
PSTN number that will call this service;
– SIP: It’s the specific SIP address that will call this service.
• Queue weight: Queue’s priority.
• Maximum number of queued calls: Maximum number defined of calls on
hold. ’0’ defines an unlimited number;
• Define maximum waiting time: It is possible to define the maximum waiting time. For that it is necessary to click option Yes, select the maximum
time in seconds and the type of routing to do if the time is exceeded as well
as the final destiny;
• Phone attendance timeout: Period of time (seconds) at the end of which
the caller shall be put on hold if the call is not answered, even if there is no
one else on hold;
• Welcome message file: Select the message to be presented when someone
enters the waiting line;
• Select queue information message: Select some of these messages to inform about the position in the waiting line or the estimated waiting time.
Messages: ”You are now first in line”, ”There are”, ”calls waiting”, ”The
current estimated holdtime is”, ”minutes”, ”seconds”, ”Thank you for your
patience”, ”less than” ,”hold time” ,”All phones busy / wait for next”;
• Time interval between queue information messages: If some informative message is selected, is possible to select the time (seconds) between
messages;
• Attendance policy: How the waiting line answering telephones should answer the calls:
– Ring all: All available telephones ring until one of them answers;
– Random: One of the available telephones rings by chance;
– Round Robin: Each telephone rings at the time;
– Round Robin with memory: Each telephone rings at the time, but it
remembers which was the last one to ring;
– Least recently called phone: Will ring the telephone that rung a
long time ago;
– Phone with fewest completed calls: Will ring the telephone with
less answered calls.
iPortalMais - 2008
Reference Guide - Version 5.0
140
IPBrick.C
• Play message when call is answered: If Yes a message will be played
before the call is answered;
Figure 4.56: VoIP - Call queue definitions
When a call queue is inserted there are the following options at the top: Back,
Modify, Delete and Members. So the next step is to define what IP phones or/and
LDAP users will be associated to the call queue. Clicking Members you will get a
list of phones and users, like shown at Figure 4.57.
At Call queues - Agents, we have a list of IPBrick LDAP users. A user can
be defined as a call queue agent. To configure one agent click at one name, choose
Yes and configure:
• Login: Number used to enter dynamically a call queue;
• Waiting mode
– Music on hold: The phone will be immediately part of the call queue.
The user will listening music until a call is received;
– Callback: Only if the agent receive a call from the call queue, the
phone will ring;
• With PIN?: If Yes the user must enter a PIN after the login number;
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
141
Figure 4.57: VoIP - Call queue members
Outbound
Access Classes
It is possible to define access rules for the existing telephones. For that it is
necessary to click on the connection Insert and fulfil the following fields (Figure
4.59):
• Name: The access class name;
• Unlock code: Code to deactivate temporarily a access class;
• Prefixes: It allows to add to the authorized prefixes list the prefixes which
may be used in the telephones under the access rules. By default all the calls
are blocked except the Authorized prefixes;
• Numbers: In Politics by default it is possible to block the traffic for any
number or let it pass by default (Block/Authorize, respectively) and then, if
there are some exceptions, it is possible to indicate an exception number by
line. You can use wildcards at the exceptions;
• Domains: In the same way it is possible to authorize or block the access to
certain numbers, it is also possible with VoIP domains at Internet.
iPortalMais - 2008
Reference Guide - Version 5.0
142
IPBrick.C
Figure 4.58: VoIP - Call queue agents
To confirm and create a defined rule, click Insert. Now it is possible to add
the members under that rule, clicking the name of the rule and then Members
(Figure 4.60). To remove or add SIP phones to the access class you only have to
click the buttons or respectively.
Speed Dial
The speed dial allow the association between an internal address and a telephone external to the organization. That is, the users call an internal number (or
address) and this is associated to a telephone external to the organization. Example: An external alternative address of the telephone 44@domain.com is created for
the destiny address john.smith@another-domain.com. This way, whenever you dial
internally 44, the call shall be re-addressed to john.smith@another-domain.com.
Choosing Speed Dial and clicking Insert we have two fields (Figure 4.61):
• Phone Address: Will be the external number or address to call;
• Speed Dial: The extension for speed dial.
If the IPBrick have routes, it’s possible to insert in speed dial field legacy PBX
extensions, GSM and PSTN numbers etc.
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
143
Figure 4.59: VoIP - Access Classes - Insert
4.8.3
Monitoring
Online Phones
The VoIP clients who are actually active and ready to execute and receive calls
can be visualized here (Figure 4.62).
The information made available about each telephone are:
• Phone: Name of the telephone and the respective user;
• Request location: It indicates the IP address of the telephone;
• Port: Port where the telephone is registered.
Call Statistics
Finished Calls
Detailed statistics about all the finished calls. At the main menu we have:
General statistics relating to the filter criteria:
• Call number: Total number of calls;
• Total call time;
• Maximum call time;
iPortalMais - 2008
Reference Guide - Version 5.0
144
IPBrick.C
Figure 4.60: VoIP - Access Classes - Members
• Average call time;
• Total RTP packets: Total of RTP (voice/video) packets;
• Lost RTP packets:
• Average lag: Average packet delay;
• Maximum lag: Maximum packet delay;
• Average jitter18 ;
• Maximum jitter.
Clicking at Insert it is possible to filter the result of the list be specific fields:
• Source IP;
• Source address;
• Destination address;
• Used route: SIP routes and internal routes;
18
Is the measure of the variability over time of the latency across a network
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
145
Figure 4.61: VoIP - Speed Dial
Figure 4.62: VoIP - Online phones
• Result: ANSWERED, NO ANSWER, BUSY, FAILED;
• Time periods.
The option Export CSV will export all the list to a .csv file.
In the call list we have specific statistics relating to the filter criteria (Figure
iPortalMais - 2008
Reference Guide - Version 5.0
146
IPBrick.C
4.63):
• #: Call identification;
• Source IP: Source IP phone address;
• Source Address: Name of origin telephone/number;
• Destination Address: Number or name of destination telephone;
• Route: Route used to make the call;
• Fallback: If it was a fallback route;
• Result: Result of the call (ANSWERED, NO ANSWER, BUSY or FAILED);
• Start: Call start time;
• Ring time: Time that the destination telephone rang;
• Duration: Call duration.
Clicking at one of this fields, it will order the calls by that field.
Figure 4.63: VoIP - Statistics filter
Current calls
In this menu we have statistics about the current calls, with that fields:
• Source;
• Destination;
• Duration;
• State;
• Route.
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
147
Call manager
The Call Manager (Figure 4.64) is a Flash application that allows to visualize:
the state of each extension, if it is online and if it is doing calls, state of the lines
and SIP servers. You can also end calls through this interface when authenticated.
Figure 4.64: VoIP - Call Manager configuration
The configuration of the call manager (Figure 4.65) is made from the IPBrick
web interface in IPBrick.C ¿ Voip ¿ Call Manager, and it is necessary to click the
connection Change. By default are shown the state of all registered telephones,
ports of each RDIS and analogic plate, state of the waiting lines, conferences and
SIP servers. Some of these fields cannot be shown if we remove them in Show fields.
To define an administration password which allows to end the calls, it is necessary to change the value of the field Administration password. To allow other
LDAP users to use the call manager it’s possible to control the permissions at
Access Management option.
In the configuration page you have the link to the call manager which may be
acceded from the LAN. It might be necessary to define the alias call manager in
the DNS server of the network.
If it is not possible to visualize all the extensions, lines and servers of the call
manager, it is necessary to move the mouse to the right side of the page and the
remaining ones shall be visible. In this version of Call Manager we can do some
operations when the administrator password is inserted:
• Call transfer: Drag and drop the active phone to another;
• Call termination: Double click in a phone;
• Call generation: Drag and drop one phone to another;
iPortalMais - 2008
Reference Guide - Version 5.0
148
IPBrick.C
Figure 4.65: VoIP - Call Manager
In the screen appear all the telephones, routes, interfaces, etc., which shall be
registered in IPBrick. However, there are differences, if the telephone has a visible
IP address, it means that it is active, otherwise it will be deactivated. If the telephone is represented in red, it means that a call is in progress and its duration is
indicated.
4.8.4
Routes Management
So that IPBrick executes the routing of the calls between the several network
interfaces, it is necessary the definition of specific routes according to a telephony
numbering.
As you can see in Figure 4.66 we have this options:
• Local Routes: Represent all the local interfaces available in IPBrick by default;
• Outbound routes: Represent all the outbound routes, so it will be possible
to make calls using SIP/IAX accounts;
• SIP servers list for registering: Allow to receive calls for SIP numbers associated to SIP accounts;
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
149
Figure 4.66: VoIP - Routes Management
Local routes
Local routes (Figure 4.67) allow the configuration of an interconnection between
LAN, PSTN, PBX or INTERNET.
The possible options by default are:
• PSTN-LAN: It allows the call routing from the telephone network to the
VoIP phones of local network. So it’s a internal IPBrick route than can
redirect the received calls from the PSTN to VoIP phones;
• PBX-LAN: It allows the call routing between the telephones connected to
the PBX and the VoIP telephones of local network;
• LAN-PBX: It allows the call routing from the VoIP telephones in local network to the telephones of the PBX;
• LAN-PSTN: It allows the call routing from VoIP phones to telephone network;
• INTERNET-PBX: It allows to accept VoIP calls from the Internet and route
them to PBX phones. It’s a IPBrick internal route only for call redirection;
• INTERNET-PSTN: It allows to accept VoIP calls from the Internet and
route them to the telephone network network. It’s a IPBrick internal route
only for call redirection;
iPortalMais - 2008
Reference Guide - Version 5.0
150
IPBrick.C
• PBX-PSTN: This is a default internal route. It allows the call routing from
the PBX to telephone network. 19
• PSTN-PBX: This is a default internal route. It allows the call routing from
the telephone network to the PBX.
If there are other configured interfaces (acting like trunks), they may be added
to the list of routes, and for that it is necessary to click the connection Available
Local Routes (Figure 4.67) and then add the necessary routes.
Figure 4.67: VoIP - Local Routes
The Insert in the top menu allows to insert one of the routes mentioned. After
insertion, each type of route has a connection that allows its configuration. When
acceding to this interface it is possible to choose one of these options:
• Back
• Modify: To change the type of local route;
• Delete: Remove the local route;
19
It’s possible to call from phones connected to PBX and, if IPBrick is connected to PSTN
and to a PBX, you can also answer calls. IPBrick will work in a transparent mode, switching all
the traffic from PBX to PSTN and vice-versa.
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
151
• Insert: It allows to add the prefixes that must be added to this route. When
you indicate a prefix, all the calls whose initial digits coincide with that digit
are routed by that route. Choosing Advanced Options we have this options
(Figure 4.69):
– Prefix: The numeric prefix to use to make calls using that route;
– Include prefix in address: If Yes the prefix will be part of the
destination number, so the prefix will be maintained when the call is
routed. If No the prefix will be used only to identify the route. Example:
To enable the use of number 6 to route a call to the Portuguese PSTN
network, it is necessary to remove this prefix in order that the number
stays with the correct format (the format 2XXXXXXXX instead of
62XXXXXXXX).
– Postrouting prefix: It’s a prefix added by the IPBrick when the
number is received. Example: For the Portuguese PSTN network we
use the format 2XXXXXXXX. If we use has main route a SIP account
route it’s necessary to use prefix 2, include prefix in address and use
a postrouting prefix with 00351 (351 is the portuguese international
code);
– Caller IDs restriction: Will restrict the route only for the listed
caller ID’s;
– Fallback routes: It’s a backup route to use if the present one fails;
– Generate local ringing tone: Will generate a local ringing tone.
Can be used when it can’t ring at the destination phone;
– Priority: Define the prefix priority level.
Outbound routes
This option turns possible to configure which calls shall be routed to a external
server which shall be responsible for routing them to their destiny (Figure 4.68).
This routing is made through prefixes that may be inserted clicking the name of
the route and then the link Insert above the prefixes table. To change or remove
a route you only have to click its name and then the option Modify or Delete,
respectively.
To add a new outbound route click Insert. Choosing Advanced Options the
following parameters will be presented:
• Type: Type of signalling protocol to use: Can be SIP, SIP with TLS or IAX;
• Name: Outbound server name;
• Server Address: Server IP/name address;
• Server Port: Server port to use;
• Authentication: If it is necessary to make authentication in server, you
shall have to choose the option User/Password and fulfil the users name and
respective password;
iPortalMais - 2008
Reference Guide - Version 5.0
152
IPBrick.C
• Available to Internet: With this option selected, the route shall be available for VoIP telephones outside the LAN;
• Simetric signalling: It allows to define if signalling is sent and received
through the same door (port 5060);
• Activate ENUM search: It allows IPBrick to search through ENUM.20
• DTMF type: Type of DTMF21 to use. Options: RFC2833 (default), Inband,
Info and Auto;
• Call limit: Number of possible simultaneous calls using that route, that
can be useful for bandwidth control. With 0 we can disable it;
Figure 4.68: VoIP - Outbound route definition
If the outbound route type is IAX, the only parameters are:
• Name;
• Server Address;
• Server Port;
• Available to Internet;
• Call limit.
20
Group of protocols that aims to associate the telephonic numbering to a new register in
DNS. This way, a telephone number shall correspond to a SIP address.
21
Dual-tone multi-frequency
Reference Guide - Version 5.0
iPortalMais - 2008
4.8 VoIP
153
The prefixes inserted in this outbound routes shall be available automatically
for the SIP telephones and the telephones connected to PBX. If there are additional interfaces and you intend to use a outbound route, it is necessary to add the
route INTERFACE->INTERNET (for example PBX1->INTERNET or GSM->INTERNET),
include in that route a prefix matching the one of the route for the SIP server and
include the prefix (in option Include prefix choose Yes).
For each outbound route it’s possible to define witch codecs will be used (option Modify and theirs priority with option Order.
Figure 4.69: VoIP - Prefix definition
SIP servers list for registering
Here is possible to visualize the SIP22 address list which have already been
configured (Figure 4.70). When inserting a new one, the page generated asks for
the following data:
• Name: Server name;
• SIP server address: SIP server IP or address.
22
Session Initiation Protocol
iPortalMais - 2008
Reference Guide - Version 5.0
154
IPBrick.C
After inserting the data, it is necessary to click the button Insert to confirm
the insertion of the address. The next step is to register accounts to the local SIP
server. Pressing Insert we have this options:
• Login: SIP account login. Normally is the nomadic SIP number;
• Authentication user: Usually equal to login;
• Password: SIP account password;
• Local: Internal phone that will receive the calls comming from Internet to
that nomadic number.
Figure 4.70: VoIP - SIP server for registering
4.8.5
Music on Hold
In this section (Figure 4.71) you can see the list of songs which shall be heard
if the call is on hold. It is also possible to add more mp3 files to the list, clicking
the connection Insert and after searching the localization of the music file (clicking
the button Browse...), write a brief description of the file in the field Name. To
add the mp3 after all fields have been fulfilled, click the button Insert. You can
also remove or modify the songs from the list clicking the name of the song and
clicking Change or Delete.
Reference Guide - Version 5.0
iPortalMais - 2008
4.9 IM
155
Figure 4.71: VoIP - Music on hold
4.9
IM
IM (Instant Messaging) is a service that lets you exchange text messages in
near-real-time. IPBrick’s IM server is ejabberd, an IM server based on the Jabber
(XMPP) protocol. With this server you can communicate both using the Jabber
protocol and the MSN protocol through a MSN gateway. Access to MSN contacts
is controlled by this web interface. By default, the IM service, when enabled,
blocks access to all MSN contacts, except the ones explicitly authorized in this
web interface.
4.9.1
Enabling / disabling the IM server
Enable Instant Messaging
Modify (Figure 4.72):
• No: The ejabberd server is stopped and all access to the MSN IM network
is unblocked.
• Yes: The ejabberd server is running. The access to the MSN IM network is
blocked. The MSN client programs will be blocked, (Figure 4.73) so will the
web messenger sites, as we can see in Firewall (Figure 5.12);
When the Instant Messaging server is enabled, you’ll have the following features:
• List of authorized MSN users from IPBrick Contacts:
– Insert: Clicking the checkboxes you can choose which MSN contacts,
from IPBrick Contacts, are reachable through the Instant Messaging
server.
– Delete: Clicking the checkboxes you can choose the contacts from IPBrick Contacts that you no longer want to be reachable from accounts
logged on the server.
iPortalMais - 2008
Reference Guide - Version 5.0
156
IPBrick.C
• List of authorized MSN users:
– Modify: Add, one per line, the MSN contacts that you want to be
reachable through the Instant Messaging server. All users will be able to
reach only the authorized MSN contacts. To remove the authorization
you just need to remove them from the text box.
It is possible to use both these features simultaneously, that is, you can be
using IPBrick Contacts to allow MSN contacts, and add other contacts in the List
of authorized users.
Figure 4.72: IM - Enabling Instant Messaging Server
Reference Guide - Version 5.0
iPortalMais - 2008
4.9 IM
157
Figure 4.73: IM - Blocking MSN applications
iPortalMais - 2008
Reference Guide - Version 5.0
158
IPBrick.C
Figure 4.74: IM - Web messenger sites blocking in firewall
Reference Guide - Version 5.0
iPortalMais - 2008
Chapter 5
Advanced Configurations
Here you have advanced interfaces for some services present in the upper menus,
as well as other configurations. The chapter is divided in the following main
sections:
• IPBrick;
• Telephony;
• Network;
• Support Services;
• Disaster recovery;
• System.
5.1
5.1.1
IPBrick
Definitions
In this section will be treated some very essential IPBrick server configurations.
Domain Definitions
In Domain Definitions you configure the hostname and the server DNS domain. The Fully Qualified Domain Name is composed by the machine name and
the DNS domain. For example, if you have the hostname ipbrick and the DNS
domain company.com, the FQDN will be ipbrick.domain.com. In order to change
these definitions click on Modify.
Network Definitions
At network definitions is possible to configure the following network interfaces
parameters:
• Interface: Interface name;
iPortalMais - 2008
Reference Guide - Version 5.0
160
Advanced Configurations
• Type: Private (for eth0) or public for the others;
• Mode: For the public interfaces it’s possible to configure the interface as
dynamic, so it will act as a DHCP client;
• IP: Interface IP address with the correspondent network bit mask;
• Network: Network address;
• Broadcast: Network broadcast IP;
• MAC Address: Physical address of NIC.
The Modify will change these parameters. The Insert will add a new IP alias
for the interface. Example: eth0:1, eth0:2.
If IPBrick works as an Intranet server (IPBrick.I), it is only necessary to configure the private interface. In this case, public interface (if the server where IPBrick
is installed has got 2 network cards) may get with all the default configurations
and it shall not have a network cable connected. If IPBrick works like a Communications server (IPBrick.C) or if it accumulates the Intranet and Communications
functions (IPBrick.I + IPBrick.C), it is necessary to configure the two network
interfaces (in these two situations, the server where IPBrick was installed, shall
have two network cards).
To change the network interfaces definitions, it is necessary to click ETH0 and
ETH1.
NOTE: The private interface is the first network card detected by IPBrick in
the server where it was installed. If the server has a second network plate, this
shall be configured as a public interface. The firewall is already configured by
default with specific rules to recognize the ETH0 as a private interface and ETH1
as a public interface. If the server has more network cards (ETH2, ETH3...), they
shall be considered as private;
NOTE: The ethernet cards MAC address should be associated to all the interfaces, so when the server reboots the interfaces will be always associated to the
same NIC.
Default route
This menu allows to define the gateway of IPBrick.
If IPBrick works as an Intranet server (IPBrick.I ), the address to put in this
field is the address of the equipment which makes the access to the Internet. This
equipment may be, for example, a Communications IPBrick or a router. The gateway IP address shall have to be the address of that same IP network configured
in the private interface, the ETH0. For instance, if the private interface has the
IP address 192.168.1.1, the gateway IP address shall have to be 192.168.1.x. The
interface to choose to configure the gateway is ETH0.
Reference Guide - Version 5.0
iPortalMais - 2008
5.1 IPBrick
161
If IPBrick works as a Communications server (IPBrick.C ) or if it accumulates
the Intranet and Communications functions (IPBrick.i + IPBrick.c ), the address
to put in this field is the internal address of the equipment that accedes to the
Internet, for example, a router. In this case, the gateway IP address shall have to
be the address of that same IP network configured in the public interface, ETH1.
The interface to choose to configure the gateway is ETH1.
To change the Gateway definition is necessary to click Modify. An example
can be viewed at Figure 5.1
Figure 5.1: Advanced Configurations - Definitions
5.1.2
System Information
As you can see in Figure 5.2 , here you shall receive crucial information about
the system, from the use of the network, information of the hardware, use of
memory or archive systems.
5.1.3
Web Access
This section allows the management of accesses and licenses of IPBrick (Figure
5.4).
iPortalMais - 2008
Reference Guide - Version 5.0
162
Advanced Configurations
Figure 5.2: Advanced Configurations - System Information - 1/2
Access definitions
• Login: admin;
• Password: 123456.
The login admin and respective password refer, unique and exclusively, to the
authentication to use to accede to IPBrick through the web interface and both can
be changed. It is necessary to click Change to change them.
Note: In contrast to the Administrator user this login has no work area in
IPBrick.
Language definition
IPBrick is currently available in five languages:
• Portuguese;
• English;
• Spanish;
• French;
Reference Guide - Version 5.0
iPortalMais - 2008
5.1 IPBrick
163
Figure 5.3: Advanced Configurations - System Information - 2/2
• Dutch.
This section allows the alteration of language in IPBrick (Figure 5.5). To execute that alteration, it is only necessary to click Modify, select the intended
language and afterwards click in Apply Configurations so that the alterations
become effective.
External WEB access
To accede to the IPBrick configuration interface through the Internet (External
Web Access), is necessary to click Change and choose ”Yes” (Figure 5.4). You
should also activate the HTTPS service to the Internet. It is necessary to do this
too:
• Active the HTTPS for Internet (IPBrick.C - Firewall - Services e choose
Active in the State;
• If the IPBrick is connected to the router internal interface (without public
address), is necessary in router to do a DNAT to the port 443 for the IPBrick;
IPBrick licence
This section is about the licence process of IPBrick. When installing IPBrick,
you will have an experimental license of 30 days of use. When this license expires,
iPortalMais - 2008
Reference Guide - Version 5.0
164
Advanced Configurations
Figure 5.4: Advanced Configurations - Web Access
the server is automatically reconfigured for the base configurations. The solution
is to install a permanent license.
To install a permanent licence is necessary to click in the option Download
server identification for licence generation and send the file.dat to support@ipbrick.com
asking for licence activation. You need to speciffy this information:
• Company name;
• Some information about the IPBrick server type (Intranet, Communication
or VoIP server);
After receiving the answer (with an attached file) from support@ipbrick.com,
it is necessary to select the option Cancel Temporary Licence in the page created,
insert the file received (will be licence.dat), and the licence will stay permanent.
5.1.4
Authentication
From the moment the user is created in IPBrick, there shall be a register in
the database of the authentication server - LDAP1 . LDAP is defined as a directory
1
Lightweight Directory Access Protocol
Reference Guide - Version 5.0
iPortalMais - 2008
5.1 IPBrick
165
Figure 5.5: Advanced Configurations - Language
service where is kept the information relating the computer resources of the company and its users. Whenever an user intends to authenticate in a certain service
with his/her username and password, the IPBrick LDAP database is consulted to
validate or not the access.
Modify
IPBrick allows several authentication modes, and it is configured by default,
so that all the users can authenticate themselves in IPBrick.
• IPBrick Master: Default Mode. All the services in the sever shall use the
LDAP server;
• IPBrick Slave: LDAP server shall be a synchronized replica of the indicated IPBrick Master server, and this mode is used in a scenery with several
servers. The users may authenticate themselves in this server, once there is a
temporized synchronization of the LDAP database with the IPBrick Master,
but there is no possibility to add users. In networks with a high number
of users where there are several authentications, it is useful the use of slave
authentication servers thus avoiding a congestion in the IPBrick Master network segment. This scenery is also of a great use in networks geographically
distributed;
iPortalMais - 2008
Reference Guide - Version 5.0
166
Advanced Configurations
Figure 5.6: Advanced Configuration - Authentication
• IPBrick Client: The services authenticate remotely in the indicated LDAP
IPBrick server. In this case, there is no local database copy, and it is necessary to specify the IPBrick Master/Slave server. Normally, this way of
authentication is used in a IPBrick.c in the extent of VPN, PPTP and Proxy
services;
• Netbios Client: It is possible to IPBrick to become a part of the domain
managed by a server previous to Windows 200x to use the NetBIOS protocol.
In a network like this, the users continue to authenticate themselves normally
in the Windows machine.
• AD Domain Member (IPBrick Slave): IPBrick is a member of a domain
managed by a Windows Active Directory server. The users of the network
need, as always, to authenticate in AD;
• AD Domain Member (IPBrick Slave): The IPBrick Slave is also going to
be a member of a AD domain, acting as a secondary IPBrick server. The use
of a Slave IPBrick as a member of a AD domain may be particularly useful in
the case of secondary email servers, always implying the existence of another
IPBrick server configured as a member of the AD domain - Master IPBrick .
NOTE: After changing the IPBrick authentication mode, during the Apply
Configurations, IPBrick shall reboot automatically.
Reference Guide - Version 5.0
iPortalMais - 2008
5.1 IPBrick
167
Distributed Filesystem
The users nay be physically distributed by the Master/Slave servers. Meanwhile, the centralized information system - LDAP has the information about the
physical location of each account. A NFS (Network File System) service makes
available the accounts of the users through the network. The Automount service
combines the LDAP information with NFS and makes automatically available the
accounts of the users virtually in any other Master/Slave server. IPBrick allows
the integration with authentication servers running in Windows operating systems, namely previous Windows 200x machines (NetBIOS authentication) and
after Windows 200x machines(authentication via Active Directory).
Automount
LDAP is a directory service where the relevant information of a company is
kept: Users, computer resources, contacts, etc. The Automount service combines
the LDAP information with NFS and makes automatically available the accounts
of the users virtually in any Master/Slave server.
In the Netbios authentication, the authentication server has not as a base a
LDAP service. In this configuration, IPBrick uses its own LDAP server as an
auxiliary member for the other services. In the authentication mode member
of the AD domain, the authentication server is a LDAP implementation. All
IPBrick services are configured to use this LDAP server. However, it is necessary
to extend the structure of this LDAP server to support the requisites of IPBrick
server, namely the UNIX/Linux credentials and the Automount information.
NOTE: At www.ipbrick.com - Documentation Section, there is a document
about the integration of IPBrick as a member of an AD domain.
Slaves
If IPBrick is in a Master IPBrick authentication mode and there are other
servers which shall act in a Slave IPBrick authentication mode, it is necessary to
add the Slaves machines by IP. Only then can these machines change the authentication mode to Slave IPBrick.
Clients
If IPBrick is in the Master IPBrick authentication mode and there are other
servers which shall act in the Client IPBrick authentication mode, it is necessary
to add the Clients machines by IP. Only then can these machines change the
authentication mode to Client IPBrick..
5.1.5
Update
All available updates in the Downloads section of the IPBrick site should be
installed from here. All you have to do is click Archive, choose the update file (.deb)
and choose Insert. Next, the package shall be installed in the system (Figure 5.7).
iPortalMais - 2008
Reference Guide - Version 5.0
168
Advanced Configurations
Figure 5.7: Advanced Configurations - Update
5.2
Network
At this section we have a advanced configuration of services related to the
structure of the institution network. Here is possible to define specific rules at
firewall, to add static routes for other internal networks (or external), to define
rules and priorities in the QoS service as well the configuration of service routing
at firewall.
5.2.1
Firewall
Presentation This section deals with the IPBrick firewall management. Some
of the pre-defined rules were already mentioned in the section Firewall in the
chapter IPBrick.C (rules that can’t be changed by the user, only deactivated).
In the meantime the configuration of some other services demands some other
rules. These rules can only by managed in part by the user in the Order section.
Nevertheless, IPBrick offers his administrator an advanced interface for the firewall
management. There he can define a group of rules with high personalization
((Figure 5.8).
Top Menu Here you have links to:
• Insert new rules in advanced mode;
Reference Guide - Version 5.0
iPortalMais - 2008
5.2 Network
169
Figure 5.8: Network - Firewall
• Delete already inserted rules
• Order: Interface to order all the rules that exist in the firewall (Figure 5.12).
This option is particularly important when new rules are created. Because
the first rules the firewall does the matching will be the first to use. Then,
more specific rules should be at the top and general should be at the bottom.
You can insert three types of rules:
• DNAT Rule: Redirects the traffic that comes to a port to another port/machine
of the internal network. That rule here is only for TCP traffic (example at
Figure 5.11);
• Disable machine access: It defines the denial of access to a port of defined
network machine (example at Figure 5.10);
• General settings: Here you can add a completaly personalized rule (example at Figure 5.9). These are the affected fields:
– Rule:
INPUT: Data received by the firewall that aim the recipient
interface no matter their origin;
OUTPUT: Data sent by the firewall;
iPortalMais - 2008
Reference Guide - Version 5.0
170
Advanced Configurations
FORWARD: Redirects traffic from an interface to another;
PREROUTING: Is used to change IP packets arriving to the
machine before the routing decision;
POSTROUTING: Is used to change IP packets arriving to the
machine after the routing decision;
– Interface: You should choose which interface to apply the rule;
– Protocol: Protocol(s) to which you want to apply the rule;
– Module: Shows the list of iptables modems available for use;
– Source Ip: Source IP Address of the packet;
– Origin port: Source port of the packet;
– Destination IP: Destination IP address of the packet;
– Destination port: Destination port of the packet;
– Identifier: 16 bits field that exists in the original IP packet - it is
used to identify the type of packet to filter. Examples:
! --syn
--state INVALID
--icmp-type echo-request
– Politics:
ACCEPT: To accept a packet and let it pass the firewall rules;
DELETE: Doesn’t accept the packet and eliminates it;
MARK: Saves a mark in the packet. These marks can be used to make
decisions at the forwarding level;
LOG: Saves a log of every packet that folows the rule.
– If the PREROUTING rule is used, there are the following extra policies:
REDIRECT: Used to redirect the traffic arriving from a port to
another port;
DNAT: it allows to redirect the traffic arriving at a certain
port to another machine and port belonging to the internal
network
– If the POSTROUTING rule is used, there are the following extra policies:
MASQUERADE: It allows to ’mask’ the traffic
SNAT: It allows to redirect the traffic generated in a certain
port to another machine and port.
TCPMSS: It changes the MSS field (maximum packet size) from the
TCP header. It just can be used to TCP SYN or SYN/ACK
packets because is just used in the beginning of
conections.
The rules that are defined by default can’t be eliminated, but can be deactivated by clicking in the state of the rule and change the Deactivate option.
Reference Guide - Version 5.0
iPortalMais - 2008
5.2 Network
171
Figure 5.9: Network - Firewall - General settings rule
Body
At body there’s a list of all the rules controled by the user (Figure 5.8). A
rule can be switched between enabled and disable state. To eliminate rules is
necessary to click Delete, select the rule or rules that you want to remove and
click the button Delete. The rules defined by default cannot be deleted, however
they can be deactivated, all you have to do is click the state of the rule and change
the option to disable.
5.2.2
Route management
When there are several distributed networks separated by some routers in an
organization, if you want to give IPBrick access to all of them, you must indicate
the gateway for that network (Figure 5.13).
The following fields are present:
• Destination network: Network to access;
• Mask: Mask of the destination network;
• Interface: IPBrick interface with connectivity to the destination network;
• Gateway: Router/server IP with connectivity to the destination network.
iPortalMais - 2008
Reference Guide - Version 5.0
172
Advanced Configurations
Figure 5.10: Network - Firewall - Disable access rule
5.2.3
QOS
Presentation
The QoS service2 (Figure 5.14) in IPBrick allows the customization of traffic
priority levels, oriented to the external interface, thus assuring a certain level of
quality of the service for the final user. It is importnt to indicate immediately the
value of the band width available in the connection for the internet. From these
data we can establish priority rules among the several types of traffic in a network.
for example: instead of the internet connection being entirely occupied by the
email service, limit the band width given to that service and assure a minimum
value for the web traffic.
Body
List of the available Public Interfaces (normally ETH1) and the state of the
service for each network card. Clicking the state allows to move between active
and inactive. Clicking the network plate allows to accede the management formulary of that service (Figure 5.14).
In Generic Configurations (Figure 5.15) is possible to define which maximum band width is allowed for download and upload.
In section Structure there are three classes of defined priorities, each one of
2
Quality of Service
Reference Guide - Version 5.0
iPortalMais - 2008
5.2 Network
173
Figure 5.11: Network - Firewall - DNAT rule
them already with predefined filters. It is possible to define new filters for each
priority class, specifying the following fields:
• Types of filter: ACK type (confirmation of packets reception) or General;
• ToS3 :
– Minimizes the delay;
– Maximizes debit;
– Maximizes reliability;
– Minimizes the cost;
– Minimizes the cost;
• Protocol: Type of protocol to apply in the filter;
• Source IP;
• Source Port;
• Destination IP;;
3
Type of Service
iPortalMais - 2008
Reference Guide - Version 5.0
174
Advanced Configurations
Figure 5.12: Network - Firewall - Order
• Destination Port.
The Priority Class 1 has always maximum priority, and the traffic is defined in
Priority Class 3, the less importnt.
5.2.4
Service Routing
IPBrick allows to route the traffic relating to the several services of the network
to the different output interfaces. That is, a communication server may be routing
the SMTP traffic to a certain ISP router and the web traffic to another (example
at Figure 5.16). The definition of gateways is made through the following fields:
• Name: The name of the new access to the internet;
• IP address: Internal router IP responsible for that access - Gateway;
• Tag in the firewall: Automatically attributed.
After defining a Destination, is necessary to add specific rules in the firewall so
that the routing of desired services becomes a reality. It will be presented firewall
configuration examples for:
• Using the IPBrick VoIP service in the new internet access;
Reference Guide - Version 5.0
iPortalMais - 2008
5.2 Network
175
Figure 5.13: Network - Route management
• Using the new access to send and receive email;
• Using the new access for web traffic.
VoIP example
For instance, if the new Internet access (IPBrick interface eth2) aims VoIP
traffic (port 5060, 5090 and after the 35000 - UDP) you have to insert the following
rules in Advanced Configurations - Network - Firewall - Insert:
1. Rule to masquerade the outgoing traffic for the eth2 interface;
• Type: General configuration;
• Rule: POSTROUTING;
• Interface: eth2;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: Leave blank;
iPortalMais - 2008
Reference Guide - Version 5.0
176
Advanced Configurations
Figure 5.14: Network - QoS management
• Destination IP: Leave blank;
• Destination port: Leave blank;
• Identifier: Leave blank;
• Politics: SNAT;
• Value: eth2 IP;
2. Rules that accept incoming traffic for the IPBrick VoIP ports;
Port 5060 UDP:
• Type: General configuration;
• Rule: INPUT;
• Interface: eth2;
• Protocol: UDP;
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: Leave blank;
• Destination IP: Leave blank;
• Destination port: 5060;
Reference Guide - Version 5.0
iPortalMais - 2008
5.2 Network
177
Figure 5.15: Network - QOS - General Configurations
• Identifier: Leave blank;
• Politics: ACCEPT
Port 5060 TCP:
• Type: General configuration;
• Rule: INPUT;
• Interface: eth2;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: Leave blank;
• Destination IP: Leave blank;
• Destination port: 5060;
• Identifier: Leave blank;
• Politics: ACCEPT
Port 5090 UDP:
iPortalMais - 2008
Reference Guide - Version 5.0
178
Advanced Configurations
Figure 5.16: Network - Service Routing
• Type: General configuration;
• Rule: INPUT;
• Interface: eth2;
• Protocol: UDP;
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: Leave blank;
• Destination IP: Leave blank;
• Destination port: 5090;
• Identifier: Leave blank;
• Politics: ACCEPT
Up to 35000 UDP:
• Type: General configuration;
• Rule: INPUT;
• Interface: eth2;
• Protocol: UDP;
Reference Guide - Version 5.0
iPortalMais - 2008
5.2 Network
179
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: Leave blank;
• Destination IP: Leave blank;
• Destination port: 35000:
• Identifier: Leave blank;
• Politics: ACCEPT
3. Rules to forward outgoing VoIP traffic for eth2
Port 5060 UDP:
• Type: General configuration;
• Rule: OUTPUT;
• Interface: eth1;
• Protocol: UDP;
• Module: Leave blank;
• Source IP: eth1 IP;
• Origin port: 5060;
• Destination IP: ! eth1 IP;
• Destination port: Leave blank;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
Port 5060 TCP:
• Type: General configuration;
• Rule: OUTPUT;
• Interface: eth1;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: eth1 IP;
• Origin port: 5060;
• Destination IP: ! eth1 IP;
• Destination port: Leave blank;
• Identifier: Leave blank;
• Politics: MARK;
iPortalMais - 2008
Reference Guide - Version 5.0
180
Advanced Configurations
• Value: 1 (firewall tag);
Port 5090 UDP:
• Type: General configuration;
• Rule: OUTPUT;
• Interface: eth1;
• Protocol: UDP;
• Module: Leave blank;
• Source IP: eth1 IP;
• Origin port: 5090;
• Destination IP: ! eth1 IP;
• Destination port: Leave blank;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
Up to port 35000 UDP:
• Type: General configuration;
• Rule: OUTPUT;
• Interface: eth1;
• Protocol: UDP;
• Module: Leave blank;
• Source IP: 35000: ;
• Origin port: Leave blank;
• Destination IP: ! eth1 IP;
• Destination port: Leave blank;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
4. In IPBrick Menu: VoIP - Registered Phones - Options, modify the 2o field
for the IPBrick’s eth2 IP;
Reference Guide - Version 5.0
iPortalMais - 2008
5.2 Network
181
Mail service example
In this case, the new Internet Access (eth2) will be used for the mail service,
including incoming and sending (port 25). This rules should by inserted:
1. Rule to masquerade the outgoing traffic for the eth2 interface;
• Type: General configuration;
• Rule: POSTROUTING;
• Interface: eth2;
• Protocol: ALL;
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: Leave blank;
• Destination IP: Leave blank;
• Destination port: Leave blank;
• Identifier: Leave blank;
• Politics: SNAT;
• Value: eth2 IP;
2. Rules that accept incoming traffic for the port 25:
• Type: General configuration;
• Rule: INPUT;
• Interface: eth2;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: Leave blank;
• Destination IP: Leave blank;
• Destination port: 25;
• Identifier: Leave blank;
• Politics: ACCEPT
3. Rule to allow the replys for port 25 by the Internet mail servers:
• Type: General configuration;
• Rule: INPUT;
• Interface: eth2;
• Protocol: TCP;
iPortalMais - 2008
Reference Guide - Version 5.0
182
Advanced Configurations
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: 25;
• Destination IP: Leave blank;
• Destination port: Leave blank;
• Identifier: ! --syn;
• Politics: ACCEPT
4. Rules to forward outgoing Internet SMTP traffic for eth2
• Type: General configuration;
• Rule: OUTPUT;
• Interface: eth1;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: eth1 IP;
• Origin port: Leave blank;
• Destination IP: ! eth1 IP;
• Destination port: 25;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
5. Rules to forward outgoing SMTP traffic with origin in IPBrick for the new
interface (eth2);
• Type: General configuration;
• Rule: OUTPUT;
• Interface: eth1;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: eth2 IP;
• Origin port: 25;
• Destination IP: ! eth1 IP;
• Destination port: Leave blank;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
Reference Guide - Version 5.0
iPortalMais - 2008
5.2 Network
183
6. Rule to forward traffic with origin in LAN and destination the port 25 in
Internet (only when is used a external SMTP account)
• Type: General configuration;
• Rule: PREROUTING;
• Interface: eth0;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: LAN IP;
• Origin port: Leave blank;
• Destination IP: ! eth1 IP;
• Destination port: 25;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
Web access example
In this case, the new Internet Access (eth2) will be used for the LAN web access
that will be redirected to the new interface:
1. Rule to masquerade the outgoing traffic for the eth2 interface;
• Type: General configuration;
• Rule: POSTROUTING;
• Interface: eth2;
• Protocol: ALL;
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: Leave blank;
• Destination IP: Leave blank;
• Destination port: Leave blank;
• Identifier: Leave blank;
• Politics: SNAT;
• Value: eth2 IP;
2. Rule to allow the replys for port 80 by the Internet web servers:
• Type: General configuration;
• Rule: INPUT;
iPortalMais - 2008
Reference Guide - Version 5.0
184
Advanced Configurations
• Interface: eth2;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: 80;
• Destination IP: Leave blank;
• Destination port: Leave blank;
• Identifier: ! --syn;
• Politics: ACCEPT
3. Rule to allow the replys for port 443 by the Internet web servers:
• Type: General configuration;
• Rule: INPUT;
• Interface: eth2;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: Leave blank;
• Origin port: 443;
• Destination IP: Leave blank;
• Destination port: Leave blank;
• Identifier: ! --syn;
• Politics: ACCEPT
4. Rule to forward traffic with origin in LAN and destination the port 80 in
Internet (only when the proxy is not used!)
• Type: General configuration;
• Rule: PREROUTING;
• Interface: eth0;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: LAN ip;
• Origin port: Leave blank;
• Destination IP: ! eth1 IP;
• Destination port: 80;
• Identifier: Leave blank;
• Politics: MARK;
Reference Guide - Version 5.0
iPortalMais - 2008
5.2 Network
185
• Value: 1 (firewall tag);
5. Rule to forward traffic with origin in LAN and destination the port 443 in
Internet (only when the proxy is not used!)
• Type: General configuration;
• Rule: PREROUTING;
• Interface: eth0;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: LAN network;
• Origin port: Leave blank;
• Destination IP: ! eth1 IP;
• Destination port: 443;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
6. Rule to forward traffic with origin in a machine conected to the LAN using
VPN PPTP and destination the port 80 in Internet (only when the proxy is
not used!)
• Type: General configuration;
• Rule: PREROUTING;
• Interface: ppp+;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: LAN IP;
• Origin port: Leave blank;
• Destination IP: ! eth1 IP;
• Destination port: 80;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
7. Rule to forward traffic with origin in a machine conected to the LAN using
VPN PPTP and destination the port 443 in Internet (only when the proxy
is not used!)
• Type: General configuration;
iPortalMais - 2008
Reference Guide - Version 5.0
186
Advanced Configurations
• Rule: PREROUTING;
• Interface: ppp+;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: LAN IP;
• Origin port: Leave blank;
• Destination IP: ! eth1 IP;
• Destination port: 443;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
8. Rules to forward outgoing Internet web http traffic for eth2:
• Type: General configuration;
• Rule: OUTPUT;
• Interface: eth1;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: eth1 IP;
• Origin port: Leave blank;
• Destination IP: ! eth1 IP;
• Destination port: 80;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
9. Rules to forward outgoing Internet web https traffic for eth2:
• Type: General configuration;
• Rule: OUTPUT;
• Interface: eth1;
• Protocol: TCP;
• Module: Leave blank;
• Source IP: eth1 IP;
• Origin port: Leave blank;
• Destination IP: ! eth1 IP;
Reference Guide - Version 5.0
iPortalMais - 2008
5.3 Support services
187
• Destination port: 443;
• Identifier: Leave blank;
• Politics: MARK;
• Value: 1 (firewall tag);
NOTE: To route other services for the new internet access (local and remote
port), the idea is the same.
5.3
5.3.1
Support services
LDAP
Figure 5.17: Support Services - LDAP
In this section is presented a list of the machines registered in the LDAP service
of IPBrick. To insert a new machine in the LDAP domain of IPBrick is necessary
to click Insert. It is also possible to Modify or Delete LDAP registers.
The insertion of machines in LDAP from here is useful, when there are IP
networks different from the internal interface of IPBrick, since there is no need to
indicate the IP.
iPortalMais - 2008
Reference Guide - Version 5.0
188
5.3.2
Advanced Configurations
DNS
DNS4 is a name resolution service in IP addresses and vice-versa, and it is implemented in IPBrick by the software Bind using door 53 UDP/TCP. The majority
of queries consists of a simple UDP request by the client, followed by a UDP answer of the server. There are two situations where the TCP is used: when the data
to be sent by the user exceed 512 bytes or at the transference of zones. Some operating systems (HP-UX, for ex:), even adopt DNS implementations always using
TCP, thus increasing reliability. The service acts like a database with information
about the connections of a IP network, and that information is organized into
domains. The used notation represents FQDN5 :
servername.company.region
Being the ”servername.company.region” the FQDN, the ”company.region” designated as the domain, ”company” the sub-domain and ”region” the top domain
(Top Level Domain), which is administrated by an entity denominated ICANN6 .
A DNS server generates a database about a certain part of the domain, what is
normally designated by zone, and there are two types of servers:
• master: It obtains the data from a zone which it manages from its own
database;
• slave: It obtains the data from the primary master, existing one or more
in a network. Whenever there are changes in the configuration of the areas
served by the master, this server is always notified, proceeding to the update
of database.
The DNS server allows the resolution of names in a reverse mode, that is, answer with the name - FQDN from a certain IP address. This device allows the
confirmation of the authenticity of an IP address, important aspect in the email
service.
Presentation This is the main section of DNS configuration. Here you can
manage the domains served by the machine and change the machines, alias (CNAME)
and the MX7 registrations.
Top Menu Here you have a link to Insert a new domain (Figure 5.18)
Body Here you have a list of several forward and reverse name resolution zones
registered in IPBrick. You can access the interface management of these areas by
clicking on one of them. (Figure 5.19 and Figure 5.20)
Reference Guide - Version 5.0
iPortalMais - 2008
5.3 Support services
189
Figure 5.18: Support Services - DNS - Name resolution zones
Domains
Insert Zones
Top Menu Here you have a link to get Back to the previous list and cancel the
current process of introducing a new zone.
Body Here you see a register form for forward and/or reverse name resolution
zones. You find the following fields:
1. Domain name of the new registration; e.g. empresa.pt; porto.empresa.pt;
acme.inc;
2. Network the associated IP network for which you are going to create registrations of reverse name resolution PTR8 ;
3. Zone type field that allows you to create a master or secondary zone. A
secondary zone is a copy of another DNS server master zone;
4
Domain Name System
Fully Qualified Domain Name
6
Internet Corporation For Assigned Names and Numbers
7
Mail Exchange record - used to indicate the e-mail servers of a domain
8
Pointer
5
iPortalMais - 2008
Reference Guide - Version 5.0
190
Advanced Configurations
4. Server name of the machine that will serve9 this domain (e.g. ipbrick.domain.com)
(this field is only applied on master zones);
5. Email e-mail of the responsible for this domain. This e-mail is registered in
the DNS under the name of the responsible technician for this domain (this
field is only applied on master zones);
6. Refresh time he time of a secondary zone to see if there are any changes in
the master zone (this field is only applied on master zones);
7. Transfer retry time the time a secondary zone has to wait to retry the
connection to the master zone, that is, if the last refresh was unsuccessfully
(this field is only applied on master zones);
8. Expiry time the time a secondary zone has to consider the dates of a zone
as valid since the last successful refresh (this field is only applied on master
zones);
9. Default time-to-live the time in which the other DNS servers have to
consider the dates of this zone as valid (this field is only applied on master
zones);
10. Master servers zone master server IP (this field is only applied on secondary zones)
11. Insert Button
Domains Management
Presentation In this section you control all DNS records of a selected zone.
Top Menu Here you have a link to get Back to the zones list and see dates of a
selected domain. Here you can change or delete a domain registration.
Body Here you have a list of several DNS sections
1. Machines: Machines addresses in the current domain (name associated to
an IP - machine). e.g.:
www
->
192.168.2.1
2. Aliases10 : Alias registration for domain machines (this option is only available for a forward name resolution zone) e.g.:
www2
9
10
->
www
SOA - Start of Authority
Alternative names
Reference Guide - Version 5.0
iPortalMais - 2008
5.3 Support services
191
3. Name Servers registration of FQDN addresses of machines that serve this
domain (DNS). e.g.:
domain.com
->
www.domain.com
4. Mail Servers e-mail server registration for this domain. You can have several registrations each with different internal positive values. The values indicate which registration to use first. The registration with the lowest value is
always the first one to be used. The value to be introduced here must always
be the e-mail server FQDN, no matter if it is a server of the domain itself, like
.domain.com., or an internet server, like mail.saturno.com.. This option
is only available for a forward name resolution zone. For example:
20 mail.saturno.com
10 ipbrick.domain.com
5. VoIP Servers registration of VoIP servers for this domain. The value to
be introduced here is the FQDN of the VoIP server, like for example voip.
domain.com. This option is only available for a forward name resolution
zone. For example:
voip.domain.com
6. Instant Message Server: Prefix of the address for the instant message
service.
Forwarders
If a DNS server receives a request for a domain which he neither serves nor has
in cache, then the server has to forward this request to other DNS servers in the
Internet. The forwarders should be the nearest ones, normally the DNS servers
of ISP. If the forwarders field is empty the DNS still working because the server
use the internet gateway to do the DNS search. If in the same network exists a
IPBrick.I and a IPBrick.C, the IPBrick.I must have the IPBrick.C eth0 address in
the forwarder field. Here you have the most appropriate interface to register the
nearest DNS servers. (Figure 5.21).
Name Resolution
No matter if the DNS service is being executed or not in this server you can
configure the server to handle its DNS requests in another server. You can apply
this configuration to all server services (with the obvious exception of the DNS
server which uses its forwarders for requests he does not know). In order to make
the server use its own DNS you have to configure the IP address of the localhost11 ,
127.0.0.1 - by the way, its the default configuration. (Figure 5.22).
11
local server
iPortalMais - 2008
Reference Guide - Version 5.0
192
Advanced Configurations
Figure 5.19: Support Services - DNS - Zone Management 1/2
5.3.3
DHCP
The DHCP12 service may be defined as a protocol of dynamic attribution of
parameters for configuration of network and workstations (door 67 and 68 UDP),
an evolution of the BOOTP protocol. Basically, a DHCP client sends a broadcast
packet to a network asking an IP address, and it obtains an answer if there is a
DHCP server active in the network. The server not only attributes it an IP but
also: Network mask, route by default, DNS server and WINS server.
DHCP allows two ways of attributing the IP addresses:
• Address manual or reserve: there an association between the MAC address
of a client machine and the IP address to supply, and that machine stays
with that same IP address;
• Dynamic: the client obtains the address from a range of address previously
defined by the IPBrick administrator, for a defined period of time;
NOTE: There is a mechanism that allows to have the DHCP server in a IP
network distinct from the clients, this mechanism is known by DHCP relay. The
DHCP relay is assured by an agent installed in the post(s) present in the remote
12
Dynamic Host Configuration Protocol
Reference Guide - Version 5.0
iPortalMais - 2008
5.3 Support services
193
Figure 5.20: Support Services - DNS - Zone Management 2/2
network(s), this agent receives the DHCP clients requests and routes them to the
configured DHCP server.
Subnets
This menu permit the definition of subnets to be served and the parameters of
the network configurations to attribute to the workstations. (Figure 5.23)
At top menu you have a link to Insert new subnets, configure Redundancy
parameters and define General Options by default. (Figure 5.24)
At body you have a list of the inserted subnets. Each line is a link that opens
a configuration form with options for each subnet. (Figure 5.25)
It allows the insertion of the subnet parameters, which shall be attributed to
the clients:
• Network Address: It allows to indicate the address of the network and the
respective mask;
• Dynamic addresses range: Which range of addresses is reserved to attribute the clients;
iPortalMais - 2008
Reference Guide - Version 5.0
194
Advanced Configurations
Figure 5.21: Support Services - DNS - Forwarders
• Clients mask: Mask of the network to attribute the clients;
• Broadcast address: Address of broadcast to attribute the clients;
• Default lease time: Default lease time during which the address can be
lent;
• Max lease time: Max lease time of an IP address for the machines. This
value surpassed, the IP address is renewed;
• Option Router: Address of the router which will serve as the default route
(by default 192.168.69.199);
• DNS Servers: List (one per line) of the DNS servers to be used by the clients
(by default ipbrick.domain.com);
• NetBios servers: List (one per line) of the NetBios servers to be used by
the clients (by default ipbrick.domain.com);
• DNS domain: Name of the domain indicated to the clients (by default domain.com).
Reference Guide - Version 5.0
iPortalMais - 2008
5.3 Support services
195
Figure 5.22: Support Services - DNS - Name resolution
It allows the insertion of general DHCP parameters, which shall be attributed
by default to the clients:
• Base domain: Domain where the DHCP is operating;
• DNS servers: DNS servers to be used by the DHCP server;
• NetBios servers: NetBios servers to be used by the DHCP server;
• Clients mask: Mask to be used by the clients of the DHCP service;
• Default lease time: Default lease time during which the ’lease’ of the address
is valid for the clients;
• Max lease time: Max lease time of an IP address for the machines. When
this value is surpassed, the IP address is renewed.
If you want the DNS Dynamic Update, it is necessary to choose ”Yes” in the
respective box. This feature is used to update dynamically a machine IP in the
DNS record if that machine is not registered with MAC address
iPortalMais - 2008
Reference Guide - Version 5.0
196
Advanced Configurations
Figure 5.23: Support Services - DHCP - Subnets
Presentation It is possible for a IP network to configure two DHCP servers, one
as main (primary) server and the other as secondary. During the normal working
only the primary server answers the requests, while the secondary one synchronizes
its BD with the primary, if the primary fails the secondary shall assume its service.
Communication between the servers is made from the network ports which may
be customized. One of the ports shall be attending the connections from the
secondary server and the other one shall be attending the connections from the
main server. (Figure 5.26)
Top Menu Here you have a link to get Back and Insert a new connection.
Body
Body
The following fields are presented in the insertion of redundancy and fault:
• Name: Name of the redundant connection;
• Configuration: here you can see if the server is the primary or secondary
DHCP;
• Local IP: Servers internal IP address;
Reference Guide - Version 5.0
iPortalMais - 2008
5.3 Support services
197
Figure 5.24: Support Services - DHCP - General Options
• Local gate: Local gate where the service is running;
• Remote IP: Remote IP address from the server of the other extreme;
• Remote gate: Remote gate where the service in the other extreme is running;
• Max answering time: Max time that the DHCP server can wait for a message from the other peer. When that is out, the server assumes that the
other has failed and assumes itself as the network DHCP server;
• Max Unpacked Updates: Max Unpacked Updates (BNDUPD) non-confirmed
that the server can receive from other peer.
Machines
Presentation Here you see a list of the registered machines with their MAC addresses in the DHCP service. You can register the machines in Machines Management
(see section 3.2, page 18) or directly in this section (Figure 5.27).
iPortalMais - 2008
Reference Guide - Version 5.0
198
Advanced Configurations
Figure 5.25: Support Services - DHCP - Subnets Definition
Figure 5.26: Support Services - DHCP - Redundancy
5.3.4
ENUM
The ENUM13 service allows the mapping of telephone numbers (Rule E.164)
in names associated to IP addresses, using an architecture based on the DNS ser13
Telephone Number Mapping
Reference Guide - Version 5.0
iPortalMais - 2008
5.3 Support services
199
Figure 5.27: Support Services - DHCP - Machines
vice. Those names may be from the protocol SIP, H.323, Email etc. In order to
consult the DNS, ENUM inverts the telephone numbers, giving them the prefix
e164.arpa. which is the root of the tree. This tree é delegated to all countries of
the world taking into account their codes E.164. this way, the Portuguese delegation shall be the inverted 351 - 1.5.3.e164.arpa.
The ENUM zones may be defined in IPBrick where the research shall be made.
For that you have to click the connection Insert and insert the ENUM zone domain.
In Order is possible to define which are the priority zones where the research of
numbers shall be made. In Figure 5.28 a list of the ENUM zones may be visualized.
Once the list of the ENUM zones is defined, where to search numbers, the
ENUM may be used in VoIP routes. Next, an example is given:
1. In IPBrick.C - VoIP - Routes Management, there is a Output Route for
Sip Servers - VoIPBuster.
There it is necessary to activate the option Activate ENUM Search in the
Route Definitions;
2. A certain user of the network calls through the SIP/PBX to number +351253593112;
3. Automatically, a research is made in the ENUM zones specified in the present
menu for 2.1.1.3.9.5.3.5.2.1.5.3.e164.arpa, in order to obtain the correspondence of that number in a certain IP address/name;
iPortalMais - 2008
Reference Guide - Version 5.0
200
Advanced Configurations
4. Supposing that the research results in the SIP address joaod@domainx.com,
a SIP call is made to the address joaod@domainx.com;
Figure 5.28: Support Services - ENUM
5.4
5.4.1
Disaster recovery
Configurations
All configurations that are done in IPBrick through the web interface are saved
in a Postgres database. This way any changes done will only be effective in the
system after Apply Configurations.
IPBrick allows the time tracking of all configurations because when you modify
something in the web interface and Apply Configurations, a new configuration
is locally saved. It is possible to store these configuration files in an USB pen
and additionally send them to a configurable email address. In the configuration
filename we have the date and the exact hour when a configuration was created.
In short, this configuration management allows a fast disaster recovery, in case of
hardware problems.
There is a configuration called default which is the IPBrick’s base configuration immediately after install.
Reference Guide - Version 5.0
iPortalMais - 2008
5.4 Disaster recovery
201
Clicking in Definitions there are the following fields that can be modified in
the connection Modify:
• Email address: Email address (internal or external) were the configurations
are delivered (by default backup.ipbrick@iportalmais.pt);
• Message Subject: By default backup.ipbrick@iportalmais.pt;
• Message body: By default is empty.
! Attention: After the IPBrick installation you must always insert a USB
pen connected to server;
Replace
In this section you see a list of all saved copies on the USB pen. In order to
replace a setting you just have to click over it (Figure 5.29).
Figure 5.29: Disaster Recovery - Replace configuration
⇒ Note: All services will be reconfigured when replacing a copy of the settings. After the configuration of all services IPBrick restarts automatically.
iPortalMais - 2008
Reference Guide - Version 5.0
202
Advanced Configurations
Figure 5.30: Disaster Recovery - Download configuration
Download
This section allows you to download the copies of the configurations done to a
local computer (Figure 5.30).
With this useful option you can save IPBrick settings on another place.
Upload
In this section it is possible to upload a previously downloaded configuration
file to the server (Figure 5.31).
! Attention: It is not possible to use setting copies in different IPBrick
versions. The configuration files are not compatible with the different IPBrick
versions.
5.4.2
Applications
This is an useful disaster recovering feature. When upgrading IPBrick from
version A to version B, if an old installation is detected, the following applications
will be backed up:
• PostgreSQL: All the Postgres databases will be dumped, including the sites
databases;
• MySQL: All the Mysql databases will be dumped, including the sites databases,
webmail contacts;
• Mail: The emails that were in the queue will be saved;
• Kaspersky: All the Kaspersky applications statistics will be saved;
• VoIP: It will save all the VoIP statistics;
• IM: The Instant Messaging data and configuration will be saved.
Reference Guide - Version 5.0
iPortalMais - 2008
5.4 Disaster recovery
203
Figure 5.31: Disaster Recovery - Upload configuration
So, all these application files are packed and saved in a folder.
Choosing the option Applications - Restore the list of available application
data backups will be shown (Figure 5.32). To restore the desired application data
backup, click on the file and then on Restore. At this moment the backup will be
restored for the new IPBrick version (Figure 5.33).
Figure 5.32: Disaster Recovery - Applications - Data backups list
iPortalMais - 2008
Reference Guide - Version 5.0
204
Advanced Configurations
Figure 5.33: Disaster Recovery - Applications - Data restore confirmation
5.5
System
Inside the menu System, we can find the options indicated in the following
points.
5.5.1
Services
In Services (Figure 5.34) you find a list of several services available in IPBrick.
The State column shows you if the service is enable or disable. It is possible to
restart any service without having to restart IPBrick.
In order to restart any service you have to:
• Change the State from Enable to Disable;
• Apply Configurations;
• Change the State from Disable to Enable;
• Apply Configurations.
The Start column defines the way of how each service has to start with the
server (whether after a reboot or after a period while the server was disconnected).
If you see Automatic in the Start column of a service then the service will start
automatically with the server. On the other way, if you see Manual on the column
then the service will not start with the server. Nevertheless it can be started
manually in this menu by changing its State from Disable to Enable.
⇒ Note: Any changes in the Start column of a service will not have immediate effects on the service start. The changed start will only be valid for the
next server start. On the other way, a change in the State column has immediate
effects. That is, by changing the service state from Enable to Disable IPBrick
stops this service (after clicking on Apply Configurations).
Reference Guide - Version 5.0
iPortalMais - 2008
5.5 System
205
Figure 5.34: System - Services
5.5.2
Task Manager
The Task Manager shows you a list of all executed processes in IPBrick. It
gives you information about:
• Identifier: It’s the PID14 ;
• Owner: The system user name that started the process;
• Start: The date of the process start;
• Memory: The memory percentage used by the process;
• Processor: The processor percentage used by the process;
• Process: The process that is running.
In this section it is possible to stop a certain process. Therefore you only have
to click over the option Kill Task (Figure 5.35).
! Attention: Speaking in generally, the running processes should not be
stopped this way. To stop a process in this interface may cause instability in IPBrick. In order to stop services use the Services menu.
14
Process Identifier
iPortalMais - 2008
Reference Guide - Version 5.0
206
Advanced Configurations
Figure 5.35: System - Task Manager
5.5.3
Date and Hour
In this menu (Figure 5.36) you can see and change the server date/hour and
the time zone. When clicking Modify this fields are presented:
• Synchronization: If Manual the date/hour will be managed by the own server.
If Automatic IPBrick will use a NTP server to remotely synchronize the
data/hour. The default one is pool.ntp.org15 ;
• Date: Only active in manual mode;
• Hour: Only active in manual mode;
• Time Zone: Choose the correct time zone.
5.5.4
System users
This menu (Figure 5.37) lists the System users (name and its login). If you
select one of them, it is possible to change its password as long as you know the
existing password. This is the list:
• root: Linux console superuser;
15
Big virtual cluster of Network Time Protocol timeservers
Reference Guide - Version 5.0
iPortalMais - 2008
5.5 System
207
Figure 5.36: System - Date and Hour
• operator: Linux console operator;
• Received Mail: User for the received mail copy functionality. The idea is
to map a IMAP account from a email client;
• Sent Mail: User for the sent mail copy functionality. The idea is to map a
IMAP account from a email client;
• kaspersky: User to receive the Kaspersky Applications notifications for example. The idea is to map a IMAP account from a email client;
• spam: User to receive the mails from Kaspersky Anti-Spam. The idea is to
map a IMAP account from a email client;
• VoIPCDR: User for FTP access, to get the asterisk full call statistics.
The password for all of them except root is L1opardo.
⇒ Note: Do not mistake System Users for LDAP Users. A System User is
not registered in LDAP.
5.5.5
Monitoring
This section stands only for monitoring features. Main options:
iPortalMais - 2008
Reference Guide - Version 5.0
208
Advanced Configurations
Figure 5.37: System - System users
• Logs: IPBrick and system logs management;
• Accesses: Monitoring for some TCP protocols;
• Traffic: Can manage all the active TCP connections;
• Alerts: Options for disk partitions alerts;
Logs
The logs are an important tool for troubleshooting. In this menu we can:
• IPBrick Logs: Logs generated by the IPBrick. Important to detect any
problem at the web interface layer. The most recent information is available
in Current Log. In case there are other log registrations then each of them
provides information generated by IPBrick till their indicated date ;
• System Logs: Can manage some system logs (syslog, daemon.log,auth.log,
mysql.log, mail.*);
– State: The default is disable;
– Server: If enable we can say if logs will be written locally or in a remote
machine that supports syslog daemon;
Reference Guide - Version 5.0
iPortalMais - 2008
5.5 System
209
– Authorize logs from remote servers: If enable, authorize servers to
write system logs in IPBrick;
Figure 5.38: System - Monitoring - System Logs
Accesses
At Management clicking in service name we can enable the accesses monitoring
for SSH, FTP, VPN PPTP and SSL. By default the state is disabled.
The Entries option permit the visualization of all accesses. It’s possible to
filter by:
• IP;
• User;
• Notes:
– Connected;
– Disconnected;
– Wrong password;
– Illegal user;
– Locked;
– Timeout;
– Timeout/Locked;
– Log in attempt with root user;
– Disconnected/Timeout.
iPortalMais - 2008
Reference Guide - Version 5.0
210
Advanced Configurations
• Date;
Options available:
• Clean filters: Will clean all the chosen filters;
• Export PDF: Exports all the information to a .pdf;
Traffic
Here all the active TCP connections are listed by this fields:
• Source IP: Remote machine that have a connection to the server;
• Source port: Port used by the source machine;
• Destination IP: Server IP;
• Destination port: Port where the source machine is connected;
• State: The default is enabled.
In Action, choose the option Block connection to finish a specific connection.
After blocking one connection it’s possible to unblock it hiting the option Unblock
connection
Alerts
Define here if the full partition alerts definition will be active. So if the
partition reaches 85%, a email alert will be delivered to the email present at
Destination address. Changing the source address notifier is possible too.
5.5.6
SSH
The SSH menu implements a secure connection to the IPBrick shell, showned
in Figure 5.39.
The SSH (Secure Shell) is similar to the known Telnet application but more
secure because of the protocol SSL used.
Note: This function needs the installation of Java Virtual Machine. The
software is available in www.java.com. After the connection it is necessary to
make an authentication. Therefore you need the introduce the following data:
• Username: operator;
• Password: L1opardo.
After that first authentication, you can enter su to login as superuser;
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
211
Figure 5.39: System - SSH
5.5.7
Reboot
This option allows you to reboot IPBrick (Figure5.40). After confirming the
reboot option the web connection with the server is automatically stopped. When
IPBrick starts again it is possible to establish a new https connection with the
server.
5.5.8
Shutdown
This option is to clearly shutdown IPBrick (Figure 5.41), assuring that all the
services are correctly ended. You should use this option, whenever it is necessary
to shutdown IPBrick. Do not shutdown the server directly in power supply.
5.6
Telephony
To make possible IPBrick interaction with telephone systems, you need to install specific hardware. This hardware includes PCI cards that can be analogic,
RDIS BRI or RDIS PRI. Analogic cards provide the connection to telephone networks working in analogic mode. If telephone networks are working in digital mode
(RDIS), cards may be BRI or PRI. A BRI (Basic Rate Interface) access has three
channels: Two 64kbit/s (B) for data/voice and one 16 kbits/s (D) for control.
iPortalMais - 2008
Reference Guide - Version 5.0
212
Advanced Configurations
Figure 5.40: System - Reboot
The PRI (Primary Rate Interface) access corresponds to 30 B channels plus one
D channel in Europe - can also be designated as E1 circuit.
5.6.1
Cards
After physical configuration and installation in the machine you have to configure IPBrick. To make this step you have to know how the card was physically
configured, i.e., each port configuration. After the physical installation of the
hardware, you can configure cards in the IPBrick web interface in the menu:
Advanced Configurations - Telephony - Cards
To insert click on Insert, and then indicate (as shown on Figure 5.42):
• Card type: Can be analogic, ISDN BRI or ISDN PRI;
• Port count: Number of ports;
• Port configuration: Each port can be configured to connect to the presetted interfaces: PBX or PSTN. For analogic and ISDN PRI the settings
are automatically configured like this:
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
213
Figure 5.41: System - Shutdown
Analogic: Connecting
Connecting
ISDN PRI: Connecting
Connecting
to
to
to
to
a PBX, so the card port will act as fxs
PSTN, so the card port will act as fxo
a PBX, so the card port will act as NET
PSTN, so the card port will act as CPE
For ISDN BRI the administrator must fill the settings:
– NT PtP (Point to Point);
– NT PtMP (Point to Multi-Point);
– TE PtP (Point to Point);
– TE PtMP (Point to Multi-Point).
For each card inserted there are three options: Back, Modify and Delete (Figure 5.43).
If the port is connected to the landline (PSTN) you need to configure the
setting as TE. If the port is connected to the PBX gateway you have to configure
the PBX port and configure the setting as NT. A ISDN FAX usually behaves like a
PBX requiring the port configuration as FAX (to show this option requires a FAX
interface configuration) and configure the setting as NT. If there is a GSM interface
configured in one of the ports you have to choose it on the list and configure the
setting as TE. To configure a ISDN PRI you have to indicate if the line uses R2
iPortalMais - 2008
Reference Guide - Version 5.0
214
Advanced Configurations
Figure 5.42: Telephony - Cards - Insert
protocol (protocol used for example in Brazil) and if the CRC4 is active on the
line. The PtP or PtMP depends of the telephone operator line type.
After the configuration, we can see a list with the configured cards, as visible
in Figure 5.44.
5.6.2
Registered Phones
This option is valid if there is no need to attribute a specific IP address to the
telephone. You can add a telephone by fulfilling the field relating the name and
the access password to the telephone. This supposing the DNS is working correctly.
In this menu you can see a list of the registered SIP telephones. To register a
telephone:
• Click Insert;
• Phone: Insert the name of the telephone to register;
• Password: Insert the access password to the telephone;
• Retype Password: Reinsert password;
• Caller ID: If you want to mask the caller ID insert one.
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
215
Figure 5.43: Telephony - Card definitions
Figure 5.44: Telephony - Cards list
• Click Insert.
Example at Figure 5.45.
iPortalMais - 2008
Reference Guide - Version 5.0
216
Advanced Configurations
Figure 5.45: Telephony - Simple phone register
5.6.3
Configurations
In this menu it’s possible to adjust several configurations for VoIP and PBX/PSTN
integration. This are the options:
• General options;
• Analog and ISDN PRI options;
• ISDN BRI options;
• List of enable codecs;
• IP PBX remote managers;
• VoIP domain alias.
General options
The following fields in Options (Figure 5.46):
• Router with full DNAT?: If IPBrick is connected to a router responsible
for the access to the exterior (in terms of VoIP) that allows the ’passage’ of
all traffic, it is necessary to select Yes and indicate the external address of
that same router in Router public IP address;
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
217
Figure 5.46: Telephony - Configurations
• IP address of the IPBrick public interface used by the VoIP service:
IP address of the public interface of IPBrick responsible for the VoIP service;
• Intranet VoIP Server only?: It allows to route the network traffic only
in a interface and not in two interfaces, as usual;
• Remove default national prefix (0): It removes national prefix normally used;
• Get call source address from IPBrick LDAP: If activated, it goes to the
database LDAP of IPBrick defined in IPBrick IP address and in IPBrick DNS
domain and, if it finds the calling number in the database, it will replace it
by the name of the entity associated to that number.
• Immediate answer on calls originated in a PBX: It is advisable to have
this option connected if you are using connections to SIP servers (ex: VoIPBuster, NetCall), in order to avoid timeouts in the PBX central. If, for
example, you intend to define rates for the calls from the PBX, this option
shall have to be deactivated to avoid that the user starts paying as soon as
he dials the number.
• Attendance Timeout: Time (seconds) during which the call is sent to the
destiny phone, before being sent or routed to another phone;
iPortalMais - 2008
Reference Guide - Version 5.0
218
Advanced Configurations
• Call Timeout: Time (seconds) during which the connection is trying to be
established. If it expires, the attempt will be ended;
• Timeout to hangup calls without sound;
• Timeout to hangup calls on hold without sound;
• Enable SIP video support: Enables the support for SIP video;
• Attended transfer: If yes you can define a key activation sequence to do
a attended transfer. So you can stop using this feature from the SIP phone
and use it from the VoIP server;
• Blind transfer: If yes you can define a key activation sequence to do a
blind transfer. So you can stop using this feature from the SIP phone and
use it from the VoIP server;
• Voicemail: Enables general voicemail for VoIP;
• Call’s prioritization: If enabled it will be possible to define priority
levels for each route prefix defined in Routes Management. The level is from
1 (highest) to 10 (lowest). Example: In a LAN-PSTN route all the BRI lines
are full. If a emergency call prefix (911) have maximum priority defined,
when someone dial 911 some current call can be disconnected;
• Store calls details records in csv file: All the call history in the
default asterisk format will be saved to a file called Master.csv. This file
can be downloaded acceding by ftp with username voipcdr and password
L1opardo;
• IP of server-signalling different from the media server: If a remote signalling service is running in one server, and the remote media server
is running in a different one, this option must be activated;
Analog and ISDN PRI options
Parameters only for the analog/ISDN PRI cards, that will be adjusted at the
driver configuration files used for that cards - zaptel ((Figure 5.47):
• Channel tone zone: Country tone zone. The frequences may be different
from country to country;
• Echo cancel;
• Type of Number (ISDN TON): Low level signalling options
– Callee (Calling Number): Unknown is the default, other options are
local, private, national and international;
– Caller (Caller Number): Unknown is the default, other options are local,
private, national and international;
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
219
• R2 signalling options: If the R2 signalling protocol is used (old ISDN protocol) you can define here the R2 parameters:
– DNIS: Dialed Number Identification Service value;
– ANI: Automatic Number Identification value;
– Zone/Country;
Figure 5.47: Telephony - Analog and ISDN PRI options
ISDN BRI options
Parameters only for the ISDN BRI cards, that will be adjusted at the driver
configuration files used for that cards - misdn (Figure 5.48):
• Echo cancel: The default is High. Other options: Disabled, minimum, low
and maximum (requires more CPU processing);
• DTMF detection threshold: Permit to change the DTMF sensibility from 50
to 400 (less sensibility);
• Immediate digit capture: The immediate capture of digits changes the way
how the numbers sent from a PBX central are read in IPBrick. When this
iPortalMais - 2008
Reference Guide - Version 5.0
220
Advanced Configurations
option is deactivated, the routine capture of digits is changed to solve problems in the reading of numbers in some central stations, for example, when
the dialled number is wrongly identified in IPBrick (repeated digits or lack
of digits). Attention: This option should be placed No by default;
• PSTN digit reception timeout: Timeout in seconds;
• Jitter Buffer: Permit the change of Jitter Buffer16 ;
• Digit timeout: Time (seconds) from the dialling of the last number from
which IPBrick considers the dialling as ended;
• Response timeout: Time (seconds) counted from the moment the receiver is
hung up and at its end IPBrick shall cancel the channel;
• Type of Number (ISDN TON): Low level signalling options
– Outgoing number (onumplan): Unknown is the default, other options
are national, international and subscriber;
– Caller id (dnumplan): Unknown is the default, other options are national, international and subscriber;
– CPN (cpnnumplan): Unknown is the default, other options are national,
international and subscriber.
List of enable codecs
In this table are listed the codecs used in IPBrick and the preference order by
which they are chosen in communications. To add or remove codecs to the list, you
just have to follow the option Modify, select the codec and press the button add
() or remove () (Figure 5.49). In the same way, to change the order by which
the codecs are used, you should select the codec and clicking on the arrows on the
right of the list, making it going up or down in the list according the necessary
priority.
It is possible to select among the following codecs, knowing that the bandwidth
used for each one in a call is approximately:
• GSM: 13 KBytes;
• iLBC: 15 KBytes;
• Speex: Configurable 4-48 KBytes;
• G.726: 32 KBytes;
• LPC10: 2.5 KBytes (not recommended);
• G.711 ulaw: 64 KBytes;
16
Shared data area where voice packets can be collected, stored, and sent to the VoIP server
in evenly spaced intervals
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
221
Figure 5.48: Telephony - ISDN BRI options
• G.711 alaw: 64 KBytes, used in Europe;
• G.729: 8 KBytes. You may have to buy a license to make calls with this codec
at Digium website. If this codec is enabled a link called Licence Activation
will appear, so with a valid key a G729 licence will be generated. See Figure
5.50 and Figure 5.51.
Of course the bigger the required bandwidth, the smaller the number of possible
simultaneous calls. For each of the selected codec we can include an average of
more 15 KBytes of overhead.
IP PBX remote managers
This option allow other programs to connect to the asterisk, normally programs
running at LAN servers. Some examples: Mail plugin for calls generation, external
asterisk monitoring tools, call center for calls generation etc.
By default the IP PBX remote management is disabled. To enable click Modify
and next Insert IP PBX remote manager (Figure 5.52)
Configuration options:
• Login: Login to use;
iPortalMais - 2008
Reference Guide - Version 5.0
222
Advanced Configurations
Figure 5.49: Telephony - Configurations - Codecs
Figure 5.50: Telephony - Configurations - Codecs with g729
• Password;
• Network: Network range or specific IP that will got access;
• Network mask;
An example is shown at Figure 5.53.
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
223
Figure 5.51: Telephony - Configurations - g729 licence
VoIP domain alias
The VoIP server can accept calls not only for the main domain but for different
ones too. To add domains just click Modify and insert the domains one per line.
(Example at Figure 5.54).
Functions available for phones
Call transfer
Besides supporting the transference of calls made by the terminal equipment,
telephones SIP, PBX’s or softphones, IPBrick also makes transfers in any telephone, even if it does not support transfers from origin. The two types of transference allowed by IPBrick are:
• Assisted transfer: When receiving a call, the person receiving it dials an
extension, asks the person in that extension if he/she accepts the call or not,
disconnects it and the call is transferred. To execute an assisted transference
during the call, it is necessary to dial * (by default) and the name of the
extension or alternative address. Example: To transfer a call into a telephone
registered as ipbrick1 which has as alternative address the 480 extension, dial
*480 during conversation.
• No-assisted transfer: when receiving a call, the person receiving it dials
an extension and the call is immediately transferred to that extension. To
execute a non-assisted transference during a call, dial # (by default) and
the name of the extension or alternative address. Example: Non-assisted
transference to the above telephone: #480.
iPortalMais - 2008
Reference Guide - Version 5.0
224
Advanced Configurations
Figure 5.52: Telephony - IP PBX remote managers
To cancel a transference, you just have to dial again the number you have
dialled to transfer. Example: you wanted to transfer a call to extension 481
but you have dialled *482. To recapture the call you shall have to dial again
*482 and then it is possible to transfer to the correct number dialling *481.
Calls capture
To capture a call ringing in another extension, dial *8 followed by the name
with which the telephone was registered or the name of the group of telephones
ringing.
5.6.4
Interfaces
IPBrick can create more interfaces than PBX and PSTN (Figure 5.55) like
GSM or FAX interface. You can create them in:
Advanced Configurations - Telephony - Interfaces
Menu to insert interfaces (Figure 5.56):
• Interface Name;
• Interface Type: To what interface is associated IPBrick card;
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
225
Figure 5.53: Telephony - IP PBX remote managers - Configuration
• SIP Peering: The Open Peer option provides that any incoming call from
the Internet uses this interface. The Closed Peer option sets that only Peers
defined in SIP Peers (this is the best option connect to PSTN or GSM).
The Peers are the IP from machines authorized to use certain interface, for
instance another IPBrick. Can be inserted in the menu:
Advanced Configurations - Telephony - SIP Peers
• Receive gain: Receive gain in dB. Can be useful to increase it if we are
talking about the PSTN interface and at the IPBrick side we are listening
with low volume;
• Transmission gain: Transmission gain in dB. Can be useful to increase it
if we are talking about the PSTN interface and at the PSTN side they are
listening with low volume;
This operation is necessary if you want to connect a FAX to a card port, a GSM
gateway or another additional interface. If there is a GSM gateway, you may add
here a GSM interface (as an interface name). Choose a card type (analogic, PRI or
BRI) in the Interface Type , and the Closed Peer option in the SIP Peering.
iPortalMais - 2008
Reference Guide - Version 5.0
226
Advanced Configurations
Figure 5.54: Telephony - VoIP domain alias
5.6.5
SIP peers
You may add here IP addresses to let remote known gateways to use interfaces
defined as Closed Peers in IPBrick. For instance, you have two IPBrick’s connected
to each other through the Internet and one is connected to the PSTN. If you want
that remote IPBrick connects to PSTN interface, you need to add your IP to this
list by clicking on Modify. Example at Figure 5.57.
5.6.6
IAX peers
By clicking insert we define the IAX servers that are authorized to forward
the calls using that IPBrick. The IPBrick will accept inbound routes from other
servers that will be specified in that list. Example at Figure 5.58.
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
227
Figure 5.55: Telephony - Interfaces
iPortalMais - 2008
Reference Guide - Version 5.0
228
Advanced Configurations
Figure 5.56: Telephony - Interface insertion
Reference Guide - Version 5.0
iPortalMais - 2008
5.6 Telephony
229
Figure 5.57: Telephony - SIP peers
Figure 5.58: Telephony - IAX Peers
iPortalMais - 2008
Reference Guide - Version 5.0
230
Reference Guide - Version 5.0
Advanced Configurations
iPortalMais - 2008
Chapter 6
Apply Configurations
The option Apply Configurations allows you to make the configurations done
in IPBrick become effective in the system. In other words, any realized configurations become only effective in IPBrick after the IPBrick administrator clicks on
Apply Configurations.
Figure 6.1: Apply Configurations
iPortalMais - 2008
Reference Guide - Version 5.0
232
Reference Guide - Version 5.0
Apply Configurations
iPortalMais - 2008
Chapter 7
Appendix A
Join in the domain
This section describes the process of:
• Configuring a workstation with DHCP;
• Joining a workstation in a domain.
This process description presupposes the following:
• the domain controlling server is IPBrick.I ;
• the DNS domain is empresa.pt;
• the domain is EMPRESA.
In order to join a workstation in a domain you need to do the following steps:
1. Know the MAC address of the machine’s network interface card;
2. Chose a machine ”name”;
3. Have a machine IP address;
4. Create an entry for the machine in IPBrick.I ;
5. Update IPBrick.I.
7.1
Windows XP Professional Workstation
⇒ Note: Before starting the process of joining a machine in a domain you
have to know the username/password of a user who is administrator of the XP
machine. Then you can start the migration process.
Therefore you have to:
iPortalMais - 2008
Reference Guide - Version 5.0
234
Appendix A - Join in the domain
1. Press [windows];
2. Select My Local Network ;
3. Select Network Connections;
4. Right click the icon Local Network Connection and select Properties;
5. Chose TCP/IP in the open window and click on Properties;
6. Chose Get the IP Address Automatically in the open window and then
select Get the DNS server addresses automatically;
7. Close the network properties windows.
The next step is to confirm that the machine IP address is the same that was
introduced in IPBrick.I. Therefore you have to:
1. Press the keys [windows]+[R];
2. cmd [ENTER];
3. ipconfig /all;
4. Check the information in the IP Address field.
If the IP address is not the one introduced in IPBrick you have to release it
and renew it with the following commands:
1. Press the keys [windows]+[R];
2. cmd [ENTER];
3. ipconfig /release;
4. ipconfig /renew;
5. ipconfig /all.
If the machine IP address is right you can join the machine in the domain
EMPRESA:
1. Press the keys [windows]+[pause] and open the System Properties;
2. Select ”Computer Name”, click on ”Change...” and give the computer a name
(the name must have been created in IPBrick.I before);
3. Press button ”more..” and add the dns machine domain: empresa.pt. Do
not select the option Change the primary DNS suffix when the association
to the domain is changed ;
Reference Guide - Version 5.0
iPortalMais - 2008
7.1 Windows XP Professional Workstation
235
4. Insert EMPRESA in the domain. The password of the domain EMPRESA or of the machine administrator may be requested;
5. Click OK and close ”System Properties”;
6. Restart the machine. While the machine is starting you can already login
the domain EMPRESA.
⇒ Note: The workstation must not be with the DHCP. It can be configured
with a fix IP address. In this case you don’t have to fill in the field MAC Address
while you register the machine in IPBrick.
iPortalMais - 2008
Reference Guide - Version 5.0
236
Reference Guide - Version 5.0
Appendix A - Join in the domain
iPortalMais - 2008
Chapter 8
Appendix B
Configuring a VPN connection
In order to create a VPN (PPTP) connection in a Windows XP Professional
workstation you have to do the following steps:
1. Press [windows]
2. Select Control Panel
3. Double click Network Connections
4. In the window Network Connections, select Create a New Connection
5. The Wizard appears to create a new connection. Select ”Connect to my work
area network” (refers to the VPN description), ”Virtual Private Network
Connection”. After that select a name for the connection to be created, for
example ”Enterprise connection”. Then you have to indicate the IP address
or the full name by which IPBrick is known in the Internet. At last you have
to select who can use the VPN connection.
The VPN connection is configured. In order to establish a VPN you only have
to introduce the user name and password registered in IPBrick. IPBrick is now
working as a VPN-PPTP server.
iPortalMais - 2008
Reference Guide - Version 5.0
238
Appendix B - Configuring a VPN connection
Reference Guide - Version 5.0
iPortalMais - 2008
Chapter 9
Appendix C
Configuration of a VPN SSL
connection (Open VPN)
To create a VPN connection (Open VPN) in a Windows XP Professional workstation it is necessary to install the Open VPN GUI software::
• Open VPN - VPN Open Source Pack;
• Open VPN GUI - Graphic Interface for Open VPN.
The installation of this pack should be executed without changing the default
definitions. This software is installed in directory C:\Program Files\OpenVPN.
The certificate generated by IPBrick must be unpacked into directory C:\Program
Files\OpenVPN\config.
To start a VPN connection, press the right button on icon OpenVPN in the
toolbar, choose the intended connection and press Connect.
Insert the password used to create the certificate in IPBrick and the VPN shall
be established.
9.1
Two or more SSL certificates
When it is intended to put more than one certificate in the same workstation
(create VPN connections for distinct places) it is necessary to create a new folder
into directory C:\Program
Files\OpenVPN\config. Extract all the files to that new folder.
To initiate VPN connection, press the right button on icon OpenVPN in the
toolbar, choose in the list the connection and press Connect.
iPortalMais - 2008
Reference Guide - Version 5.0
240Appendix C - Configuration of a VPN SSL connection (Open VPN)
9.2
Configuration of a SSL Connection for Windows Vista
1. In http://openvpn.net/index.php/downloads.html download the last version (Windows Installer file). Example: openvpn-2.1_rc7-install.exe;
2. Install the openvpn;
3. Extract the zip file to the config folder of OpenVPN. Example: c:\Programas
\OpenVPN\config;
4. Run this file c:\Programas\OpenVPN\bin\openvpn-gui.exe, as Administrator;
5. In Windows Vista tray, click in the OpenVPN icon and connect;
NOTE: If it’s not working you need to modify the *.ovpn file present in
c:\Programas\OpenVPN\config, and add the following lines in the end:
route-method exe
route-delay 2
Reference Guide - Version 5.0
iPortalMais - 2008
Chapter 10
Appendix D
Backup Service - Arkeia
Arkeia is a full featured backup service. It allows accessing the Arkeia configuration interface, software for backup management installed in IPBrick by default.
When selecting this option, and after clicking the Open button, a session window by VNC is open. It is necessary to have the JRE1 , which can be found at
http://sun.java.com/ installed to execute the connection. The authentication
in this session is made with the IPBrick Administrator’s actual password. The
Arkeia management interface is available after validation.
At IPBrick 5.0 Arkeia is not included. You need to download the update 2
from the downloads section at IPBrick website.
In order to start the Arkeia configuration software it is necessary to submit
your validation by default:
login: root
password: (without password)
After the successful server connection the following menus are displayed (Figure
10.1):
• Backup: Sets, configures and launches Arkeia backup, including savepacks
• Restoration: Sets, configures and launches Arkeia restore function;
• Hardware: Sets and configures the hardware (drives, tapes, libraries) connected to the server;
• Running jobs: Displays the executing processes;
• Administration: Functions to configure Arkeia;
• Logs: Displays the logs that are generated by Arkeia.
iPortalMais - 2008
Reference Guide - Version 5.0
242
Appendix D - Backup Service - Arkeia
Figure 10.1: Backup - Arkeia - Main Menu
Arkeia menus are easy to use. When you access a menu, new sub-menus show
up with new options, successively. Every time you pick a menu, its icon appears
in a upper bar. To move back in these menus you only have to click in the corresponding icon.
To administrate Arkeia executing processes you have to select the Running
Jobs menu (Figure 10.2).
select the request line that will have more priority to backup execution (Figure
10.3).
Inside this menu, you can see the backup processes. These processes can have
two status:
• The process is pending waiting for confirmation, i.e., you have to click OK.
The user is alerted to replace the tape;
• The jobs are waiting for the conclusion of the remaining processes.
Usually, if backup administration is normally processed, with the administrator intervention in a daily basis, there will be only an execution process per day.
In the power failure case, all this processes are eliminated.
10.1
Advanced Administration
• Add users (Administration  Users (Figure 10.4))
1
Java Runtime Environment
Reference Guide - Version 5.0
iPortalMais - 2008
10.1 Advanced Administration
243
Figure 10.2: Backup - Arkeia - Running Jobs
Figure 10.3: Backup - Arkeia - Backups confirmation
Arkeia sends email messages reporting several occurrences, like the need to
insert tapes, the details of a backup process, etc. You should create a user
that gets the email messages (with an Administrator type role) to check if
the procedures is well done.
iPortalMais - 2008
Reference Guide - Version 5.0
244
Appendix D - Backup Service - Arkeia
Figure 10.4: Backup - Arkeia - Add Users
1. Insert:
(a) Name;
(b) Role;
(c) Email address.
• SavePacks (Backup  SavePacks)
This is an essential feature of Arkeia technology. A savepack is a set o paths
and files that are included in the backup.
1. Create a SavePack (usually named Data);
2. Add directories that will be include in the backup (name of SavePack
 Browse Trees) (Figure 10.5).
– /boot
– /etc
– /homeX (were 1 ≤ X ≤ number of homes)
– /opt/ipbox/backupDB
– /var/lib/ldap
– /var/lib/mysql
– /var/lib/postgres
– /var/lib/postgres2
– /var/lib/samba
Reference Guide - Version 5.0
iPortalMais - 2008
10.1 Advanced Administration
245
Figure 10.5: Backup - Arkeia - Directories to save
– sysinfo
• Configure the backups (Backup  Periodic) (Figure 10.6)
Figure 10.6: Backup - Arkeia - Levels
iPortalMais - 2008
Reference Guide - Version 5.0
246
Appendix D - Backup Service - Arkeia
1. Create a new Periodic Backup
2. Create 3 levels:
(a) Level 1 - Archive
(b) Level 2 - Weekly
(c) Level 3 - Daily
• For each backup select:
SavePack
DrivePack
Pool
Type
Valid for
Level 1
Level 2
Level 3
Archive
Total Backup
2 years
Weekly
Total Backup
8 weeks
Daily
Incremental
4 weeks
The available backup types are:
– Archive: Saves savepack data and keeps them indefinitely (requires
additional license);
– Total: Saves all the savepack data and keeps them during the period
set in Valid For;
– Differencial: Only saves the files that were modified since the last
Total type backup;
– Incremental: This is the most complex backup type. It creates a list
with the modified files since last backup (both Total and Incremental)
and proceeds to the backup of the files included in the list.
Reference Guide - Version 5.0
iPortalMais - 2008