Install Miva Merchant Empresa on Windows NT Server

Note: If you are not a system administrator, you will not be able to perform the installation as described below.

Introduction

This manual is intended for NT system administrators. If you are not a system administrator, you will not be able to perform the installation as described below.

Installing Miva Merchant Empresa enables you to run compiled MivaScript applications (.mvc) on your web site. These installation instructions provide only the basic information to allow you to get Miva Merchant Empresa up and running quickly.

Install Preparation

  1. Place the ntxxx.exe (ISAPI distribution) file into a temporary directory and change to that directory. (xxx refers to the version number.)

  2. Run or double-click on the executable.

  3. Click Next. The License Agreement screen displays.

  4. Read the License Agreement. If you accept the agreement, select the I accept button, and click Next to continue.

    The Customer Information screen displays.

  5. Enter the information, and select whether the installation is for all users or only the current user, then click Next.

    This setting determines where the Program information is stored, and who will have access to it.

  6. Select Complete or Custom, then click Next.

    Complete:     installs to C:\Program Files\Miva\Miva Empresa.
    Custom:     allows you to select the installation folder.

  7. To change any previously entered information, click the Back button, otherwise, click Install. The installation process begins. When complete, click Finish.

Note: The Release Note is installed to Program Files\Miva\Miva Empresa\RELNOTE.txt.

Security Settings

As with all Internet applications, security is very important. We recommend that you set security properties to the highest standards. Since every system is different, the system administrator must implement the best security measures for the specific needs of the server and installed third-party software.

The minimum permission settings for Miva Merchant to function correctly are with the anonymous user, often called IUSR_<machinename>, with change permissions on the Merchant script and data directories.

Note: These permissions are for Miva Merchant. Permissions settings for other directories and applications should be implemented according to the recommendations in the manufacturer's documentation.

 Run Microsoft Management Console

After the installation has been completed, go to the menu bar and select the following:

    1. Programs

    2. Windows NT 4.0 Option Pack

    3. Microsoft Information Server

    4. Internet Service Manager

This will open the Microsoft Management Console (MMC).

Use the following procedure to add the snap-in from the MMC.

    1. Click on the Console menu option from the main menu bar.

    2. Click on Add/Remove Snap-in option.

    3. On the Add/Remove snap-in screen, click on Extensions.

    4. Select the check box next to Miva Merchant VM).

    5. Click OK to all screens until you are back at MMC's main screen again.

    6. On MMC's main screen, check if you have a _vti_bin directory under the web or sub-web on the server, and open it. Perform the following procedure for the _vti_adm and _vti_aut directories.

      1. Right-click on _vti_adm or _vti_aut directory, and click Properties.

      2. Select the Directory Security tab.

      3. Click the edit button for Anonymous access and Authentication control.

      4. Ensure Allow Anonymous Access is not selected.

      5. Click OK.

      6. Repeat substeps a through e for the other directory (_vti_adm or _vti_aut).

    8. On MMC's main screen, right click on the website you wish enable from the list in the left screen and a menu is displayed.

    9. Select Properties and the site's Properties screen displays.

    10. Click the Miva Merchant VM tab. The configurations for the script directory and the data directory must be properly set before most scripts will function properly.

      1. Restrict scripts to the following directory and below. This is the directory where you want scripts to be placed on the web site in order to be run. We recommend that you use the same directory as the one where your HTML files are stored. So if your home directory for the site is C:\inetpub\wwwroot\somesite then use that as the script directory also.

      2. Store data in the following directory. This is the directory that all MivaScript files will, by default, save data. This would be the root data directory for the given web site. We recommend that you create a directory outside of any web accessible directories such as C:\inetpub and create a \mivadataroot\ directory there.

    12. If you want to add Commerce Libraries, see Add Libraries below. Otherwise, click OK and proceed to Set Permissions in Windows Explorer.

Add Libraries

