In order to use the Crows Nest Mobile App, you must install and configure the API on the server that runs Crows Nest. Use the links below to download the CNAPI.zip and makecert.exe files.
...
link below to download the latest CNAPI.zip file.
...
Updating the API from a Previous Version
During the initial implementation of Crows Nest, one of our team members installs and configures the API which is necessary for the mobile application to connect to the server hosting the Crows Nest database.
From time-to-time, as new releases of the mobile application become available and additional features are introduced, it is necessary to update the API to allow for continued functionality between the mobile and desktop applications.
Following these steps closely will ensure that your downtime is minimized to minutes.
Step-by-Step API Update
...
Download the latest compressed API file (.zip) from above and note the full name of the .zip file.
Login to the Windows web server that is currently running Internet Information Services (IIS) using an Admin account (or an account with full Sys Admin credentials)
Launch Internet Information Services (IIS).
On the left-hand menu tree, click to select CNAPI.
On the far right-hand side, click on Basic Settings… under ‘Edit Site’.
Make note of the physical path location of your current API configuration.
(Note: It should be something like: C:\inetpub\cnapi)
Open a Windows Explorer window and navigate to the inetpub folder.
Create a NEW folder alongside of the folder named ‘cnapi’, but name it with the date obtained from the .zip file downloaded in step #1 (i.e., CNAPI_2023-03-20).
Extract the contents of the downloaded .zip file into the newly created folder (Note: alternatively, you can open the downloaded .zip, CTRL+A to ‘Select All’, CTRL+C to copy the entire contents, and CTRL+V, to paste the contents into the newly created folder).
Locate the Notepad App, right-click, and ‘Run as administrator’. Answer ‘Yes’ to the security question asking, “Do you want to allow this app to make changes to your device?”
From Notepad, File->Open
In the bottom right-hand corner select 'All Files’ from the dropdown.
Browse to your current API (noted in step #6) and open the Web.config file with Notepad.
In the section identified by a starting tag reading: <connectionStrings>, locate your current Data Source and copy (CTRL+C) the text string as outlined in this example (up to, but not including the semicolon). This will copy the string representing your server’s name and the Crows Nest database to your computer’s clipboard.
Close the Web.config file without saving any unintended changes.
From Notepad, browse to the NEW folder created in step #8.
File->Open the Web.config file.
Select the Data Source string up to, but not including the semicolon (just like in step# 14) and paste the copied string from your clipboard over the top of the placeholder data. This will make the new API’s data source match your current data source.
Save the Web.config file and close it.
Return to IIS and click the ‘Basic Settings…’ link on the far right-hand side (as in step#5).
Click the elipse to the right of the physical path, browse to the location of the newly created folder with the Web.config file that you just modified (i.e., C:\inetpub\CNAPI_2023-03-20), and click OK.
Confirm the ‘Physical path’ displays the new folder you created in step# 8 and Click OK.
IIS will now use this latest version of the API.
END
...
The name that you give the new folder you create is not critical. However, giving it a name that reflects the date that the API was published will allow you to easily identify one version from another over time. In the event there is ever a need to roll-back to the previous version, it will be easy to identify which folder to point IIS to. The naming convention for the API .zip files is: CNAPI_YEAR-MONTH-DAY.
| Note |
|---|
|
