Steps to install Appliance using Chef-Solo (Linux)

Note: We recommend that you use the root user when using a terminal session for these Linux steps. If you use the sudo user, you must specify "sudo" before each command you run in these steps.
  1. Create Birst working directory: mkdir /opt/birst
  2. Download and setup the Birst artifacts for the server.
    1. Open a terminal session and become the root user.
    2. Install ‘unzip’ and ‘wget’ RPM Packages: root yum install wget unzip -y
    3. Download the Bundle file. For example: wget -P /tmp https://birst-cpt-repo.s3.us-west-1.amazonaws.com/Birst-Package-Appliance/FINAL/2023.04.05.217385/birst-linux-nginx-bundle-2023.04.05.217385.zip
      Note: The Birst Appliance Bundle (approximately 7.5GB) can take up to 6 or more hours to download. If a faster download is required, we can create an S3 Bucket or an Infor download link in the future. This may require the source IP address to be whitelisted on our side.
  3. Extract the Bundle contents:
    • sudo unzip /tmp/birst-linux-nginx-bundle-2023.04.05.217385.zip -d /tmp/
    • sudo unzip /tmp/birst-appliance-utility-linux-0.0.1.2023.04.05.217385.zip -d /
    • sudo unzip /tmp/birst-nginx-2023.04.05.217385-linux.zip -d /opt/birst/
  4. Use the command line to update configurations on the Linux NGINX server for the json file: /home/birstuser/birst_config/standalone_nginx_role.json
    1. Replace the IP Address from 10.0.0.10 to the correct Windows appliance private IP Address, and then change CHANGEME_IP with your IP address. Run: sudo sed -i "s/10.0.0.10/CHANGEME_IP/g" /home/birstuser/birst_config/standalone_nginx_role.json
  5. Run the Birst Management Console script from an SSH terminal.
    1. Run and launch the Birst Management Console bash script: sh /home/birstuser/birst_client/birst-management-console.sh
    2. Select option 0 from the Birst Management Console menu to Install Birst Frontend Service and reboot the server after the installation is completed.
  6. Verify that the NGINX Server Health Checks shows that the Birst Appliance services are operational and can be reached through the network. Note: This test uses HTTP:
    1. On the NGINX Server's Linux Command Line, run: http://<nginx_server_ip_or_hostname>:18080/status curl http://localhost:18080/status
    2. From a desktop browser that can reach the NGINX Server's IP or host name: http://<nginx_server_ip_or_hostname>:18080/status
    All services listed in the status output should be UP and should not be DOWN. You must troubleshoot any services that are down. Typical issues of a down service are:
    • An incorrect update of the Birst Appliance Server IP address in the NGINX configuration.
    • Network connectivity issues between the NGINX server and the Birst Appliance server.
      Note: The connectorController service can take up to 10 or 15 minutes to update to UP.
  7. Verify that you can log in to the Birst Appliance using the HTTPS NGINX URL (use either IP or hostname) on your browser. Make sure that the browser is launched from a workstation that can access the network and the port for the NGINX server: https://<nginx_server_ip_or_hostname>
    Note:  This test uses HTTPS
  8. Test and validate Birst Standalone Appliance, including these features:
    • Logging in and logging out
    • Space creation
    • Test data loading
    • ETL
    • Orchestration/ Scheduling of ETL
    • Report creation
    • Dashboard creation