Installing M-Business Server on Linux

You may wish to review the Release Bulletin before installing M-Business Server.

Note

If you are upgrading M-Business Server on Linux, you must install the new version in a new location. The installer migrates your M-Business database to the new location, but you must manually migrate configuration file settings, certificate files, and any customizations you have implemented.

To install M-Business Server on Linux
  1. Log on as root.

  2. Copy the MBAnywhereL_7.0.<build>.tar.gz file to a location on your hard drive where you want to install M-Business Server.

    For example, /usr/local.

    Note

    The file you download will have the build number in the position of <build> in the file name above.

    Note

    The directory in which you install M-Business Anywhere sets the path in <M-Business_Home>.

    Caution

    Do not specify a path that includes any spaces or non-English characters in any of the directory names.

  3. Unzip the MBAnywhereL_7.0.<build>.tar.gz file by typing:

    gzip -d MBAnywhereL_7.0.<build>.tar.gz

    Replace <build> with the build number in the actual file name.

  4. To create the MBAnywhereL_7.0.<build> directory, type:

    gtar -xvf MBAnywhereL_7.0.<build>.tar

    Replace <build> with the build number in the actual file name.

    Note

    This is the directory at the end of the path in <M-Business_Home>. By default, this directory is named MBAnywhereL_7.0.<build>, with the build number in the position of <build>.

  5. To change to the <M-Business_Home>/conf directory, type:

    cd <M-Business_Home>/conf
  6. To install and start up M-Business Server services, type:

    ./installMBAnywhereL_7.0.<build>

    Replace <build> with the build number in the actual file name.

  7. Answer the installer prompts.

    If you are upgrading from an earlier version of M-Business Server and wish to migrate your data:

    • Answer Y for "Yes" when prompted, "Do you have an existing M-Business Anywhere database that you want to migrate?"

    • Enter the full path to the <M-Business_Home> directory for the previous installation when prompted.

    If you want to perform a fresh install, either for a first time installation, or for an upgrade from an earlier version of M-Business Server from which you do not wish to migrate your data:

    • Answer N for "No" when prompted, "Do you have an existing M-Business Anywhere database that you want to migrate.

  8. Answer the rest of the installer prompts.

    Note

    Do not enter root when you answer the prompt for either user or group. Besides the security issue, the Apache install fails if either user or group is set to root

  9. To verify that all services are running (admin, asa, soap, sync), type:

    ./agserver status

  10. If you changed the UI Port setting from the default, run the agreservedsubs script:

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

    • Enter agreservedsubs.

  11. 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 Preserving customizations.

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.