Skip to content

Install Yeastar Workplace

This article describes how to connect to the server host and install Yeastar Workplace on your dedicated server during the process of on-premise deployment.

Step1. Connect to your server

  1. Connect to your server.
    This article uses terminal simulation software Xshell as an example.

    1. Open Xshell, on the top navigation bar, click File and select New.
    2. In the pop-up dialog box, fill in the fields in the General section:
      • Name: Specify a name to help you identify this connection.
      • Protocol: Retain the default value SSH.
      • Host: Enter the IP address of your server.
      • Port Number: Retain the default value 22.
    3. In the Category menu, click Authentication and enter the user name and password.
    4. Click Connect.

  2. After connecting successfully, run the following command and enter the password to enable root privileges.

    sudo –i
    

Step2. Upload Yeastar Workplace installation package

Linux supports a variety of methods for uploading files, and this article takes lrzsz as an example.

  1. Run the following command to install lrzsz.

    apt install lrzsz
    

    troubleshooting: Unable to locate package

    Run the command "apt-get update" to update the package source and try again.

  2. Run the following command, and in the pop-up dialog box, select the Yeastar Workplace installation package to upload it to your server.

    rz
    
    Stay connected to the server before the upload is complete.

Step3. Decrypt the installation package

  1. run the following command to decrypt the installation package.

    openssl enc -aes256 -d -md sha256 -salt -in workplace-71.2.0.x.bin -out workplace-71.2.0.x.tar.gz 
    

    Important

    "workplace-71.2.0.x" refers to the version number of your Yeastar Workplace installation package, replace both "workplace-71.2.0.x" in the command with the version number of your installation package before running it, otherwise the decryption will fail.

  2. Enter the password: Yeastar12345@ and press Enter, the decryption will begin.

    Important

    No characters will be displayed when you enter the password, but the system will record what you entered. If the decryption failed, it may be because the password is entered incorrectly, so you can re-execute the operation of 1-2.

  3. Run the following command to view the decryption result.

    ls  
    
    If there is workplace-71.2.0.x.tar.gz in the listed files, it means the decryption was successful.

Step4. Unzip Yeastar Workplace installation package

Run the following command to unzip the installation package.

tar -xzvf workplace-71.2.0.x.tar.gz

Important

Replace the "workplace-71.2.0.x" with the version number of your Yeastar Workplace installation package before running this command.

Step5. Optional: Upload SSL certificate

For online versions that require integration with a third party, uploading SSL certificate is required.

  1. Run the following command to create the directory for SSL certificate files.

    mkdir ./workplace-71.2.0.x/cert
    

    Important

    Replace the "workplace-71.2.0.x" in the command with the version number of your Yeastar Workplace installation package before running it.

  2. Run the following command to enter the directory for SSL certificate files.

    cd workplace-71.2.0.x/cert 
    

    Important

    Replace the "workplace-71.2.0.x" in the command with the version number of your Yeastar Workplace installation package before running it.

  3. Run the following command to upload smart.key and smart.cer files.

    rz      
    

Step6. Upload and edit the .env files

  1. Run the following commands to enter the directory for workplace-71.2.0.x.

    cd ~
    
    cd workplace-71.2.0.x
    

    Important

    Replace the "workplace-71.2.0.x" in the command with the version number of your Yeastar Workplace installation package before running it.

  2. Run the following command to upload secret.env file.

    rz
    

  3. Run the following command to open .env files.

    vi .env 
    

  4. Press i key to enter the insert mode, and finish the following configurations in Basic Settings section.

    Item Default value Description
    HOST_IP 127.0.0.1 Replace the default value with the IP address of your host.
    HOST_DOMAIN_NAME workplace.com Replace the default value with the domain name or IP address of your server.
    TZ UTC Replace the default value with the time zone where your server is located.
    The entered value must be the same value in TZ database name filed of this list of time zones.
    MYSQL_ROOT_PASSWORD Do_not_use_default_password! Create a new root password of MySQL and replace the default value.
    MYSQL_USER user The username to access MYSQL_DATABASE, replace the default value with a new user name, or note down the default value.
    MYSQL_PASSWORD Do_not_use_default_password! Create a new password for MYSQL_USER and replace the default value.
    REDIS_PASSWORD Do_not_use_default_password! Create a new password for Redis and replace the default value.
    S3_ACCESS_KEY_ID admin The username of the initial Admin account of the MinIO container. When using an external S3 service (such as AWS S3), the username will be used as the Access Key Id of the user with access to the S3 Bucket.
    Replace the default value with a new username, or note down the default value.
    S3_SECRET_ACCESS_KEY Do_not_use_default_password! Create a new password for the Admin account of the MinIO container, and replace the default value.
    When using an external S3 service (such as AWS S3), the password will be used as the Access Key Id of the user with access to the S3 Bucket.
    EMQX_DASHBOARD_USER admin The username of the initial Admin account of EMQX Dashboard.
    Replace the default value with a new username, or note down the default value.
    EMQX_DASHBOARD_PASSWORD Do_not_use_default_password! Create a new password for the Admin account of EMQX Dashboard, and replace the default value.
    RMQ_CONSOLE_USER admin The username of the initial Admin account of RocketMQ Dashboard.
    Replace the default value with a new username, or note down the default value.
    RMQ_CONSOLE_PASSWORD Do_not_use_default_password! Create a new password for the Admin account of RocketMQ Dashboard, and replace the default value.
  5. If you didn't upload the SSL certificate in step 5, you need to configure the following items in the Advanced Settings section:

    • SSL_ENABLED: Replace the default value with false
    • HTTP_PROTOCOL: Replace the default value with http
  6. Press Esc to quit insert mode, and run the following command to save the changes and close the .env files.

    :wq
    

Step7. Install Yeastar Workplace

Run the following command to install Yeastar Workplace.

./install

What to do next

Now you need to activate the system based on the version of your Yeastar Workplace:


Last update: June 24, 2022