Running the Windows installer

This section covers installation of M-Business Server on any of the supported versions of Windows.

You may wish to review the Release Bulletin for M-Business Anywhere and New Features Bulletin for M-Business Anywhere before installing M-Business Server.

If you are accessing this guide from your Installation CD image, these documents are also available there. For instructions on accessing these documents online, see The M-Business Anywhere documentation set.

To install M-Business Server on Windows
  1. Log in to Windows as a local administrator.

  2. On the Start menu, choose Run.

    The Run dialog appears.

  3. Enter e:/MBAnywhereW.exe in the Run dialog

    Where e is the letter for the correct drive.

    Note

    You can also start the installer from Windows Explorer by double-clicking the e:/MBAnywhereW.exe file.

    The Welcome dialog appears.

  4. Click Next.

    The Server License dialog appears.

  5. Enter a valid license key, then click Next.

    The Server Functionality dialog appears. If you believe that your license key should include functionality not listed here, contact iAnywhere Workforce Sales—see Contacting iAnywhere Solutions.

  6. Click Next to proceed to the License Agreement dialog.

  7. Read the license agreement, then click Yes to accept the licensing terms.

    The Choose Destination Location dialog appears.

  8. Confirm or change the location of the M-Business Server install, then click Next.

    Note

    The directory which you specify for Choose Destination Location sets the path in <M-Business_Home>.Throughout the rest of this guide, <M-Business_Home> is used to refer to the M-Business home directory that is created under the location that you specify here.

    Caution

    If you change the default location, do not specify a path that includes any spaces or non-English characters in any of the directory names.

  9. If you are installing M-Business Server with NT domain or LDAP integration, you will see the Domain List dialog. If not, proceed to step 11.

  10. In the Domain List dialog, enter NT domain or LDAP information, then click Next.

    For NT domain integration, enter the name of the NT domain you wish to integrate. If you want to integrate with multiple NT domains, use a comma to separate the domain names (DOM1, DOM2, DOM3).

    For LDAP integration, enter "LDAP" here.

  11. Enter a User Friendly Server Name, then click Next.

    Note

    This is the server name that users will see in M-Business Connect on the desktop and on the device.

  12. Enter the Host Name or IP address (if you do not have DNS access) of the M-Business Sync Server, then click Next.

  13. Enter the Sync Port for M-Business Sync Server, then click Next.

    Note

    The default port used by M-Business Sync Server is port 80. It is not recommended that you install M-Business Server on a machine currently running a Web server, but if you do, enter another port number, for example, 8092, in this field.

  14. Enter the UI Port for M-Business Admin Server, then click Next.

    Note

    If you change the UI Port setting from the default, you will need to run a script after the installation is complete. Step 20 below provides detailed instructions. Be sure that you do not skip this step.

  15. Enter the Database Port for M-Business Admin Server, then click Next.

  16. Enter the SOAP Server Port for M-Business SOAP Server, then click Next.

  17. Answer any existing database prompts.

    Caution

    If you are upgrading or re-installing M-Business Server, you are prompted to back up and migrate your existing database. If you wish to preserve existing data, click Yes on both of these prompts; specify a location for the backup files using the Browse button.

  18. Wait while the Setup Status dialog indicates progress.

    This portion of the installation process takes a while.

    If you are upgrading or re-installing M-Business Server, you may receive a ReadOnly File Detected message. Check the box for Don't display this message again, then click Yes.

    The InstallShield Wizard Complete dialog displays when the installation is complete.

  19. Click Finish to complete the installation and reboot your machine.

    Caution

    You must reboot your machine before starting M-Business Server. Attempting to start M-Business Server after installation, without rebooting, results in M-Business Server being in an indeterminate state with behavior that is unpredictable.

    Tip

    If you encounter problems during installation, view the M-BusinessAnywhere.log file. This file is located in the <M-Business_Home> directory, which is the M-Business home directory that is created under the location that you specify during installation. For more information, see The M-Business home directory.

    For other troubleshooting tips, refer to the Troubleshooting appendix in the Administrator Guide for M-Business Anywhere Server. See Configuring M-Business Server after installation

  20. If you changed the UI Port setting from the default, after completing the installation process and rebooting your machine, run the agreservedsubs.bat script:

    • At a command prompt, navigate to the <M-Business_Home>/conf directory.

    • Enter agreservedsubs.

  21. If your installation was an upgrade from an earlier version of M-Business Server, complete any manual tasks that are necessary to migrate all your customizations. See the following topics, as applicable:

After installing M-Business Server, ensure database security by changing the default passwords. For detailed instructions on changing database passwords, refer to the Administrator Guide for M-Business Anywhere Server. See Configuring M-Business Server after installation.