startalk needs to start some http/https based services that are supported through an interface provided by the open source software openresty. This project describes how to install and configure openresty for startalk.
- All web-related software is installed under
${STARTALK_OPENRESTY}
, the default is the/usr/local/openresty
directory. - The default installation user and user group is:
startalk:startalk
, which may require the systemstartalk
user to havesudo
privileges, or users familiar with the system can use their own normal user, such asnobody
startalk
user has adownload
folder in his home directory, all source code and configuration files will be downloaded to this folder- The initial password for the database user name is
ejabberd:123456
and the default address of the database server is127.0.0.1
Please change it yourself redis
initial password is:123456
, the service address is:127.0.0.1
Please change it yourself
- conf: the main configuration file of openresty used by startalk
- startalk_lua : some lua code used by startalk's openresty, used to make dynamic changes to requests
- tools: some tools for testing
Startalk has some built-in or (running lua-jit) services for IM http request load balancing, see ejabberd for the full architecture
$ export STARTALK_OPENRESTY=/usr/local/openresty
$ sudo mkdir -p ${STARTALK_OPENRESTY}
This step is to install the openresty software, download the software as a startalk user and compile and install it, if the system already has openresty packages (rpm, deb, etc.), you can ignore this step.
However, you should pay attention to openresty startup user and default installation location, most of the default installation package openresty
configuration file is in /usr/local/openresty/nginx/conf/nginx.conf
.
Please note that the following ${STARTALK_OPENRESTY}
variable is set or replaced with the default above.
Do not build your own openresty if you are no familiare with Linux and/or open source software. We strongly recommend to use prebuild openresty package on OpenResty Web Site instead. Please omit the rest info in this section if you've installed openresty via prebuild package.
$ cd /home/startalk/download
$ wget https://openresty.org/download/openresty-1.13.6.2.tar.gz
$ tar -zxvf openresty-1.13.6.2.tar.gz
$ . /configure --prefix=${STARTALK_OPENRESTY}
$ make
$ sudo make install
$ cd /home/startalk/download
$ git clone https://github.com/startalkIM/openresty_ng.git
$ cd openresty_ng
$ sudo cp -rf conf ${STARTALK_OPENRESTY}/nginx
$ sudo cp -rf startalk_lua ${STARTALK_OPENRESTY}/nginx
Please note that the contents of ${STARTALK_OPENRESTY}/nginx/conf/startalk-nginx.conf-sample
are modified to ${STARTALK_OPENRESTY}/nginx/conf/nginx.conf
.
If you are completely lazy, overwrite ${STARTALK_OPENRESTY}/nginx/conf/nginx.conf
with the project's conf/startalk-nginx.conf-sample
file.
$ sudo cp -rf conf/startalk-nginx.conf-sample ${STARTALK_OPENRESTY}/nginx/conf/nginx.conf
Please note that you must know what you are doing before you execute this command above.
${STARTALK_OPENRESTY}/nginx/conf/conf.d/startalk/or.server.location.package.qtapi.conf
${STARTALK_OPENRESTY}/nginx/conf/conf.d/startalkupstream/st.upstream.conf
${STARTALK_OPENRESTY}/nginx/startalk_lua/checks/qim/startalkredis.lua
Be careful we use -p
parameter to coordinate with lua_package_path
in nginx.conf.sample
.
Start:
$ sudo ${STARTALK_OPENRESTY}/nginx/sbin/nginx -p ${STARTALK_OPENRESTY}/nginx -c ${STARTALK_OPENRESTY}/nginx/conf/nginx.conf
Stop:
$ sudo ${STARTALK_OPENRESTY}/nginx/sbin/nginx -p ${STARTALK_OPENRESTY}/nginx -c ${STARTALK_OPENRESTY}/nginx/conf/nginx.conf -s stop
reload:
$ sudo ${STARTALK_OPENRESTY}/nginx/sbin/nginx -p ${STARTALK_OPENRESTY}/nginx -c ${STARTALK_OPENRESTY}/nginx/conf/nginx.conf -s reload
Please follow your prebuilded openresty package upgrade instructions.