For users wanting to setup a production ZStack environment, the recommended way is to install ZStack management node, MySQL, and RabbitMQ message broker on separate machines:
For machine to install ZStack management node, we recommend below hardware specification:
|CPU||>= 4 Cores Intel/AMD CPUs supporting VT-x or SVM|
For machines to install MySQL and RabbitMQ message broker, please refer to their official web sites.
|ZStack Enterprise management node||Install ZStack OS and ZStack Enterprise Management Node, which includes full Enterprise features (like VM HA, QoS, VM password resetting ...) with 1 free computing node license.|
|ZStack Community Management Node||Install ZStack OS and ZStack Community Management Node, which could add unlimited computing nodes.|
|ZStack Computing Node||Install ZStack OS and the computing node essential packages.|
|ZStack Expert Node||Install ZStack OS and config the local yum. This is for advanced usage, e.g. installing multiple ZStack Management Nodes.|
The system has been pre-configured default options: DATE & TIME for the East Asia Area, LANGUAGE is English, KEYBOARD is English (US). The administrator can change the configuration.
If you use Manual Installation, please choose
ZStack Expert Mode.
wget http://cdn.zstack.io/community/downloads/zstack/2.0/ZStack-installer-2.0.2.bin bash ZStack-installer-2.0.2.bin -i
You can use ZStack control tool
zstack-ctl, which is automatically installed along with ZStack in step 1.1, to install MySQL.
sudo zstack-ctl install_db --host=ip_of_machine_to_install_mysql Example: sudo zstack-ctl install_db --host=192.168.0.224
zstack-ctl leverages Ansible to do the installation; it will ask you for SSH root password, if the SSH key is not set on the remote machine.
You can use
zstack-ctl to install RabbitMQ message broker:
sudo zstack-ctl install_rabbitmq --host=ip_of_machine_to_install_mysql Example: sudo zstack-ctl install_rabbitmq --host=192.168.0.224
zstack-ctlwill automatically update IP of RabbitMQ to zstack.properties file.
You can use
zstack-ctl to install web UI:
sudo zstack-ctl install_ui
sudo zstack-ctl install_ui --host=ip_of_machine_to_install_ui Example: sudo zstack-ctl install_ui --host=192.168.0.224
Now your ZStack is successfully installed, visit Getting Started With Manual Installation see how to configure and run ZStack. You can also use above steps to install all software on a single machine.
For curious users who want to install ZStack without help from any script/tool, as ZStack is a standard Java WAR file, you can follow below instructions.
ZStack user should download the ZStack OS ZStack-x86_64-DVD-2.0.2.iso.
sudo yum install mariadb mariadb-server
sudo yum install rabbitmq-server
sudo easy_install pip pip install --upgrade pip yum install openssl-devel.x86_64 sudo pip install ansible==1.9.6
Note: We specify Ansible version to 1.9.6 because it's the version we have tested. Later versions should work too.
ZStack requires JRE7 or later version.
sudo yum install java-1.8.0-openjdk
As a standard Java WAR file, ZStack can be deployed in any Java web container; however, we recommend Tomcat because of its well-established reputation. We recommend not to use the default Tomcat version shipped by Linux distributions, because they are usually old and contain modifications that may cause troubles. You can download and install Tomcat from the official site by:
wget http://archive.apache.org/dist/tomcat/tomcat-7/v7.0.35/bin/apache-tomcat-7.0.35.tar.gz tar xzf apache-tomcat-7.0.35.tar.gz
Assuming your Tomcat
$CATALINA_HOME is /usr/local/apache-tomcat-7.0.35, you can download and install ZStack by:
cd /usr/local/apache-tomcat-7.0.35/webapps wget http://cdn.zstack.io/product_downloads/war/zstack-2.0.2.war yum install unzip unzip zstack-2.0.2.war -d zstack
In following sections, we assume the
$CATALINA_HOME is /usr/local/apache-tomcat-7.0.35/.
sudo sh /usr/local/zstack/apache-tomcat-7.0.35/webapps/zstack/WEB-INF/classes/tools/install.sh zstack-ctl
sudo sh /usr/local/zstack/apache-tomcat-7.0.35/webapps/zstack/WEB-INF/classes/tools/install.sh zstack-cli
You can install ZStack web UI by:
sudo sh /usr/local/zstack/apache-tomcat-7.0.35/webapps/zstack/WEB-INF/classes/tools/install.sh zstack-ui
Now your ZStack environment is successfully installed, visit Getting Started With Manual Installation see how to configure and run ZStack.