forked from superdesk/Live-Blog
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathINSTALL.txt
88 lines (62 loc) · 2.92 KB
/
INSTALL.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
Installation procedure for Live Blog v1.0 (for developers)
http://www.sourcefabric.org
PREPARATION
-----------
The following applications need to be installed prior to Live Blog:
1. Python 3.2
Live Blog requires Python 3.2 with standard libraries.
2. Java
Version 1.5 or later. The 'java' binary must be in the system path.
INSTALLATION FROM SOURCES (FOR DEVELOPERS)
-------------------------------------------
1. Install the Ally-Py framework
See https://github.com/sourcefabric/Ally-py
2. Create a directory named "superdesk" inside Ally-Py directory and copy in
it the content of this package.
3. Build eggs by running the following command:
[path_to_livedesk]/build-eggs
4. Create the configuration files by running the following command:
[path_to_python3.2] [path_to_livedesk]/distribution/application.py -dump
E.g.: python3 /var/opt/ally-py/livedesk/distribution/application.py -dump
In this example the content of the package was copied in the
/var/opt/ally-py/livedesk directory and python3 binary is in the system path.
5. Start the REST Ally server by running the following command:
[path_to_python3.2] [path_to_livedesk]/distribution/application.py
The admin interface can be accessed from a browser on the same system at
the URL: http://localhost:8080/content/lib/core/start.html
Log in with admin and password a
Access from the Internet
------------------------
In order to access the application from other machines the following changes
need to be done:
1. Edit the file 'distribution/application.properties', search for
the property 'server_host' and change it to '0.0.0.0'
E.g.: server_host: 0.0.0.0
2. Edit the file 'distribution/plugins.properties', search for the
properties 'server_url' and 'embed_server_url' and change them to
'[machine_name_or_ip]:8080
E.g.: server_url: my.machine.domain.com:8080
3. Restart the REST Ally server.
Embedding Live Blog into your site
---------------------------------
In order to embed the output of your liveblog into your site take the
following steps:
1. Open the admin interface (see above)
2. Select the blog that you want to embed from the menu
3. Click 'Configure Blog' button
4. Select an embed theme
5. Copy the content of the field 'Embed script' and paste it into your site
content.
Changing the database server
----------------------------
Edit the file plugins.properties, search for db_superdesk.database_url and
modify the URL. E.g.:
db_superdesk.database_url: mysql+mysqlconnector://root:@localhost/livedesk
The URL is a string in the form
``dialect+driver://user:password@host/dbname[?key=value..]``, where
``dialect`` is a database name such as ``mysql``, ``oracle``,
``postgresql``, etc., and ``driver`` the name of a DBAPI, such as
``psycopg2``, ``pyodbc``, ``cx_oracle``, etc. Alternatively,
the URL can be an instance of :class:`~sqlalchemy.engine.url.URL`.
Read the SQLAlchemy manual for more details:
http://docs.sqlalchemy.org/en/latest/core/engines.html