This article will guide you through using the Contensive configuration tool to configure your web server to utilize a web application that you will also create. The required server environment is a Windows server (or laptop) with an IIS Web Server and SQL Server Express installed.
- Create an AWS EC2 server instance with Windows Server 2019+ and IIS Web Server. For details see the following article: How to Create an Amazon Windows 2019 Server for Contensive
- Download and install the Configuration Tool from http://contensive.io/downloads.
NOTE: This installs two features, the command line configuration utility and a windows service for managing background tasks.
- Use the configuration tool to first configure a Server Group:
NOTE: A Server Group holds the settings for resources used by all applications in the group like connection strings for Db servers, the file system, etc. A Server Group also holds multiple servers that execute the aforementioned applications. Numerous servers and applications can be contained in one Server Group.
Run command prompt as administrator. Navigate to c:\Program Files (x86)\kma\contensive5. Run 'cc' with no arguments for a list of available commands. Run 'cc --status' (note the double minus) for the status of the current Server Group. You can redo the following instructions at any time to re-configure the Server Group that we are about to create.
run >cc --configure
>> Enter the Server Group Name: (Name the Server Group anything you want like "staging" or the customer's name)
>> Production Server (y/n)?: (This property can be read by applications in order to enable/disable certain features. Enter 'y' if your web app will be for public use, else 'n' if your web app is for testing purposes)
>> Local File System (y/n)?: (Enter 'y' for this example)
>> Enter the drive letter for data storage: (Self-explanatory, enter 'c' or 'd' for example)
>> SQL Server Endpoint: (Enter "(local)" for this example)
>> native sqlserver userId: (The user login for this server group. This login is the credentials used to log into SQL Server Manager.)
>> native sqlserver password: (The password)
>> Use (l)ocal cache or (m)emcached server?: (Enter 'l' for this example)
- Create an application in the Server Group.
NOTE: An application is the solution you are creating. It could be a website with 100 servers, a database program that processes data periodically, etc.
run >cc -n
You will be prompted for the following:
- Application Name
Enter a name for your application eg. myApp.
- Admin Route
This will be the path you use for the administration site (where you edit data) if your path is online. The default is "admin".
- Primary Domain Name
Enter a domain name that will be used to reach the application (if applicable). You can change this or add many more later.
- App Files
This is the file folder where the website files such as scripts will run, typically wwwRoot. Enter to accept the default path.
- cdn Files
This is the file path where uploaded files will be stored if they will be available online (this is remote AWS S3 bucket in non-local Server Groups).
- Private Files
This is the file path where the application will store files that should not be mapped to the web server. Enter to accept the default path.
- Temp Files
This is the file path used for files that have a temporary usage. Enter to accept the default path.
- Files url
This is the prefix used within the website programming. Enter to accept the default path.
- Download the default sample website zip file from http://contensive.io/downloads and import it into the new IIS site using IIS Web Deploy 3.6+
- Install Web Platform Installer.
- Open IIS Manager (should be installed already).
- Connect to the Web Server and navigate to your site on the left.
- There should be a Web Platform Installer panel present in the middle. Open the application.
- Search for "Web Deploy" and install Web Deploy 3.6 without bundled SQL.
- Restart IIS Manager and the deploy option should now be available when you right-click your site.
- Finally, right-click on the site and select Deploy >> Import. Select the downloaded default website and complete the import.
- Open Windows Services and start the Contensive Task Service that was installed with the configuration tool (this may already be running by default).
- Go to the admin site http:// + your application name + /admin. The default username/password is root/contensive.