This topic contains information to install the BMC AMI DevX Workbench Server on Mac.

System requirements

• Java 11 or later

To install BMC AMI DevX Workbench Server on Mac

1. Navigate to the directory where you have copied the above files.
2. Execute the installer with sudo sh macinstall.command
3. A window will appear and proceed as follows.
   1.  Introduction screen, press Next.
   2. Read the license agreement and accept it.
   3. Enter the path to the directory where you want to install Workbench Server. Use /Library or /usr path in order to allow DAEMON to access the files.
4. Enter the user ID to be used to execute the DAEMON.
5. Enter the desired port number of the Workbench Server.
6. If you do not want to enable the SSL,  the installer skips the SSL-related questions and if you're going to enable it, you need to answer the following questions: 
   • Certificate alias: The alias or friendly name of the certificate to be presented to the client by the user when a connection is made (required)
   • The keystore type: We support JKS and PKCS12
     • JKS
       • Keystore location: Full path to the JKS file containing the certificate (required)
       • Keystore password: The password required to read the key store (required if JKS file is password protected)
       • Certificate password: The password for the certificate in the key store (required if the certificate is password protected)
     • PKCS12
       • Keystore location: Full path to the PKCS12 file containing the certificate (required)
       • Keystore password: The password required to read the key store (required if PKCS12 file is password protected)
       • Certificate password: The password for the certificate in the key store (required if the certificate is password protected)

7. Review the installation summary, and press Next to continue the installation. When the installation is complete, press Done to exit the installer.
   The Workbench server will be started and verified by sudo launchctl list | grep workbench.
   
   

   Important

   If the server is not up, we can follow the below steps:

   To run Workbench Server as a DAEMON, cd to the installation directory and execute

   sudo sh workbench_service.sh -install

   Use {{ sudo launchctl list | grep workbench }} to verify Workbench Server is running.

   To uninstall the DAEMON, use sudo sh workbench_service.sh -remove

   If you are not able to use the sudo sh workbench_service.sh -install command, then you can use the following commands:

   Use {{ ./execworkbench.sh stop}} to stop Workbench Server.

   Use {{./execworkbench.sh run}} to start Workbench Server.