Configuring the Intranet

Configuring the Intranet

Once the intranet is up and running, you can begin configuring the intranet for you environment.

The below instructions are for version 13.0+

Note: For 13.0 version, follow details for Railo.  For 13.5, follow details for Lucee

Change Installation Location

Customers often change the install location for 2 reasons:

  1. To remove "intranet" from the intranet's URL
  2. To conserve space on C:\ by moving the intranet to another drive

If you would like to only move the uploaded files (PDFs, DOCs, etc.) you can use our File Migration Utility option which is built into the intranet. Click here to find out how to do this.

By default, the intranet installs under the default site  C:\inetpub\wwwroot. Unlike a simple web site, you must move not only the Intranet folder, but other files and folders as well.

Move the Intranet to a new Drive and new Website

In this configuration, the intranet is moved to a new drive, and runs under a new site (instead of Default Web Site). This is the recommended configuration if you will be running other web applications on the same server.

  1. Copy the same folder structure of ..\Inetpub\wwwroot\ on the target drive.
  2. Copy the following folders from C:\inetpub\wwwroot into the new folder:
    • coldbox folder
    • elasticsearch folder
    • intranet folder
    • WEB-INF (if shown, otherwise this folder will be inside your Intranet folder)
    • web.config file (if shown, otherwise this folder will be inside your Intranet folder)
  3. Stop Railo Server service and IIS at the server level
  4. Select the Site and click 'Basic Settings' on the right nav
  5. Modify the physical path to point to the intranet folder in the new location (Eg. D:\inetpub\wwwroot or D:\inetpub\wwwroot\Intranet)
  6. Start your Railo Server service and IIS server
  7. Log into the Railo web administrator
    http://<Intranet URL>/railo-context/admin/web.cfm (Eg. If you browse to http://mydomain/intranet, the path would be http://mydomain/railo-context/admin/web.cfm
    or 
    Log into the Lucee web administrator
    http://<Intranet URL>/lucee/admin/web.cfm (Eg. If you browse to http://mydomain/intranet, the path would be http://mydomain/railo-context/admin/web.cfm

  8. Login with your password (default is "connections")
  9. In the menu, under Archives and Resources, click Mappings
  10. Edit the mapping which has IntranetConnections.ras under the Archive column.
  11. Modify the Resource and Archive paths to match your new location; if your path is the same as your old drive, except for the drive letter, update only the Resource and Archive paths to the new drive letter
  12. Resource points to you Intranet folder.
  13. Archive points to the IntranetConnections.ras file in the Intranet folder.
  14. Follow the instructions below titled Update the Intranet's URL (Web Location)

