Use this appendix to install SonicMQ 7.6 on a mobile device. You must install SonicMQ if you use the Multi-Site module, Customer Connect, Supplier Connect, EuroFinancials, or Mobile Connect so that information can transfer between companies. The installation of SonicMQ is also required for users of financial consolidations.
J.1 Determine Your Security
Sonic Software has the ability to function with username/password security. In an effort to increase the security of the software, customers are able to turn security on if they want.
1. Determine if you want to enable SonicMQ security during installation.
Note! For Sonic Security to be enabled, it must be implemented during installation. If you already have Sonic installed without security, then you must uninstall and reinstall of Sonic.
2. Be aware that the installation instructions differ based on whether you enable
security:
* Use the following “Install SonicMQ with Security Enabled” instructions if you have decided to install SonicMQ with the security functionality.
or
* Skip to the following “Install Sonic MQ without Security” instructions if you have decided NOT to install Sonic MQ with the security functionality.
J.2 Install SonicMQ With Security Enabled
Use the following instructions to install SonicMQ as an advanced installation, which includes enabling the security functionality. (If you do not want to install SonicMQ with security enabled, skip to the next section.)
1. Insert the SonicMQ DVD into the drive.
2. Run the SETUP.EXE file in the root directory of the SonicMQ DVD.
3. Enter the directory where the Progress Client Software is installed. Click Next.
4. Select the SonicMQ software Advanced Install option. Click Next.
5. Click Next.
Files are copied from the SonicMQ install into your Progress directory. The Progress Sonic MQ Adapter accesses these files to communicate with SonicMQ.
6. Begin the installation of SonicMQ. Click Next.
7. Read the registration and license information. Click Next. Read the license
agreement, accept the terms. Click Next.
8. Enter the SonicMQ License Key provided. Click Next.
9. Perform a new installation. Click Next.
10. Enter the directory where you would like SonicMQ to be installed.
11. If the directory doesn’t exist, you will be prompted to create a new directory. Click Yes.
12. Select the Custom installation. Click Next.
13. By default, all features are installed. The first five are mandatory for Mobile Connect. Enter the program group folder you want to use. Click Next. 14. Install the JRE. Click Next.
15. Keep the defaults for the Management Connection information. If you would like to change the defaults, please contact Support before doing so. Click Next. 16. Keep the defaults for the Broker Options information, with the exception of
checking the “Enable Security” checkbox. If you would like to change the other defaults, please contact Support before doing so. Click Next.
17. Review the installation. Click Next.
18. Monitor the progress of the install. Click Finish. 19. Reboot the server.
J.3 Install SonicMQ Without Security Enabled
Use the following instructions to install SonicMQ as a typical installation, which does not include enabling the security functionality. If you want to install SonicMQ with security enabled, use the previous section instead.
1. Insert the SonicMQ DVD into the drive.
2. Click Next.
3. Select the Progress Client Software directory and click Next.
4. Select SonicMQ software, Typical install, and click Next.
5. Click Next.
6. SonicMQ is installed silently on your server. A command window may appear.
Leave the window open until the install is complete.
7. Run the postinstall process. To do this, double-click 76postinstall.exe on the CD-
ROM, or choose Start — Run and enter the command: D:\76postinstall.exe
8. The Welcome window appears. Click Next.
9. The SonicMQ Install Location window appears. Enter the location where
SonicMQ has now been installed. The default is C:\epicor\SonicMQ76. 10. Click Next. (Do not check the box that this is an upgrade.)
11. Click Install. 12. Click Finished. 13. Reboot the server.
J.4 Set Up Sonic Test Environment
If you use a test environment, it is recommended that you make a copy of your live data and put it in a completely isolated environment on a test server. This separation ensures that prototyping and testing is done in a quarantine area without the possibility of inadvertent data being sent to your live environment. The precaution of a separate environment is recommended where Sonic messaging is used since the test data has the same company id and messaging ports as your live system. The separate environment minimizes the risk of human error when moving databases around for testing and training purposes.
To set up a test environment, you will need the following:
* Test Server. A low-cost test server can be a low-end server or a XP Professional workstation with a minimum of 2GB of RAM.
* Sonic Installation. The test server must have its own installation of Sonic. * Progress Database. If the base database is Progress, the entire database and
Epicor application must be on the test server.
* SQL Database. If the base database is SQL, then the Epicor application is on the test server and the database is located on the SQL server where the Epicor databases currently reside. This will save on SQL license cost.
Note! Be sure to place your training database and your live database on separate servers. If you do not and you run test multi-company processes, the shared records populate both the training and the live databases.
J.5 Review Possible Installation Messages
Use the following troubleshooting tips to help resolve issues you may encounter. Adapter.jms error in the AppServer log
Error: Application Service adapter.progress.jms not found at NameServer at Host 127.0.0.1 Port 5162. (8245) Error connecting to the JMS AppServer Service. Problem: The SonicMQ Adapter is not started.
Resolution: The SonicMQ Adapter “sonicMQ1” is created by default for you when you install the AppServer license. If you go to the properties, it needs to contain a unique port number and be set to Auto start (which means it starts when the Admin Service starts), otherwise it must be started manually from the Progress Explorer Tool. If the SonicMQ Adapter is started properly, when you check the Status, status
Javax.jms Exception error in the AppServer log
Error: javax.jms.JMSException: java.net.ConnectException: Connection refused: no further information: TCP://localhost:2506. Error connecting to JMS AppServer service.
Problem: The SonicMQ broker cannot start. The SonicMQ Container is not started. Resolution: Start the SonicMQ Container.
Javax.jms Security error in the AppServer log
Error: javax.jms.JMSSecurityException: Inauthentic Client. Error connecting to the JMS AppServer service
Problem: The SonicMQ “Administrator” Password is not correct, or the Device Username/Password is not correct.
Resolution: Enter a correct username and/or password. General Error Message
Error: Not Accepting Messages at this Priority
Problem: The program UpdateDBIni.exe was not run properly following the installation of SonicMQ.
Resolution: All Sonic and Progress processes must be stopped. Run the fix program and reboot the server.