Recover Your Password

How to Configure the New Server and Add a Web Application

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.

  1. 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

  2. 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.

  3. 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)

  4. 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:
    1. Application Name
      Enter a name for your application eg. myApp.
    2. 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".

    3. 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.

    4. App Files
      This is the file folder where the website files such as scripts will run, typically wwwRoot. Enter to accept the default path.

    5. 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).

    6. 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.

    7. Temp Files
      This is the file path used for files that have a temporary usage. Enter to accept the default path.

    8. Files url
      This is the prefix used within the website programming. Enter to accept the default path.

  5. 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+
    1. Install Web Platform Installer.
    2. Open IIS Manager (should be installed already).
    3. Connect to the Web Server and navigate to your site on the left.
    4. There should be a Web Platform Installer panel present in the middle. Open the application.
    5. Search for "Web Deploy" and install Web Deploy 3.6 without bundled SQL.
    6. Restart IIS Manager and the deploy option should now be available when you right-click your site.
    7. Finally, right-click on the site and select Deploy >> Import. Select the downloaded default website and complete the import.
  6. Open Windows Services and start the Contensive Task Service that was installed with the configuration tool (this may already be running by default).

  7. Go to the admin site http:// + your application name + /admin. The default username/password is root/contensive.

Posted By Jay Kidwell | 4/13/2019 10:55:39 PM

Subscribe By Email