You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+6-253Lines changed: 6 additions & 253 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,263 +4,16 @@ SIP receiving tools for archives.
4
4
5
5
# Installation Guide
6
6
7
-
## Prerequisites
7
+
Instructions for preparing for, installing and setting up ETA (and ESSArch Core) can be found at http://doc.essarch.org/
8
8
9
-
Hardware configuration for server, network and storage architecture is not affected in this guide. Software configurations for server operating systems occur preferably before the installation of ESSArch begins. The installation is expected to be done as user 'root'.
9
+
# Documentation
10
10
11
-
## Supported OS platforms
11
+
Source for the documentation can be found in the `docs` folder
[arch@server ~]$ tar xvf ESSArch_TA_installer_xxxxxxxxxxxx.tar.gz
117
-
[arch@server ~]$ cd ESSArch_TA_installer
118
-
[arch@server ~]$ ./install
119
-
120
-
The installation of ESSArch is now running and dependent on hardware configuration, the installation may take some time. To see details of the installation progress please start a new terminal window and run the following command.
121
-
[arch@server ~]$ tail -f /ESSArch/install.log
122
-
123
-
When installation is finished, search in the log file /ESSArch/install.log for any unexpected errors indicating failure of installation of any modules.
124
-
125
-
### Installation of Advanced Message Queuing Protocol
126
-
127
-
ESSArch is designed to be AMQP (Advanced Message Queuing Protocol) independent. However the installation package is prepared for RabbitMQ and the following instructions assume that you use RabbitMQ.
128
-
129
-
Follow the instructions below in order to install RabbitMQ required by ESSArch.
If startup failed and you see an error message in /var/log/rabbitmq/startup_log after a minute or so like:
137
-
138
-
ERROR: epmd error for host "yourhostname": timeout (timed out)_
139
-
140
-
Then you need to update your /etc/hosts file to add your hostname to the list of localhost:
141
-
142
-
127.0.0.1 yourhostname
143
-
144
-
## Configuring
145
-
146
-
### Apache httpd configuration
147
-
148
-
Edit file /ESSArch/config/httpd-eta.conf and change the configuration entry for "ServerName" to same as the hostname of the ESSArch server.
149
-
150
-
For test purpose you can use the existing configuration for SSL certificate, but for production environment and for maximum security we recommend generating your own SSL certificate or if you have your own SSL trusted certificate install them in the apache httpd configuration.
151
-
152
-
### ESSArch configuration
153
-
154
-
In /ESSArch/config you will find all the configuration files for ESSArch. The main configuration file for ESSArch WEB GUI is local_eta_settings.py.
155
-
156
-
For ESSArch you will find the configuration in the local database tables. To change the configuration please login as admin user is ETA and select menu MANAGEMENT > Configuration
157
-
158
-
## Database
159
-
160
-
ESSArch is designed to be RDBMS-independent.
161
-
162
-
### Create default tables in database
163
-
164
-
Please run the following command as user: arch
165
-
[arch@server ~]$ python $ETA/manage.py migrate
166
-
167
-
## Add default configuration data to database
168
-
169
-
Use only this default configuration for test purpose, do not install this default configuration in production.
170
-
171
-
For production environment you should first make a copy of this configuration file and update for example site_profile, site_name. After you done all your updates you install it.
Note that a startup or shutdown of ETA should always be controlled.
213
-
214
-
Please run the following command as user root to start ETA.
215
-
# service celeryd start
216
-
# service celerybeat start
217
-
# service httpd start
218
-
219
-
## Stop ETA server
220
-
221
-
Please run the following command as user root to stop ETA.
222
-
# service httpd stop
223
-
# service celeryd stop
224
-
# service celerybeat stop
225
-
226
-
## Start ETA WEB interface
227
-
228
-
Start your preferable web browser and connect to ETA Server name or IP address.
229
-
230
-
URL: [https://xxxxxxxx](https://xxxxxxxx)
231
-
232
-
By default, for test purpose, the installation has configured the following users:
233
-
234
-
|**Username**|**Password**|**Role/Permissions**|
235
-
| --- | --- | --- |
236
-
| usr2 | usr2 | receive, events, transfer |
237
-
| admin | admin | admin |
238
-
239
-
## Important files to backup
240
-
241
-
Important data in ESSArch to backup is the configuration, log files and database. All areas which are mounted from external file servers should be backed up.
242
-
243
-
Everything in the file area /ESSArch should be backed up before and after configuration changes or changes in ESSArch system installation, for example when upgrading and software patches.
244
-
245
-
Areas that need to be backed up to an external "backup system" daily is the following:
246
-
247
-
- /ESSArch/eta
248
-
- /ESSArch/backups_mysql
249
-
- /ESSArch/config
250
-
- /ESSArch/log
251
-
- /ESSArch/data
252
-
253
-
##Events and log information
254
-
255
-
Different types of events are logged both in physical files and tables in ESSArch database. Log entries are tagged with the log level - Debug, Critical, Error, Warning, Info. These log levels can be felt by the ETA's system logs:
256
-
257
-
- /ESSArch/log
258
-
- /ESSArch/log/celerybeat.log
259
-
- /ESSArch/log/celery_worker1.log
260
-
- /ESSArch/log/httpd_access.log
261
-
- /ESSArch/log/httpd_error.log
262
-
- /ESSArch/log/httpd_ssl_request.log
263
-
264
-
# Service och support
17
+
# Service and support
265
18
266
19
Service and support on ETA is regulated in maintenance contract with ES Solutions AB. A case is registered on the support portal http://projects.essolutions.se
0 commit comments