Audience: ClassLink Administrator
Once you setup OneSync, you can automate syncs to manage your accounts for you. OneSync acts as middleware to reduce the time and effort needed to maintain account information in an orderly and secure manner.
- Windows Server 2016 or later
- Install Google Chrome
- Run all Windows Updates
- Ensure that the following resources are accessible:
- https://oms-mq-prod.classlink.io:5671 or 443
Notes for Windows Server 2012 R2
Windows Server 2012R2 entered "extended support" on 10/9/2018. Because of this, we recommend installing OneSync on Windows Server 2016 or later.
If you are running OneSync on Windows Server 2012 R2, please make sure that you have Update for Windows Server 2012 R2 (KB2999226) installed prior to installing OneSync. This can be installed via windows updates or by following the above link.
The OneSync Installer will create and configure a database server and website for your OneSync account. The listed items are required and included with your installation:
- Microsoft .NET Framework 4.5
- IIS 5.0
1. When beginning the installation process, the installer will prompt you for a database name (onesync), username, password, and IP address used to create it.
If you are registering on your local machine, the username will be root. The installer will also ask you to select a site to deploy your OneSync account too. If you do not have a pre-existing website and choose Default Web Site, the Installer will generate a website for you using IIS on your local machine.
If the database is hosted on the same server as the website, you can enter 127.0.0.1 as the IP address to refer to your local machine. Otherwise, you must enter the IP address and credentials for the server on which your database is located. Click Next to proceed through the installation process.
2. After clicking Install, the installer will download and install MariaDB -> Click Next.
3. The MariaDB installer will prompt you for the username and password that you initially set in the OneSync installer, in order to authorize access to your OneSync database. If registered on your local machine, the username will be root.
4. The installer will then create and configure your database for you -> Click Next.
5. The following window will then pop-up to install IIS 5.0 -> Click Install.
6. This is the final prerequisite program that will be installed. Click Finish in the IIS and OneSync installation windows to complete the overall installation process.
7. After you have run the installer, you may log into your OneSync portal using the default username and password: admin, 12345. If you do not have an SSL certificate, the website can be accessed at http://localhost.
When a new build is pushed to production, Update Available will appear next to an update button on the Settings page. Click this button to update your build. The Current Version number will increment to confirm a successful download.
If you are installing on Windows 2012 and IIS fails to install, ensure that the executable is not blocked by windows.
Updated: Jan 2019