App Gateway Installation for safous.com

Installation:

  1. Login to Safous Admin Portal (https://portal.safous.com/), which you can refer to this link and go to Tenant > Services where you can find Get Token button


    Important Note!!
    Get Token button will be grey-out once you already installed all App Gateway as contracted

  2. Once you click Get Token button, it will pop-up the Safous Installation Token


  3. SSH to your virtual machine/host where you want to install the App Gateway. Please make sure to use a user with root privilege.
  4. Please copy the Safous Installation Token as <INSTALLATION_TOKEN> value, then execute this command
    TOKEN=<INSTALLATION_TOKEN>

    Important Note!!
    TOKEN only valid for 24 hours since it generated

  5. Download installer by executing this command
    curl -s --fail -H "Authorization: Bearer $TOKEN" https://setup.safous.com/installer -o installer || echo 'Error'


  6. Run installation mechanism of App Gateway by executing this command
    sudo bash installer


  7. Once you run previous command for installation, it will ask series of input either it’s based on options or string-based input. The first one is to verify whether the domain that you will use is the right one or not (either using Safous domain or your owned domain). 


  8. If that’s the correct one, then just press enter, if it’s not the correct one please changes as the correct one 

  9. Next, it will get the necessary SSL certificate for your App Gateway 


  10. Once the installation system already got the certificate for App Gateway, depends on which Safous service domain that you use, it will give different option. These options will be available if you use xxx.ztna.safous.com
      • Choose number 1, if it deployed in Japan
      • Choose number 2, if it deployed in ASEAN Countries (Indonesia, Malaysia, Philippines, Thailand, and Vietnam)
      • Choose number 3, if it deployed other than Japan, Indonesia, Malaysia, Philippines, Thailand, and Vietnam

        pop-option-new


  11. Next, it will ask to input password 
    • Enter a first-time password. Note that the requirements are:
      • At least 8 digits long
      • Have at least 1 upper case letter
      • Have at least 1 lower case letter
      • Have at least 1 symbol
    • Enter the password the second time


      Please keep this password. It may be needed for troubleshooting purpose by Safous Support Team.
  12. It will ask site name for App Gateway that will be deployed, please enter name you prefer 
        • If you’re deploying App Gateway for different site, ensure you’re using different name than the existing one 
        • If you’re deploying App Gateway for the same site to have HA functionality, ensure it use the same name


  13. Then the installer will checked and ensuring all package dependencies has been installed for App Gateway to running correctly 


  14. Next the installation will proceed to install package requirements and other configuration. Once it finished, you can see all checklist at the end of installation

 


 

Verification

Last procedure after you can see all checklist at the end of installation is to do first time verification of App Gateway that have been installed by conducting these:

  • Ensure you’re still on the App Gateway host SSH terminal
  • Run this command down below, which need to change <DOMAIN> with the domain parameter that you could find in the installation process:
    curl https://login.<DOMAIN>

     

  • If the App Gateway successfully installed, it will give output like this:
  • If the App Gateway installation is failed, it will give output like this:
  • If the output resembles success example, your app gateway installation is finished and you could create your new user to login to user portal by refer to this link

  • If the output resembles failed example, please contact support@safous.com right away to get help with Safous Support.