New CMS Installation
Installing the CMS:
1.) Download perc-distribution-tree.jar from the release page on GitHub to the CMS server.
2.) From a command prompt / shell (Administrator/sudo mode may be required depending on your file permissions).
3.) Install. java -jar perc-distribution-tree.jar "Path to Target Percussion Folder" This will extract the CMS installation to your temporary directory and install the software to the folder that you specified.
Windows Example:
- java -jar perc-distribution-tree.jar E:\Percussion
Linux Example:
- java -jar perc-distribution-tree.jar /opt/Percussion
4.) Register the JRE folder. Create a symbolic link named JRE in the Install Directory to the system installed Java 1.8. We recommend that you install Java to a system location without the Java build number in the directory name. C:\Program Files\Java\1.8-jdk for example. With that in place you can upgrade the system Java for security updates, and the link from the CMS will automatically use the new version.
Windows Example:
Run a command prompt as Administrator (this must be a Command Prompt not a PowerShell command window - mklink is part of cmd).
- mklink /D C:\Percussion\JRE "C:\Program Files\Java\1.8-JDK\jre"
- You should receive a message that a symbolic link has been created.
- Test that the link is working: cd C:\Percussion\JRE\bin
- .\java.exe -version
Linux Example:
Most Linux distributions package java using the update-alternatives tool and install links for the different java versions. The example below assumes that an open jdk 1.8 is installed. The exact path will depend on your Linux distribution and package manager.
- cd /opt/Percussion
- sudo ln -s /usr/lib/jvm/java-8-openjdk-amd64/jre JRE
- cd JRE
- ./bin/java -version
5.) Install the CMS as a service.
Windows:
- Run a command prompt as an Administrator.
- Change to the Percussion installation jetty service folder.
- e.g cd C:\Percussion\jetty\service
- install-jetty-service.bat install
- The service should installed and configured to start automatically
- net start PercussionCMS to start the service
- Log information on the service startup will be written to the C:\Percussion\jetty\logs\server.log file, it will take a minute or two for the service to start.
- Change to the Percussion installations jetty service folder.
- e.g. cd /opt/Percussion/jetty/service
- sudo ./install-jetty-service.sh
- Enter the user id that will own the Percussion process, or hit enter to accept the default.
- Once the service is installed, run: sudo service PercussionCMS start
- You can see the startup process by running the following in another terminal window:
- tail -f /opt/Percussion/jetty/base/logs/server.log
For the Delivery Tier Services (DTS):
DTS service is optional and is usually installed on or near the webserver, with the web server acting as a proxy to the DTS. If the DTS services will be installed on the same machine as the CMS, it is typically installed side by side with the CMS in the Percussion installation folder. For example if the CMS is installed to C:\Percussion then use that same path when installing the DTS.
1.) Download delivery-tier-distribution.jar from the release page on GitHub to the CMS server.
2.) From a command prompt (Administrator mode may be required depending on your file permissions).
3.) java -jar delivery-tier-distribution.jar PathToYourDTSInstallation
Windows Example:
java -jar delivery-tier-distribution.jar C:\Percussion
Linux Example:
java -jar delivery-tier-distribution.jar /opt/Percussion
4.) Register the JRE folder. If you are installing the DTS into the same folder as the CMS, this step can be skipped. If the DTS is on another server or in a different directory, follow the steps in the CMS steps above for linking in a JRE folder to the DTS install.
5.) Install the DTS as a service.
Windows Example:
- Change to the Percussion DTS installations Deployment Server folder.
- e.g. cd C:\Percussion\Deployment\Server\service
- DTSProductionService.bat install
- Once the service is installed, run: net start PercussionProductionDTS
Linux Example:
- Change to the Percussion DTS installations Deployment Server folder.
- e.g. cd /opt/Percussion/Deployment/Server
- sudo ./DTSProductionService.sh install
- Once the service is installed, run: sudo service PercussionProductionDTS start
Logging into the CMS for the first time
After installation and successful service start, the CMS will be listening on it's default port of 9992 on the http protocol. http://cmsserver:9992/. The default username is Admin. The password is generated at system startup and is unique to each instance of Percussion CMS. You can find the Admin password by opening the \var\config\generated\password file in a text editor. See Applying an SSL Certificate to Percussion CMS for information on configuring an HTTPS connection to secure the CMS.