Creating Ingeniux CMS 10.5 Site Instances
Prerequisites:
- Users must have site administrator permissions and access to the appropriate server.
- Ingeniux CMS 10.5 software must be installed. See Installing Ingeniux CMS 10.5 Software Platform for details.
- If the Raven Database (RavenDB) 4.x instance will live on an external server, the RavenDB must be set up.
- If providing a manual certificate, the certificate must be accessible. See RavenDB Certificates for details.
After installing the Ingeniux CMS 10.5 software, site administrators can create CMS site instances. The Ingeniux CMS Site Instance Wizard creates a default site, adds the site to IIS, and installs supporting files.
Each CMS site instance exists as one of two types: 1) a website or 2) a virtual directory underneath a website. The CMS server may host multiple CMS instances. Single CMS instances may host multiple websites and publishing targets.
Note: This task uses version numbers within CMS names for demonstration purposes only. For staging, administrators may choose to use version numbers within CMS names as well. For production, we recommend your CMS name not include version numbers because you may upgrade your CMS instance in the future.
To create a CMS 10.5 site instance:
- Navigate to [Drive]:[path-to-CMS-installation]\Ingeniux CMS 10.5 in your server's file system. Open Installers\Ingeniux_CMS_Site_Wizard.exe. The dialog displays the New Site tab.
- Provide the new CMS instance name.
-
Optional: You can set up the instance with a site export. Complete the following steps:
- Click Browse and select the site export .zip folder in File Explorer.
- Click Open. The path to the export zip file displays in the Site Export Zip field.
- Select the maximum allowable export zip size in the Batch Size drop-down list.
Tip: Use the 1024 default value for servers with 8GB of RAM or less. Use a larger batch size for servers with more than 8GB of RAM to make the content import faster. The installer uses Voron as the engine.
Version Notes: CMS 10.1+ Setting up a new CMS site export automatically disables replication profiles for all publishing targets and retains replication profile settings. This feature prevents an accidental publish of test content to production DSS environments.
- Click Start. The Setup Wizard opens.
- Click Next. The Select Instance Web Application Type dialog displays.
Note: This view provides configuration settings for the CMS URL and not the RavenDB.
-
Choose one of the following options:
-
Select Website to set up the instance as a new IIS website.
- Click Next. The IIS Site Configuration view displays.
- Complete the following fields:
Field Description IP Address Enter the appropriate IP address. The default is an empty value. Port Number Enter the appropriate port number. The default is 80. Host Name Enter the host name. The default is the CMS instance name. Display Name Enter the friendly name that displays in IIS for the CMS instance. The default is the CMS instance name.
Note: We recommend maintaining the CMS instance name. If you have multiple CMS instances, maintaining the name helps you to clarify which application pool associates with each CMS instance.
- Click Next. The IIS Site Configuration view displays.
-
Select Virtual Directory to set up the instance as a virtual directory.
- Click Next. The IIS Virtual Directory Configuration view displays.
- Complete the following fields:
Field Description Site Instance drop-down list Choose the site instance under which to run the virtual site. The default is Default Web Site. Virtual Directory Name Enter the virtual directory name. The CMS instance name displays as the default.
Note: This field only accepts alphanumeric characters.
- Click Next. The IIS Virtual Directory Configuration view displays.
-
- Click Next. The Select RavenDB Location view displays.
- See RavenDB Certificates to configure RavenDB 4.x and its security certificates. Return to this page for steps to complete the wizard.
- Click Next. The Select User Provider Type view displays.
- Choose one of the following options:
Important: This step configures the administrative account credentials that the CMS instance initially requires to log in.
- Select Ingeniux User Provider to use LDAP.
- Click Next. The Administrative User Configuration view displays.
- Complete the following fields:
Field Description Administrator User ID Enter a user ID name. The system creates a user with system administrator permissions. When initially logging in to the CMS instance, enter this ID in the User Name field. Password Enter the password to associate with the administrator user ID. When initially logging in to the CMS instance, enter this password. Confirm Password Re-enter the password to validate the new credentials.
- Click Next. The Administrative User Configuration view displays.
- Select Domain Controller to use Active Directory.
- Click Next. The Administrative User Configuration view displays.
- Complete the following fields:
Field Description Domain Name Enter the domain controller name. Administrator User ID Enter a user ID name. The system creates a user with system administrator permissions. When initially logging in to the CMS instance, enter this ID in the User Name field. SMTP Domain Enter the SMTP domain where users receive workflow notifications from the CMS instance.
- Click Next. The Administrative User Configuration view displays.
- Select Ingeniux User Provider to use LDAP.
- Click Next. The Custom Setup view displays.
- Optional: If you prefer settings other than the defaults, configure which CMS instance features the system installs and where. This serves as the final step in setting up the CMS site instance. To custom configure the setup:
Caution: Standard CMS implementations require all features. For most sites, the default settings are adequate.
- Click the appropriate server icon in the tree area to open the context menu. You can install a feature on the local hard drive or make unnecessary entire features unavailable for install.
Additional Info:
The Ingeniux CMS Site Instance tree includes:Node Description CMS Site Site to install. Preview Site Rendering of the DSS that users can see to preview their work. Extensions Development Package Solution and project for developing custom hooks, apps, and plugins. - Click Browse in the Location field to change the filepath where the CMS feature will install.
- Optional: Click Reset to return feature options to their initial default values.
- Click the appropriate server icon in the tree area to open the context menu. You can install a feature on the local hard drive or make unnecessary entire features unavailable for install.
- Optional: Click Disk Usage to display the Disc Space Requirements dialog. View how much disc space your volumes have and how much disc space the exported CMS requires.
Caution: Highlighted volumes lack disc space to install features.
- Click Next to begin the CMS instance installation.
-
Click Finish to exit the dialog after the installation completes.
Note: You can uninstall a site instance via Add or remove programs in your server's System Settings.
Next Steps:
- Check Ingeniux CMS 10.5 Installation Outcomes to ensure IIS App Setup and RavenDB 4.x Services Setup install as expected.
- Install an Ingeniux CMS 10.5 DSS instance to correlate with the CMS 10.5 instance.