Instance Preparation: To Deploy a Test Instance

The following activity will walk you through the process of preparing and deploying an MYOB Advanced instance that you can use to perform the steps in other chapters of this guide.

Story

Suppose that you need to perform customization tasks for the Smart Fix company, as described in Company Story and Customization Description, and complete the activities described in other chapters of this guide. You need to deploy an instance of MYOB Advanced with the PhoneRepairShop customization project published.

Process Overview

In this activity, you will install tools that will help you to perform customization tasks and then deploy the instance of MYOB Advanced with the dataset from the T220 Data Entry and Setup Forms course.

Step 1: Preparing the Environment

To prepare the environment, do the following:

  1. Make sure the environment that you are going to use conforms to the System Requirements for MYOB Advanced 2022 R2.
  2. Make sure that the Web Server (IIS) features that are listed in Configuring Web Server (IIS) Features are turned on.
  3. Install the Acuminator extension for Visual Studio.
  4. Clone or download the customization project and the source code of the extension library from the Help-and-Training-Examples repository in MYOB GitHub to a folder on your computer.
  5. Install MYOB Advanced. On the Main Software Configuration page of the , select the Install Acumatica ERP and Install Debugger Tools check boxes.
    Tip: If you have already installed MYOB Advanced without debugger tools, you should remove MYOB Advanced and install it again with the Install Debugger Tools check box selected. The reinstallation of MYOB Advanced does not affect existing MYOB Advanced instances. For details, see To Install the MYOB Advanced Tools.

Step 2: Deploying the Instance

To perform customization for the Smart Fix company as described in Company Story and Customization Description, you need deploy an instance of MYOB Advanced with the customization project prepare for the T270 Workflow API training course (in this case, the project that has been developed in the T220 Data Entry and Setup Forms training course).

You deploy an MYOB Advanced instance and configure it as follows:
  1. Open the MYOB Advanced Configuration Wizard, and do the following:
    1. Click Deploy New Application Instance for T-series Developer Courses.
    2. On the Database Configuration page, make sure the name of the database is PhoneRepairShop.
    3. On the Instance Configuration page, do the following:
      1. In the Local Path of the Instance box, select a folder that is outside of the C:\Program Files (x86), C:\Program Files, and C:\Users folders. (We recommend that you store the website folder outside of these folders to avoid an issue with permission to work in these folders when you perform customization of the website.)
      2. In the Training Course box, select the needed training course.

    The system creates a new MYOB Advanced instance, adds a new tenant, loads the data to it, and publishes the customization project that is needed for activities of this guide.

  2. Make sure a Visual Studio solution is available in the App_Data\Projects\PhoneRepairShop folder of the MYOB Advanced instance folder. This is the solution of the extension library that you will modify in the activities of this guide.
  3. Sign in to the new tenant by using the following credentials:
    • Username: admin
    • Password: setup

    Change the password when the system prompts you to do so.

  4. In the top right corner of the MYOB Advanced screen, click the username, and then click My Profile. The User Profile (SM203010) form opens. On the General Info tab, select YOGIFON in the Default Branch box; then click Save on the form toolbar.

    In subsequent sign-ins to this account, you will be signed in to this branch.

  5. Optional: Add the Customization Projects (SM204505) and Generic Inquiry (SM208000) forms to your favorites. For details about how to add a form to your favorites, see Managing Favorites: General Information.