Deploy Digital Messaging Server Using GAX

The following steps describe how to deploy Digital Messaging Server (DMS) using Genesys Administrator Extension (GAX). Refer to the GAX documentation if you need additional information.

Upload the DMS installation package and template

1. Log in to GAX.
2. Go to Administration > Installation Packages.
3. Click + (New) to upload a new installation package.
4. In the Software Installation Wizard panel, select Installation Package Upload (template uploaded separately) and click Next.
5. Complete the following steps:
   • Upload a Package—Select the ZIP file that contains the DMS installation package. The root folder of the ZIP file must have the files from the IP folder (such as ip_description.xml and read_me.html).
   • Upload an XML template—Select the XML template file (DigitalMessagingServer.xml).
   • Upload an APD template—Select the APD template file (DigitalMessagingServer.apd).
6. Click Finish.

Deploy the DMS installation package and template

1. In GAX, go to Administration > Installation Packages.
2. Click the DMS installation package to view its properties.
3. Verify the Status field has a value of Complete.
4. Click and select Install to open the IP Deployment Wizard panel.
5. Fill in the required fields and finish the installation.

Legacy deployment method (optional)

You can also install DMS directly on the server by following the steps below.

[+] Click to show section

Create a DMS Application object

Create an Application object for DMS if it does not already exist.

1. Import the DMS Application Template from the CD.
2. Create a new Application object based on the template.
   1. Open the Properties dialog box of the Application object.
   2. On the Server Info tab:
      1. In the Host box, enter the name of the desired host.
      2. In the Communication Port box, enter the port DMS will use.
3. On the Start Info tab, enter some characters in the Working Directory, Command Line, and Command Line Arguments fields. These characters will be overwritten with the correct values during the installation, but they cannot be left blank at this point.
4. On the Connections tab, add a connection to all components mentioned.
5. If this is for a multi-tenant environment, add the tenant(s) on the Tenants tab.
6. Open your Interaction Server Application and add a connection to DMS. Specify the Connection Protocol as either simple or addp.

Install DMS

See the Supported Operating Environment Reference for prerequisites before you install DMS.

Windows

1. Locate the Setup.exe file for DMS on the product CD.
2. Double-click Setup.exe.
3. Select Java.
4. Enter the login information for your Configuration Server:
   • Host
   • Port
   • User
   • Password
5. Select the appropriate DMS Application object from the list.
6. Confirm selection of JDK.
7. Click Install.

Linux

1. Locate the install.sh file for DMS.
2. Use the command >install.sh to start the installation script.
3. On request, enter the absolute path for the directory of the Java executable.
4. Press Enter to confirm the host name for the installation.
5. Enter the login information for your Configuration Server:
   • Host
   • Port
   • User
   • Password
6. From the list of applications, select one and enter its number in the list.
7. Press Enter to confirm the suggested destination directory, or choose another one.
8. Answer other questions, if required.

TLS connection as a Windows Service

Prerequisite: TLS 1.2 or higher

When DMS has Transport Layer Security (TLS) configured, either as a server on its ESP port, or as a client in its connection to Configuration Server, Interaction Server, Message Server, Chat Server, and UCS, follow these steps to enable it as a Windows Service:

1. Select the Windows service related to Digital Messaging Server .
2. Select the Log On tab. The default setting is Log on as local system account.
3. Select Log on as this account and provide the login/password of a local host user.

Proxy server support for DMS

1. Edit the appropriate file by adding these Java runtime startup options:
   • If using Genesys Cloud API Driver for Facebook 8.5.300.09 or earlier, or Genesys Cloud API Driver for Twitter 8.5.300.07 or earlier:
     • -DproxySet=true
     • -DproxyHost=<host of proxy server>
     • -DproxyPort=<port of proxy server>
   • If using Genesys Cloud API Driver for Facebook 8.5.300.10 or later, or Genesys Cloud API Driver for Twitter 8.5.300.08 or later:
     • -Dhttp.proxyHost=<host of proxy server>
     • -Dhttp.proxyPort=<port of proxy server>
     • -Dhttps.proxyHost=<host of proxy server>
     • -Dhttps.proxyPort=<port of proxy server>
2. To enable authentication for the proxy server, add these options as well:
   • If using Genesys Cloud API Driver for Facebook 8.5.300.09 or earlier, or Genesys Cloud API Driver for Twitter 8.5.300.07 or earlier:
     • -DproxyUser=<username>
     • -DproxyPassword=<password>
   • If using Genesys Cloud API Driver for Facebook 8.5.300.10 or later, or Genesys Cloud API Driver for Twitter 8.5.300.08 or later:
     • -Dhttp.proxyUser=<username>
     • -Dhttp.proxyPassword=<password>
3. File to edit:
   • Windows: In avaServerStarter.ini, the [JavaArgs] section.
   • Unix and related systems: In smserver.sh, the last string, namely "$JAVA_EXECUTABLE_PATH/java" -classpath $CLASSPATH $JVMPARAMS $MAINCLASS $*

Next Steps

Continue deployment by adding a Facebook channel, a Twitter channel, or a Custom Media Channel.

Uninstalling DMS

Important

• If you have also installed Genesys drivers for DMS (for example, Apple Business Chat), you must uninstall these drivers separately. These drivers are not uninstalled if DMS is uninstalled.
• You cannot uninstall DMS and then install a new instance of DMS at the same location and use the old driver instances. You must also reinstall drivers that you want to use with the new DMS instance.
• You must delete the DMS Application object separately.

Windows

Uninstall using the wizard

1. Run the setup.exe file for DMS that is located on the product CD or in the installation package.
2. Select Maintenance of existing installation.
3. Select the DMS instance that you want to remove.
4. Select Next. Wait for several seconds until the Genesys Installation Wizard window appears on your desktop.
5. Select Remove.
6. Select Next.
7. Select Yes to confirm the operation.
8. Choose when to restart your computer.
9. Select Finish.

Uninstall using the Control Panel

1. Open the Control Panel.
2. Select the DMS installation that you want to remove.
3. Select Uninstall and then Next. Wait for several seconds until the Genesys Installation Wizard window appears on your desktop
4. Select Remove.
5. Select Next.
6. Select Yes to confirm the operation.
7. Choose when to restart your computer.
8. Select Finish.

Linux

Delete the DMS files directly by performing the following command: rm -rf <DMS_FOLDER>