If you are going to be using any Commerce, Database, or Configuration Library functionality such as payment gateways or UPS shipping, then you need to add in the Methods and assign them to the proper .dll file. Libraries that are part of Miva Merchant may be been downloaded from the Miva Merchant FTP site.

  1. In the Miva Merchant VM tab, click the Libraries button. The Libraries window opens.

  2. Click Add, or if you want to change a library item, double-click in the Type column for the associated Library you want to change. The Add/Edit window opens.

  3. Enter or change the library:

    1. Select the Library Type from the drop-down list.

    2. Enter the Method.
       

      Payment commerce libraries are listed below in the form: Method, file (Service).

      AuthorizeNet, mcathnet.dll (Authorize.Net Payment Services)

      CyberCash, mccybcsh.dll (CyberCash Payment Services)

      ICS2, mcics2.dll (CyberSource ICSv2 Payment Services)

      LinkPoint, mclp.dll (Cardservice/LinkPoint)

      PNTransact, obtain file from vendor (Verisign Payflow Pro, PaymentNet)

      Database libraries are listed below in the form: Method, file.

      MVDODBC, ODBC.dll (ODBC database API functions)

      MVDOracle, MVDOracle.dll (Oracle database API functions)

    3. Enter the full path and file name of the .dll, or click Browse to locate and select the library you wish to add.

    4. Click OK.

  1. When all the libraries you want are listed in the Libraries box, click OK.

Note: Not all of the commerce, database, and configuration libraries that Miva Merchant Empresa (VM) supports are available directly from Miva Merchant. Some libraries must be obtained directly from the Miva Merchant Technology partner, developer, or other company.

Set Permissions in Windows Explorer

Now, you will set the permissions for the Miva Merchant data and script directories. These Miva Merchant permissions should not propagate to other folders, such as the Front Page folders.

Set Permissions for Front Page Directories

Make sure you maintain these permissions and that the Anonymous access remains unchecked for the Front Page folders. These settings should not propagate to the Miva Merchant data and script directories

    1. For sub-sites, using Windows Explorer, open the _vti_bin directory within any web or sub-web on the server, (for example, under inetpub\wwwroot\somesite) and perform the following for each directory.

      1. Right-click on the _vti_adm or _vti_aut, and click Properties.

      2. Click the Security tab, and click Permissions.

      3. Remove the anonymous user from the list. (This user is usually named IUSR_<machinename>.

      4. Repeat substeps a, b, and c for the other directory (_vti_adm or _vti_aut).

 Miva Merchant Data Directory

  1. On the Windows NT Explorer screen, right click the mivadata directory.

  2. Select Properties and the Properties window opens.

  3. Select the Security tab.

  4. Click the Permissions button.

    The Directory Permissions screen opens.

  5. Click Add from the Directory Permissions screen. The Add Users and Groups screen displays.

  6. Select the anonymous user, often called IUSR_<machinename>. In the properties for that directory, you need to set the security so that the IUSR has "Change" permissions on the directory.

  7. At the bottom of the screen, select Change.

  8. Click OK.

  9. Click OK on the Directory Permissions screen.

  10. Click Yes when you are prompted whether you wish to change the security information on the Windows NT screen.

  11. Your `Store data in the following directory' path should look similar to this example.

    You should then create a sub-directory for each separate web site to store its data in. For example, if the site's document root is C:\inetpub\wwwroot\somesite then use C:\inetpub\mivadataroot\somesite as its data directory.

MivaScript Directory

You need to set the same permissions for merchant2, under the MivaScript directory, as you just did for the Miva Merchant Data directory.

  1. In Windows Explorer, right click on merchant2 under the script directory (wwwroot, htmlscript, etc.), then select Properties.

    The Properties window opens.

  2. Select the Security tab.

  3. Click the Permissions button and the Directory Permissions screen opens.

  4. Click Add from the Directory Permissions screen. The Add Users and Groups screen displays.

  5. Select the anonymous user, often called IUSR_<machinename>.

  6. At the bottom of the screen, select Change to change the Access Type.

  7. Click OK.

  8. Click OK on the Directory Permissions screen.

  9. Click Yes when you are prompted whether you wish to change the security information on the Windows NT screen.

This completes the installation. Repeat this procedure for each site.