For example, if you create a new site, and set the physical path to D:\IntranetConnections\Intranet, your new site should have the following:

  • D:\IntranetConnections\intranet folder <= physical path for new site
  • D:\IntranetConnections\coldbox folder
  • D:\IntranetConnections\elasticsearch folder
  • D:\IntranetConnections\Intranet\WEB-INF folder (Railo will create this folder if it doesn't exist, but it MUST be copied from C:\inetpub\wwwroot)
  • D:\IntranetConnections\Intranet\web.config (only if it existed under C:\inetpub\wwwroot)

 

To Remove "/intranet" from the URL

The instructions for this process are based around Version 13.0. If you are on version 12.0 or 12.5 configured to use Railo, see this article.

The easier way to remove "Intranet" from the URL is to change the Default Web Site to point to physical path to point to C:\inetpub\wwwroot\Intranet:

  1. Using IIS, change the physical path for the default site to point to C:\inetpub\wwwroot\Intranet
    Open IIS Manager, expand the nodes on the left pane, right-click the Default Web Site node, click Manage Web Site > Advanced Settings. Change the 'Physical Path' value to C:\Inetpub\wwwroot\Intranet.
  2. Stop the Railo or Lucee Server service
  3. Copy the C:\inetpub\wwwroot\Intranet\WEB-INF folder, if it exists, and the web.config file from C:\inetpub\wwwroot to C:\inetpub\wwwroot\Intranet (do not use the 'cut and paste' method as some services may have a lock on some of the required files and not all may be moved)
  4. Stop IIS Server and all App Pools > Start the Railo service > Restart IIS Server and App Pools.
  5. Visit the Railo admin site by opening your browser and visiting http:\\[insert_new_domain_name_here]\railo-context/admin/web.cfm 
    or
    or 
    Log into the Lucee web administrator
    http://<Intranet URL>/lucee/admin/web.cfm (Eg. If you browse to http://mydomain/intranet, the path would be http://mydomain/railo-context/admin/web.cfm
    web_admin.png
  6. Configure your Railo or Lucee Mappings under 'Archives & Resources' within Railo or Lucee Web Admin what should look similar to this - note that the Virtual for '/Intranet' is now set to '/' and the '/Intranet' mapping has been removed: mappings.jpg
  7. Visit the intranet using the new URL by typing 'http://[insert_domain_name_here]'.
  8. Navigate to admin > Setup > click 'update locations' to finalize this change.
  9. Follow the instructions below titled Update the Intranet's URL (Web Location) 

Should you hit any issues, please email support@intranetconnections.com with information and/or screenshots related to the issue that you are encountering.

 

Update the Intranet's URL (Web Location)

The intranet using the Web Location setting to determine how to create relative URLs. If you have a custom URL for the intranet, or have moved the intranet to a new site, follow these instructions to update the Web Location.

Update Web Location

  1. Update the binding for the site in IIS to use the new URL if not already done.
    Note: This step is not necessary if you are just removing "/Intranet' for the URL as detailed above.
  2. Log into the intranet using the new URL as an administrator (e.g. kellybristow / password)
  3. Click the Admin link near the top right ( or go directly to this page http://<new URL>/admin/sitesettings/site_settings.cfm?tabidx=1)
  4. It should show the admin screen, with the Setup tab displayed by default.
  5. Scroll to the bottom of the page you you should see a Web Location option under System Information, Intranet Application.
  6. If the new URL is different from the current Web Location, you will see warning text in red, display the new and old URL.
  7. Click the "Update Web Location" button to update the intranet to use the new URL.

Update Scheduled Task

In addition to updating the web location, you must also update the scheduled task in either the Railo, Lucee or ColdFusion administrator.

  1. Login to the Railo Administrator ( http://<server name>railo-context/admin/web.cfm
    OR
    Log into the Lucee web administrator
    http://<Intranet URL>/lucee/admin/web.cfm (Eg. If you browse to http://mydomain/intranet, the path would be http://mydomain/railo-context/admin/web.cfm
    OR
    Login to the CF Administrator ( http://<server name>/cfide/administrator/index.cfm
  2. Default password is usually "connections"
  3. Find the Schedule (or Scheduler) menu item.
  4. Change the URL to match the server's new URL.

Set the Mail Server

The intranet can send emails to alert users based on various events in the intranet. Intranet Connections uses the mail server settings in Railo for sending emails. To configure your mail server:

  1. Open the Railo Web Administrator ( http://<server name>/railo-context/admin/web.cfm )
    OR
    Log into the Lucee web administrator
    http://<Intranet URL>/lucee/admin/web.cfm (Eg. If you browse to http://mydomain/intranet, the path would be http://mydomain/railo-context/admin/web.cfm
  2. The default password is "connections".
  3. In the left menu, choose "Services, Mail"
  4. Enter the details for your mail server and click "update" (note that "verify" will verify the server, but will not save changes)
  5. The default port for most SMTP servers is 25.

Adding Users

You can add users to the intranet either manually, .import from .CSV, or Active Directory synchronization.

Please see article Adding Users to Employee Directory for details.

Set the Intranet Administrator Account

A single administrator account is set as they primary contact for the intranet. Once the primary intranet administrator's account has been either imported from Active Directory or manually, created, you can set it as the primary intranet administrator:

  1. Login to the intranet as an administrator.
  2. Click the Admin link (near the top right).
  3. The Setup tab should be displayed by default.
  4. Scroll down to the bottom, and click [Edit] next to the Administrator name in the System Information, Intranet Application setting.

Add a new Super Admin

By default, the kellybristow account is the super admin for the intranet. Before you disable this account, you will need to assign another user super admin elevated rights. If you will be using Active Directory synchronization and single sign-on, set up the active directory synchronization first to import the target account.

To grant a user super admin rights:

  1. Login to the intranet as a super administrator (ie. kellybriistow).
  2. Click the Admin link (near the top right), and select the Security tab.
  3. Click Assign Elevated Rights
  4. Choose the target user, and grant them super admin rights.

Your mail server must be configured to allow the relaying of messages for it to work with the intranet.

References:

Have more questions? Submit a request

0 Comments

Article is closed for comments.