Overview

Admin App v2.0.0 supports the ability to administrate multiple instances within a single version of the applications. Admin  

Admin App supports two roles for this, the Super-Administrator who role that can view and register all ODS / API instances and its their functions, and the Administrator who role that is assigned to a particular ODS / API instances and its functions. It is important to note that Admin App will administrate existing instances  

Note that the Admin App administrates pre-existing instances of the ODS / API, . It does not create ODS / API instances. They , which must exist and be deployed prior to using them within Admin App. Shared instance mode is still supported within Admin App.

The ODS / API modes supported by multi-instance management within Admin App are:

1. District-Specific ODS Configuration
2. Year-Specific ODS Configuration

General Configuration

General

When multi-instance mode is enabled, user users can navigate to ODS Instances list by clicking on “ODS Instances” from Home page.

If user is not having   

In the absence of any registered instance, then  the user will be directed to the Register ODS Instance page for registering a new instance.  Otherwise, the user will be presented with available ODS instances.

ODS Instances

District-Specific Mode

  Clicking on the District / EdOrg id link will take the user to ODS an instance-specific ODS settings page.

Year-Specific Mode

Clicking on the school year will take user to year-specific ODS instance settings page.

Registering New ODS Instance

Checklist

     Use this  The following checklist and the details below for ensure a successful ODS instance registration:

•  Database should exist on the server.

          With provided Given a District/EdOrg id or school year, the system will generate a valid instance name (Database name). 

          Ex: District/EdOrg id provided by user = 255901

                EdFi_Ods_Production database name on web.config = EdFi_{0}

                Then generated ODS instance name will be = EdFi_Ods_255901

                User has to make sure, the database (EdFi_Ods_255901) exists on the server.   

•  Generated ODS instance / database name length should be below 50 characters.

District-Specific Mode

For creating a district-specific ODS instance, the user needs to provide a valid ODS Instance District/EdOrg id and descriptionODS Instance Description.

Year-Specific Mode

For creating To create a year-specific ODS instance, the user needs to provide valid school year and descriptiona valid ODS Instance School Year and ODS Instance Description.

Register Many Instances in Bulk:

User A user can register many instances in bulk , by providing uploading a list of District/EdOrg ids district/education organization IDs or school years , descriptions as in the form of csv plus descriptions. The uploaded list must be a CSV file.

Uploaded CSV files must have the header values NumericSuffix and Description in the first row. See the listings below for example content.

NumericSuffix,Description
255901,Sampledistrict1
255902,Sampledistrict2
255903,Sampledistrict3
255904,Sampledistrict4

NumericSuffix,Description
2019,Description1
2020,Description2
2021,Description3