CSM 10.4 Documentation

Home

Installing CSM from the Command Line

Use command-line options to silently install CSM Client, server, and web applications. After installation, you can configure CSM servers using the Server Manager or Command-Line Configuration utility.

Each of the following sections contains commands and examples for running the silent installer.

When creating a command, you must use two variables: the directory where CSM will be installed (INSTALLDIR) and all other parameters (PARAMS) in a list. Remember the following rules for commands in CSM:
  • Values that include spaces must be wrapped in double quotation marks. Since PARAMS includes multiple parameters, its values always require quotes. INSTALLDIR requires quotes only if any of the directories in the filepath have spaces in their names (example: INSTALLDIR:"C:\Program Files\CSM").
  • A final backslash is not required for the INSTALLDIR filepath. If the INSTALLDIR filepath ends with a backslash, it must be escaped (example: INSTALLDIR:"C:\Program Files\CSM\\").
  • Parameter values inside of double quotes must be separated by a pipe ( | ) or a semi-colon ( ; ).
  • CSM includes .exe files for CSM Server installation, CSM Web Applications installation, and Cherwell Server Manager installation.
  • CSM Client is installed using an .msi file.
  • Silent installation of an .exe file can be achieved using either /quiet or /silent switch commands. These can be shortened to /q or /s. The examples in the following sections use /q.

CSM Client Installation

The CSM Client installer uses an .msi file, so the command to launch the CSM Client installer requires a different format than all other CSM installers. In addition to INSTALLDIR, the CSM Client installation command uses INSTALLLEVEL.

Use the following command to install CSM Clients:

                            msiexec /i "Cherwell Client.msi" /qn <Install parameters here>
                        

The following example installs the Desktop Client and administrator tools (CSM Administrator, Report Runner, System Upgrade/Restore, and Test LDAP) for all users:

                            msiexec /i "Cherwell Client.msi" /qn INSTALLLEVEL=10
                        
Options Definition Values
                                            INSTALLDIR
                                        
Location/folder in which to install the Client application files. [ProgramFilesFolder]Cherwell Service Management (default)
                                            INSTALLLEVEL
                                        
Install the CSM Desktop Client only or both CSM Desktop and CSM Administrator.
  • 1 = Client component only installed.
  • 10 = Client and Administrator components installed.

CSM Server Installation

During the server installation, the Server Manager and all servers and services are installed. You must select which servers and services to enable by default.

Use the following command to install the Cherwell Server:

                            "Cherwell Server.exe" /q INSTALLDIR="<File path to directory for installation>" PARAMS="<Formatted list of parameters and values>"
                        

The following example command is completely silent, which means it avoids opening a wizard and therefore does not install data or configure services. The command installs the Cherwell Application server, the Automation microservice, the Scheduling microservice, and the E-mail and Event Monitoring microservice. It also sets the local Windows account to launch CSM services and does not install the Cherwell Application server as a web application under IIS:

                            "Cherwell Server.exe" /quiet INSTALLDIR="C:\Program Files\CSM" PARAMS="DATABASETYPE=4|SERVERSERVICE=1|BUSINESSPROCSERVICE=1|SCHEDULINGSERVICE=1|EMAILSERVICE=1|USE_SP_ACCOUNT=1|CWSPECIALACCOUNT=LocalSystem|CWAPPSERVERIIS=0|CFGSRVS=0"
                        
Options Definition Values
                                            INSTALLDIR
                                        
Location/folder in which to install the server installation files. [ProgramFilesFolder]Cherwell Service Management (default)

Database Options

Note: The Connection Wizard is launched when DATABASETYPE is set to 1, 2, or 3. For a silent install, set DATABASETYPE to 4.

                                            DATABASETYPE
                                        
Select the database components to install. Cherwell Demo Database = 1 (default)
Cherwell Starter (empty) Database = 2
Upgrade an existing database = 3
Don't load any data = 4
Service Options
                                            SERVERSERVICE
                                        
Enable the Application Server.
  • 1 = Enable (default)
  • 0 = Disable
                                            BUSINESSPROCSERVICE
                                        
Enable the Automation Process microservice.
  • 1 = Enable (default)
  • 0 = Disable
                                            SCHEDULINGSERVICE
                                        
Enable the Scheduling microservice.
  • 1 = Enable (default)
  • 0 = Disable
                                            EMAILSERVICE
                                        
Enable the E-mail and Event Monitoring microservice.
  • 1 = Enable (default)
  • 0 = Disable
Logon Information
                                            IS_NET_API_LOGON_USERNAME
                                        
Cherwell Server account username that will be used to launch the CSM services. Must be in the form Domain/username.

Blank (default), but information is required.

Format: DOMAIN\Username if the server is joined by a domain. Example: Cherwell\Henri.Bryce

                                            IS_NET_API_LOGON_PASSWORD
                                        
Cherwell Server account password that will be used to launch the CSM services. Blank (default), but information is required.
                                            USE_SP_ACCOUNT
                                        
Use special account (Windows account) to launch the CSM services.
  • 1 = True
  • 0 = False (default)
                                            CWSPECIALACCOUNT
                                        
Name of special account that will be used to launch the CSM services.
  • LocalSystem (default)
  • LocalService
  • NetworkService
                                            CWAPPSERVERIIS
                                        
Install the Application Server as a web application under IIS.
  • 2 = True (default)
  • 0 = False
                                            CFGSRVS
                                        
Allow auto-configuration of services including the Application Server and Service Host.
For a completely silent install, set to 0. The installation process will complete without service configuration, and the services must be configured after installation.
Note: If this option is left out or set to 1, the installation attempts to automatically configure the services and displays the Connection wizard if no suitable connection is found.
  • 1 = True
  • 0 = False

CSM Web Applications

Use the following command to install the CSM Web Applications:

                            "Cherwell Browser Apps.exe" /q INSTALLDIR="<File path to directory for installation>" PARAMS="<Formatted list of parameters and values>"
                        

The following example does not install the Portal, but it installs Auto-Deploy:

                            "Cherwell Browser Apps.exe" /q INSTALLDIR="C:\Program Files\CSM" PARAMS="CWPORTAL=0|CWAUTODEPLOY=1"
                        
Options Definition Values
                                            CWPORTAL
                                        
Install Cherwell Portal.
  • 1 = Install (default)
  • 0 = Do not install
                                            CWBROWSERCLIENT
                                        
Install Cherwell Browser client.
  • 1 = Install (default)
  • 0 = Do not install
                                            CWAUTODEPLOY
                                        
Install Auto-Deploy.
  • 1 = Install (default)
  • 0 = Do not install
                                            CWCFGMGR
                                        
Select whether or not to display the Connection wizard during install.
  • 1 = Display the Connection wizard during install (default)
  • 0 = Do not display the Connection wizard during install
                                            INSTALL_AUTODEPLOY
                                        
Select whether or not to update the Auto-Deploy configuration.
Note: If Auto-Deploy is not installed (CWAUTODEPLOY=0), then this option is ignored.
  • 2 = Do not run Auto-Deploy configuration
    Note: Before Auto-Deploy is ready for use, you must manually configure Auto-Deploy.
  • 1 = Run Auto-Deploy configuration (default)
                                            INSTALLDIR
                                        
Location/folder in which to install the Browser application files. [ProgramFilesFolder]Cherwell Browser Applications (default)

Was this article useful?